Skip to content
GeoViewer 5

AdvancedAddressSearch

AdvancedAddressSearch

Nom fonctionnel: Recherche d’adresse avancée

À quoi sert ce widget ?

Guide la recherche d’adresse étape par étape pour obtenir un positionnement précis et fiable.

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 trouver une information spatiale en peu d’étapes.
  • Quand plusieurs sources de recherche doivent être regroupées dans un seul point d’entrée.
  • Quand les critères métier doivent guider la recherche.

En clair

  • Côté utilisateur: La recherche devient plus fiable et plus rapide pour les équipes opérationnelles.
  • Côté intégration: Contrôlez les services de recherche actifs et les performances des appels multi-sources.

Prise en main

Accéder au widget

  • Activez le widget depuis la barre d’outils ou le champ de recherche principal.
  • Assurez-vous que les services de recherche sont disponibles.

Le configurer sans se tromper

  • Saisissez un critère métier (adresse, parcelle, route, objet, etc.).
  • Affinez la recherche si plusieurs groupes de résultats apparaissent.

Ce que l’utilisateur voit

  • Champ Commune/Code postal avec autocomplétion.
  • Champ Rue activé après sélection de la commune.
  • Champ Numéro activé après sélection de la rue.
  • Boutons “J’y vais” et “Réinitialiser”.

Parcours utilisateur (le plus courant)

  • Renseignez au minimum la commune ou le code postal.
  • Affinez avec rue et numéro pour une localisation précise.
  • Validez avec “J’y vais” ou la touche Entrée.
  • La carte se recentre automatiquement et l’objet est mis en évidence.

Exemples concrets

  • Retrouver rapidement une adresse terrain et recentrer la carte.
  • Localiser une parcelle à partir de sa capakey.
  • Trouver une couche du catalogue depuis une recherche transversale.

Configuration (aperçu)

OptionTypeDéfautDescription
widgetIdstring-Identifiant unique de l’instance AdvancedAddressSearch.
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": "advanced-address-search",
    "widgetClass": "AdvancedAddressSearch",
    "active": false,
    "inToolbar": true,
    "config": {}
}

Exemple avancé

{
    "widgetId": "advanced-address-search-advanced",
    "widgetClass": "AdvancedAddressSearch",
    "active": true,
    "handleOpenAtStartup": false,
    "inToolbar": {
        "type": "button",
        "toolbarId": "default-toolbar",
        "order": 10
    },
    "onActivate": {
        "deactivate": {
            "classes": []
        }
    },
    "config": {}
}

Points d’attention

  • Des critères trop courts produisent souvent des résultats bruités.
  • Sans source configurée, certains groupes restent vides par conception.
  • Le format de coordonnées doit être cohérent avec la projection attendue.

Dépannage

SymptômeVérification rapide
Aucun résultat ne remonte.Vérifiez les sources actives et la connectivité des services.
Le clic sur un résultat ne centre pas la carte.Contrôlez la géométrie retournée et la projection.

FAQ

Peut-on personnaliser les sources interrogées ?

Oui, via la configuration du widget et du contexte.

L’historique est-il conservé ?

Oui pour les flux qui activent explicitement cet historique.

Captures à ajouter

  • (Capture à ajouter) /assets/screenshots/TODO/advanced-address-search-01.png: widget ouvert avec configuration standard.
  • (Capture à ajouter) /assets/screenshots/TODO/advanced-address-search-02.png: interaction principale et résultat attendu.

Liens PDF source

  • US002 - Widget de recherche d'ad_40bdfcacdb934bf7b4db52a256225152-120226-0856-78.pdf

Aller plus loin