mapManager
Carte, couches runtime, popup, extent, basemaps.
Interagir avec le viewer en JS
À qui s’adresse ce parcours
Cette partie s’adresse aux intégrateurs qui veulent utiliser Geoviewer comme une brique applicative:
- injecter des données dans la carte
- récupérer ce que l’utilisateur fait dans la carte
- synchroniser le viewer avec un formulaire, une liste ou un workflow métier
- trouver rapidement quel objet JS utiliser sans devoir lire toute l’API technique
Le point d’entrée recommandé reste le Web Component. L’API technique reste la source de vérité sur les signatures exactes.
Carte mentale
widgetManager
Activer ou récupérer les widgets déjà présents dans le viewer.
- ouvrir / fermer un widget
- récupérer une référence
- accéder au registre
topic / topicManager
Événements métier publiés par le viewer et ses widgets.
- observer côté DOM
- publier un événement applicatif
- brancher analytics / orchestration
Si je veux…
| Si je veux… | Je commence par… | Puis je vais vers… |
|---|---|---|
| savoir quel objet récupérer une fois le viewer prêt | Objets publics et cycle de vie | ViewerService |
| écouter ce que fait la carte ou un widget | Patterns d’interaction | Events API |
| ajouter des points, lignes ou polygones | Pattern application -> carte | Recette JSON externe |
| dessiner et synchroniser en GeoJSON | Pattern carte -> application | Recette dessin -> GeoJSON |
| générer une image de la carte pour un usage métier | Pattern workflow carto métier | Recette polygone -> image |
| piloter la carte depuis des filtres externes et garder une liste synchronisée | Pattern synchronisation bidirectionnelle | Recette filtres + liste |
Parcours recommandé
Objets publics et cycle de vie Comprendre quand `viewerService`, `mapManager`, `tools`, `services`, `widgetManager` et `topic` deviennent utiles.
Patterns d'interaction Choisir le bon pattern avant d'écrire du code: application -> carte, carte -> application, synchro, workflow métier.
Events API Référence stable pour les événements DOM et `topic` publiés par le viewer.
API technique Index de fond pour les classes et types publics quand vous avez besoin du contrat exact.
Important
- Commencez par le besoin fonctionnel, pas par l’objet technique.
- Gardez une source de vérité claire côté application quand il faut synchroniser carte + UI métier.
- Utilisez la doc API générée pour confirmer les signatures, pas comme seul parcours de découverte.