Partager via

Gestion des événements de mappage

  • Article

Cet article explique comment utiliser la classe d’événements cartographiques. La propriété met en surbrillance les événements sur la carte et sur les différentes couches de la carte. Vous pouvez également mettre en surbrillance des événements lorsque vous interagissez avec un marqueur HTML.

Interagir avec la carte

L’exemple Événements de carte met en évidence le nom des événements qui se déclenchent lorsque vous interagissez avec la carte. Pour obtenir le code source de cet exemple, consultez Code source d’évènements de carte.

Capture d’écran d’une carte avec une liste d’événements de carte qui sont mis en évidence chaque fois que vos actions sur la carte déclenchent cet événement.

Interagir avec les couches de la carte

L’exemple Événements de couche met en évidence le nom des événements qui se déclenchent lorsque vous interagissez avec la couche de symbole. Les couches de symboles, de bulles, de lignes et de polygones prennent toutes en charge le même ensemble d’événements. La carte thermique et les couches de mosaïques ne prennent en charge aucun de ces événements. Pour obtenir le code source de cet exemple, consultez Code source d’évènements de couche.

Capture d’écran d’une carte avec une liste d’événements de couche mis en évidence chaque fois que vous interagissez avec la couche de symbole.

Interagir avec un marqueur HTML

L’exemple d’événements de couche de marqueur HTML met en évidence le nom des événements qui se déclenchent lorsque vous interagissez avec la couche de marqueur HTML. Pour obtenir le code source de cet exemple, consultez Code source de couche de marqueur HTML d’événements.

Capture d’écran d’une carte avec une liste d’événements de couche de marqueur HTML qui sont mis en évidence chaque fois que vos actions sur la carte déclenchent cet événement.

Le tableau suivant répertorie tous les événements de classe map pris en charge.

Événement Description
boxzoomend Déclenché lorsqu’une interaction « zoom zone » se termine.
boxzoomstart Déclenché lorsqu’une interaction « zoom zone » commence.
click Déclenché lorsqu’un dispositif de pointage est enfoncé et relâché au même point sur la carte.
close Déclenché lorsque la fenêtre contextuelle est fermée manuellement ou par programme.
contextmenu Déclenché suite à un clic sur le bouton droit de la souris.
data Déclenché quand des données de mappage sont chargées ou modifiées.
dataadded Déclenché lorsque des formes sont ajoutées à la DataSource.
dataremoved Déclenché lorsque des formes sont supprimées de la DataSource.
datasourceupdated Déclenché lorsque l’objet DataSource est mis à jour.
dblclick Déclenché suite au double clic avec un dispositif de pointage au même point sur la carte.
drag Déclenché à plusieurs reprises pendant une interaction « glisser pour obtenir une vue panoramique » sur la carte, la fenêtre contextuelle ou le marqueur HTML.
dragend Déclenché quand une interaction « glisser pour obtenir une vue panoramique » se termine sur la carte, la fenêtre contextuelle ou le marqueur HTML.
dragstart Déclenché quand une interaction « glisser pour obtenir une vue panoramique » commence sur la carte, la fenêtre contextuelle ou le marqueur HTML.
error Déclenché quand une erreur se produit.
idle

Déclenché après le rendu de la dernière image avant que la carte n’entre dans un état « inactif » :

  • Aucune transition de caméra n’est en cours.
  • Toutes les vignettes actuellement demandées ont été chargées.
  • Toutes les animations de fondu/transition sont terminées.
keydown Déclenché lorsqu’une touche est enfoncée.
keypress Déclenché lorsqu’une touche qui produit un caractère saisissable (touche ANSI) est enfoncée.
keyup Déclenché lorsqu’une touche est relâchée.
layeradded Déclenché lorsqu’une couche est ajoutée à la carte.
layerremoved Déclenché lorsqu’une couche est supprimée de la carte.
load Déclenché immédiatement après que toutes les ressources nécessaires ont été téléchargées et que le premier rendu visuellement complet du mappage s’est produit.
mousedown Déclenché lorsqu’un dispositif de pointage est appuyé sur la carte ou lorsqu’il se trouve au-dessus d’un élément.
mouseenter Déclenché lorsqu’un dispositif de pointage est déplacé initialement sur la carte ou un élément.
mouseleave Déclenché lorsqu’un dispositif de pointage est déplacé en dehors de la carte ou d’un élément.
mousemove Déclenché lorsqu’un dispositif de pointage est déplacé dans la carte ou un élément.
mouseout Déclenché lorsqu’un dispositif de pointage quitte le canevas de la carte ou quitte un élément.
mouseover Déclenché lorsqu’un dispositif de pointage est déplacé au-dessus de la carte ou d’un élément.
mouseup Déclenché lorsqu’un dispositif de pointage est libéré sur la carte ou lorsqu’il se trouve au-dessus d’un élément.
move Déclenché à plusieurs reprises pendant une transition animée d’une vue à l’autre, en raison de l’interaction de l’utilisateur ou de méthodes.
moveend Déclenché dès que la carte termine une transition animée d’une vue à l’autre, en raison de l’interaction de l’utilisateur ou de méthodes.
movestart Déclenché avant que la carte ne commence une transition animée d’une vue à l’autre, en raison de l’interaction de l’utilisateur ou de méthodes.
open Déclenché lorsque la fenêtre contextuelle est ouverte manuellement ou par programme.
pitch Déclenché à chaque modification de l’inclinaison de la carte, en raison de l’interaction de l’utilisateur ou de méthodes.
pitchend Déclenché dès que la modification de l’inclinaison de la carte est terminée, en raison de l’interaction de l’utilisateur ou de méthodes.
pitchstart Déclenché dès que la modification de l’inclinaison de la carte commence, en raison de l’interaction de l’utilisateur ou de méthodes.
ready Déclenché lorsque les ressources de carte minimales requises sont chargées avant que la carte soit prête pour une interaction programmatique.
render

Déclenché à chaque fois que la carte est dessinée à l’écran, résultant de :

  • Modification de la position, du zoom, de l’inclinaison ou du repère de la carte.
  • Modification du style de la carte.
  • Une modification apportée à une source DataSource.
  • Chargement d’une vignette vectorielle, d’un fichier GeoJSON, d’un glyphe ou d’un sprite.
resize Déclenché immédiatement après le redimensionnement de la carte.
rotate Déclenché à plusieurs reprises pendant une interaction « faire glisser pour faire pivoter ».
rotateend Déclenché lorsqu’une interaction « faire glisser pour faire pivoter » se termine.
rotatestart Déclenché lorsqu’une interaction « faire glisser pour faire pivoter » commence.
shapechanged Déclenché lors de la modification d’une propriété d’objet de forme.
sourcedata Déclenché lorsque l’une des sources de la carte est chargée ou modifiée, y compris si une vignette appartenant à une source est chargée ou modifiée.
sourceadded Déclenché lorsqu’une DataSource ou VectorTileSource est ajoutée à la carte.
sourceremoved Déclenché lorsqu’une DataSource ou VectorTileSource est supprimée de la carte.
styledata Déclenché lorsque le style de la carte est chargé ou modifié.
styleimagemissing Déclenché lorsqu’une couche essaie de charger une image à partir du sprite d’image qui n’existe pas
tokenacquired Déclenché lorsqu’un jeton d’accès Microsoft Entra est obtenu.
touchcancel Déclenché lorsqu’un événement touchcancel se produit dans la carte.
touchend Déclenché lorsqu’un événement touchend se produit dans la carte.
touchmove Déclenché lorsqu’un événement touchmove se produit dans la carte.
touchstart Déclenché lorsqu’un événement touchstart se produit dans la carte.
wheel Déclenché lorsqu’un événement de roulette de souris se produit dans la carte.
zoom Déclenché à plusieurs reprises pendant une transition animée d’un niveau de zoom à l’autre, en raison de l’interaction de l’utilisateur ou de méthodes.
zoomend Déclenché dès que la carte termine une transition animée d’un niveau de zoom à l’autre, en raison de l’interaction de l’utilisateur ou de méthodes.
zoomstart Déclenché avant que la carte ne commence une transition animée d’un niveau de zoom à l’autre, en raison de l’interaction de l’utilisateur ou de méthodes.

Étapes suivantes

Pour voir des exemples de codes complets, consultez les articles suivants :

Utiliser le module de service Azure Maps

Exemples de code