@pasquelin/map3d-plugin-geopf 0.1.1 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +52 -6
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -16,25 +16,71 @@ import { geopfBatiments } from '@pasquelin/map3d-plugin-geopf'
|
|
|
16
16
|
<Map plugins={[geopfBatiments()]} />
|
|
17
17
|
```
|
|
18
18
|
|
|
19
|
+
**Compatibilité** : `@pasquelin/map3d` `>=0.2.0 <0.8.0` (peerDependency — de 0.2 à 0.7),
|
|
20
|
+
`react` / `react-dom` 19, `three` ≥ 0.169.
|
|
21
|
+
|
|
19
22
|
Le plugin est **désactivé par défaut** (`enabledByDefault: false`) : l'utilisateur l'active depuis
|
|
20
23
|
le hub des plugins (menu Réglages). Une fois actif, il s'active sur l'outil « sélectionner un
|
|
21
24
|
bâtiment » (pick de bâtiment 3D) déjà fourni par map3D.
|
|
22
25
|
|
|
26
|
+
Cet outil n'existe que lorsque la carte montre le **volume interne** de map3D : mode `'3d'` et
|
|
27
|
+
`providers.tiles3d.provider: 'internal'` (le défaut), bâtiments extrudés servis par l'origine
|
|
28
|
+
interne. Sur une carte plate ou sur des tuiles 3D photoréalistes — un maillage fusionné, sans
|
|
29
|
+
bâtiment distinct — il n'y a rien à désigner, donc rien à enrichir.
|
|
30
|
+
|
|
23
31
|
Pour lire l'enrichissement dans l'hôte, monter un composant enfant de `<Map>` (le hook exige le
|
|
24
32
|
contexte carte) :
|
|
25
33
|
|
|
26
34
|
```tsx
|
|
35
|
+
import type { CSSProperties } from 'react'
|
|
27
36
|
import { useBuildingEnrichment } from '@pasquelin/map3d'
|
|
28
37
|
|
|
38
|
+
const panel: CSSProperties = {
|
|
39
|
+
position: 'absolute',
|
|
40
|
+
top: 16,
|
|
41
|
+
left: 16,
|
|
42
|
+
right: 16,
|
|
43
|
+
width: 'fit-content',
|
|
44
|
+
margin: '0 auto',
|
|
45
|
+
zIndex: 'var(--m3d-z-floating-hud)',
|
|
46
|
+
padding: '10px 14px',
|
|
47
|
+
border: '1px solid var(--m3d-border)',
|
|
48
|
+
borderRadius: 'var(--m3d-radius-lg)',
|
|
49
|
+
background: 'var(--m3d-panel)',
|
|
50
|
+
fontSize: 'var(--m3d-size-sm)',
|
|
51
|
+
lineHeight: 1.5,
|
|
52
|
+
}
|
|
53
|
+
|
|
29
54
|
function BuildingInfo() {
|
|
30
55
|
const e = useBuildingEnrichment()
|
|
31
|
-
if (e.loading) return <div>Chargement…</div>
|
|
32
|
-
if (e.error) return <div>Indisponible : {e.error.message}</div>
|
|
56
|
+
if (e.loading) return <div style={panel}>Chargement…</div>
|
|
57
|
+
if (e.error) return <div style={panel}>Indisponible : {e.error.message}</div>
|
|
33
58
|
if (!e.data) return null
|
|
34
|
-
|
|
59
|
+
const attrs = Object.entries(e.data)
|
|
60
|
+
if (attrs.length === 0) return <div style={panel}>Aucun attribut IGN pour ce bâtiment</div>
|
|
61
|
+
return (
|
|
62
|
+
<div style={panel}>
|
|
63
|
+
{attrs.map(([k, v]) => (
|
|
64
|
+
<div key={k}>
|
|
65
|
+
<b>{k}</b> : {String(v)}
|
|
66
|
+
</div>
|
|
67
|
+
))}
|
|
68
|
+
</div>
|
|
69
|
+
)
|
|
35
70
|
}
|
|
36
71
|
```
|
|
37
72
|
|
|
73
|
+
L'exemple du dépôt
|
|
74
|
+
([`example/src/App.tsx`](https://github.com/pasquelin/plugingsMap3D/blob/main/packages/geopf/example/src/App.tsx))
|
|
75
|
+
monte ce même composant. Le canvas de la carte est en position absolue : un enfant de `<Map>`
|
|
76
|
+
laissé dans le flux reste dessous, invisible. D'où la position et le niveau « HUD flottant » de la
|
|
77
|
+
carte (`--m3d-z-floating-hud`, qui suit `style.zIndex.floatingHud`) : au-dessus d'elle, sous ses
|
|
78
|
+
barres. Fond, bordure et arrondi viennent du thème de la carte ; la couleur du texte et la police
|
|
79
|
+
en sont héritées. Le panneau est ici centré en haut : placez-le où votre interface laisse de la
|
|
80
|
+
place (avec `<Map search>`, le champ de recherche occupe le coin haut-gauche sur 320 px et passe
|
|
81
|
+
au-dessus). `e.data` vaut `{}` quand le plugin n'a aucun attribut à remonter : le plus souvent,
|
|
82
|
+
aucun bâtiment BDTOPO dans la zone de recherche (`searchRadius`) autour du point cliqué.
|
|
83
|
+
|
|
38
84
|
## Configuration (`geopfConfig`)
|
|
39
85
|
|
|
40
86
|
| Clé | Type | Défaut | Refetch | Description |
|
|
@@ -60,6 +106,6 @@ function BuildingInfo() {
|
|
|
60
106
|
pnpm --filter @pasquelin/map3d-plugin-geopf-example dev
|
|
61
107
|
```
|
|
62
108
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
109
|
+
Aucune clé n'est nécessaire. L'exemple tourne sur les sources par défaut de map3D : le fond de
|
|
110
|
+
carte et les bâtiments extrudés viennent de son origine interne (`providers.internal.origin`). Il
|
|
111
|
+
démarre en 3D (`mapMode="3d"`), là où l'outil de sélection de bâtiment existe.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pasquelin/map3d-plugin-geopf",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "Plugin map3D — enrichit les bâtiments 3D au clic avec les attributs BDTOPO de la Géoplateforme IGN (WFS), via useBuildingEnrichment().",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
"typecheck": "tsc --noEmit"
|
|
38
38
|
},
|
|
39
39
|
"peerDependencies": {
|
|
40
|
-
"@pasquelin/map3d": "
|
|
40
|
+
"@pasquelin/map3d": ">=0.2.0 <0.8.0",
|
|
41
41
|
"react": "^19.0.0",
|
|
42
42
|
"react-dom": "^19.0.0",
|
|
43
43
|
"three": ">=0.169.0"
|