Gestion des événements liés aux markers

Afin d’interagir avec les markers de la Google Map, l’Api propose différentes méthodes pouvant déclencher des fonctions suite aux événements enregistrés sur la map (notamment en fonctions des actions de l’utilisateur).

Ci-dessous, vous pouvez consulter une liste des différents événements pris en compte sur la Google Map concernant les markers.

NB: Tous ces événements se déclenchent si le marker concerné n’a pas été rendu inactif lors de sa construction / déclaration.

NB: lire aussi les options des markers.

Pour l’utilisation de ces écouteurs d’événements, il est courant d’utiliser la méthode GEvent.addListener de la manière suivante:

<script type="text/javascript">

   Exemple d'une fonction créant un marker sur la carte :

   function addThisMarker(point){
     var marker = new GMarker(point, {draggable : true});
     // Création du marker. À noter que celui est déplaçable. (draggable : true)
     GEvent.addListener(marker, "EVENEMENT", function() {
       // Action à réaliser suite à l'événement détecté sur le marker
       ...
     });
     return marker;
   }         

</script>

click()

La signature de la méthode click :
click(latlng:GLatLng) .

L’événement associé se déclenche dès que l’utilisateur clique sur le marker concerné.
NB: L’événement click peut également être appliqué sur la carte elle-même.

dblclick()

La signature de la méthode dblclick :
dblclick(latlng:GLatLng) .

L’événement associé se déclenche dès que l’utilisateur double-clique sur le marker concerné.
NB: L’événement dblclick ne peut pas être appliqué sur la carte elle-même, car cette action a un effet spécifique. Elle effectue un zoom sur la carte en la centrant sur l’endroit qui a été double-cliqué.

mousedown()

La signature de la méthode mousedown :
mousedown(latlng:GLatLng) .

L’événement associé se déclenche lorsque le bouton gauche de la souris est enfoncé (= début de click).
NB: L’action mousedown sur un marker bloque les autres événements liés à cette action (mousedown) sur la carte. La carte ne sera donc plus draggable tant que le bouton gauche de la souris n’aura pas été relâché.

mouseup()

La signature de la méthode mouseup :
mouseup(latlng:GLatLng) .

L’événement associé se déclenche lorsque le bouton gauche de la souris est relâché (= fin de click).

mouseover()

La signature de la méthode mouseover :
mouseover(latlng:GLatLng) .

L’événement associé se déclenche lorsque la souris survole le marker.

mouseout()

La signature de la méthode mouseout :
mouseout(latlng:GLatLng) .

L’événement associé se déclenche lorsque la souris quitte le marker.

infowindowopen()

La signature de la méthode infowindowopen :
infowindowopen() .

L’événement associé se déclenche lorsque la fenêtre associée à ce marker s’ouvre.

infowindowbeforeclose()

La signature de la méthode infowindowbeforeclose :
infowindowbeforeclose() .

L’événement associé se déclenche juste avant que la fenêtre associée à ce marker ne se ferme.

infowindowclose()

La signature de la méthode infowindowclose :
infowindowclose() .

L’événement associé se déclenche lorsque la fenêtre associée à ce marker se ferme. Elle se déclenche également lorsque la fenêtre associée à un autre marker s’ouvre car une seule fenêtre d’information ne peut être ouverte à la fois.
NB: à noter que l’action infowindowbeforeclose se déclenche juste avant celle-ci.

remove()

La signature de la méthode remove :
remove() .

L’événement associé se déclenche lorsque le marker est retiré de la carte au moyen de GMap2.removeOverlay() ou GMap2.clearOverlays().

dragstart()

La signature de la méthode dragstart :
dragstart(latlng:GLatLng) .

Si le marker concerné est déplaçable (draggable: true), l’événement associé se déclenche lorsque le déplacement de ce marker commence.

drag()

La signature de la méthode drag :
drag(latlng:GLatLng) .

Si le marker concerné est déplaçable (draggable: true), l’événement associé se déclenche pendant le déplacement de ce marker.

dragend()

La signature de la méthode dragend :
dragend(latlng:GLatLng) .

Si le marker concerné est déplaçable (draggable: true), l’événement associé se déclenche lorsque le déplacement de ce marker s’arrête.

visibilitychanged()

La signature de la méthode visibilitychanged :
visibilitychanged(isVisible:Boolean).

L’événement associé se déclenche lorsque la visibilité de ce marker change (s’il était invisible et que son statut passe à visible ou inversement).