MeasureSurface
MeasureSurface
Nom fonctionnel: Mesure de surface
À quoi sert ce widget ?
Mesure des surfaces pour qualifier des emprises et comparer des zones.
Conseil: un viewer “trop outillé” devient vite bruyant. Activez ce widget uniquement s’il sert un parcours utilisateur clair.
Quand l’activer
- Quand l’utilisateur doit mesurer, identifier ou qualifier des objets.
- Quand un diagnostic rapide est attendu sans outil SIG desktop.
- Quand les résultats doivent être visibles immédiatement.
En clair
- Côté utilisateur: Vous augmentez fortement l’autonomie métier dans l’application.
- Côté intégration: Vérifiez la qualité des géométries et la disponibilité des couches interrogées.
Prise en main
Accéder au widget
- Ouvrez le widget d’analyse depuis la toolbar.
- Vérifiez que les couches cibles sont visibles et interrogables.
Le configurer sans se tromper
- Choisissez le mode d’analyse (identifier, mesurer, dessiner, table attributaire, etc.).
- Paramétrez les options utiles avant action sur la carte.
Ce que l’utilisateur voit
- Tracé polygonal avec calcul automatique de surface.
- Affichage des unités selon le contexte (m², ha, km²).
- Actions de correction des sommets et réinitialisation.
Parcours utilisateur (le plus courant)
- Dessinez le contour de la zone d’intérêt.
- Validez la surface calculée puis comparez plusieurs emprises.
- Utilisez ce résultat dans un rapport ou un partage d’analyse.
Exemples concrets
- Mesurer une distance ou une surface pour préparer une intervention.
- Identifier un objet pour lire ses attributs sans ouvrir un SIG desktop.
- Croiser table et carte pour isoler les entités à traiter.
Configuration (aperçu)
| Option | Type | Défaut | Description |
|---|---|---|---|
widgetId | string | - | Identifiant unique de l’instance MeasureSurface. |
active | boolean | false | Active l’ouverture du widget au démarrage. |
inToolbar | boolean ou objet ou string | selon widget | Définit si le widget est visible dans une toolbar, et sous quelle forme. |
container | string ou objet | selon widget | Choisit le conteneur de rendu (drawer, dialog, floating, toolbar-tabs, hidden). |
Pour le détail complet (et toujours à jour), utilisez la référence technique et le schéma ci-dessous.
Liens techniques et code
- Référence technique du widget: Référence technique du widget
- Schéma principal:
schemas/measureSurfaceConfigSchema - API technique du widget:
types/MeasureSurfaceConfig - Code source (déclaration):
packages/common/src/lib/widgets/measure/surface/measure-surface.declaration.ts - Code source (config):
packages/common/src/lib/widgets/measure/surface/measure-surface.config.ts
Exemple minimal (copier-coller)
{ "widgetId": "measure-surface", "widgetClass": "MeasureSurface", "active": false, "inToolbar": true, "config": {}}Exemple avancé
{ "widgetId": "measure-surface-advanced", "widgetClass": "MeasureSurface", "active": true, "handleOpenAtStartup": false, "inToolbar": { "type": "button", "toolbarId": "default-toolbar", "order": 10 }, "onActivate": { "deactivate": { "classes": [] } }, "config": {}}Points d’attention
- Le résultat dépend des couches visibles au moment de l’action.
- Des services lents dégradent la réactivité du widget.
- Les unités et la projection influencent les valeurs affichées.
Dépannage
| Symptôme | Vérification rapide |
|---|---|
| Le widget semble actif mais ne renvoie rien. | Vérifiez la visibilité des couches cibles et les droits d’accès. |
| Les mesures paraissent incohérentes. | Vérifiez projection, unité, précision et source altimétrique. |
FAQ
Peut-on garder plusieurs outils d’analyse ouverts ?
Possible, mais mieux vaut piloter les conflits avec onActivate.deactivate.classes.
Les résultats sont-ils exportables ?
Selon le widget: export natif, partage ou reprise dans un autre flux.
Captures à ajouter
- (Capture à ajouter)
/assets/screenshots/TODO/measure-surface-01.png: widget ouvert avec configuration standard. - (Capture à ajouter)
/assets/screenshots/TODO/measure-surface-02.png: interaction principale et résultat attendu.
Liens PDF source
US012 - Outil de mesure_d7e1f36a7d9f41e0af01a8a9896567c2-120226-0857-108.pdf