Skip to content
GeoViewer 5

MeasureDistance

MeasureDistance

Nom fonctionnel: Mesure de distance

À quoi sert ce widget ?

Mesure des distances sur la carte avec affichage immédiat du résultat.

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

  • Outil de tracé linéaire avec distance cumulée.
  • Affichage des unités de mesure pendant la saisie.
  • Actions de réinitialisation et reprise de mesure.

Parcours utilisateur (le plus courant)

  • Cliquez pour poser les points de la mesure, puis terminez le tracé.
  • Lisez la distance totale et les segments intermédiaires.
  • Relancez une mesure pour comparer plusieurs hypothèses d’itinéraire.

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)

OptionTypeDéfautDescription
widgetIdstring-Identifiant unique de l’instance MeasureDistance.
activebooleanfalseActive l’ouverture du widget au démarrage.
inToolbarboolean ou objet ou stringselon widgetDéfinit si le widget est visible dans une toolbar, et sous quelle forme.
containerstring ou objetselon widgetChoisit 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

Exemple minimal (copier-coller)

{
    "widgetId": "measure-distance",
    "widgetClass": "MeasureDistance",
    "active": false,
    "inToolbar": true,
    "config": {}
}

Exemple avancé

{
    "widgetId": "measure-distance-advanced",
    "widgetClass": "MeasureDistance",
    "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ômeVé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-distance-01.png: widget ouvert avec configuration standard.
  • (Capture à ajouter) /assets/screenshots/TODO/measure-distance-02.png: interaction principale et résultat attendu.

Liens PDF source

  • US012 - Outil de mesure_d7e1f36a7d9f41e0af01a8a9896567c2-120226-0857-108.pdf

Aller plus loin