GMarker
   API Google Maps version 2
   Référence et Guide du développeur en Français

Attention :

L'API Google Maps Javascript Version 2 a été officiellement déclarée obsolète le 19 mai 2010 par Google.

L'API Version 2 continuera cependant à fonctionner durant encore trois ans, à compter de cette date, conformément à la politique de dépréciation de Google.

Conlusion, si vous devez développer une application aujourd'hui utilisez d'ores et déjà la version 3 de l'API Google Maps Javascript ( cela vous évitera d'avoir à tout recommencer ou à tout repayer dans 3 ans ! ) ou migrez votre application actuelle vers la version 3.

La classe GMarker en Français - Google Maps API Version 2

Un GMarker marque une position sur la carte.

Il implémente l'interface GOverlay et est ainsi ajouté à la carte en utilisant la méthode GMap2.addOverlay().

Un objet marqueur à une latitude / longitude latlng, qui est la position géographique où le marqueur est ancré sur la carte, et un icône icon.

Si l'icône icon n'est pas défini dans le constructeur, l'icône par défaut G_DEFAULT_ICON est utilisé.

Après, qu'il est été ajouté à la carte, l'info-bulle de cette carte peut être ouverte par le marqueur.

L'objet marqueur renverra les événements liés à la souris et à l'info-bulle.

Constructeur

Constructeur

Description

GMarker(latlng:GLatLng, icon?:GIcon, inert?:Boolean)

Créé un marqueur à la latitude/longitude latlng passée à soit GPoint ou GLatLng avec l'icône icon ou l'icône par défaut G_DEFAULT_ICON.

Si le drapeau inert est à true alors le marqueur n'est pas cliquable et ne renverra aucun événement.

Déconseillé depuis 2.50.

GMarker(latlng:GLatLng, opts?:GMarkerOptions)

Crée un marqueur à la latitude/longitude latlng avec les options spécifiées dans GMarkerOptions.

Par défaut, les marqueurs sont cliquables et ont licône par défaut G_DEFAULT_ICON.

Depuis la version 2.50.

Méthodes

Avant d'invoquer ces méthodes, le marqueur doit être ajouté à la carte.

Méthode

Valeur retournée

Description

openInfoWindow(content:Node, opts?:GInfoWindowOptions)

Aucune

Ouvre l'info-bulle sur l'icône du marqueur.

Le contenu de l'info-bulle est donné comme un noeud DOM.

Seule l'option GInfoWindowOptions.maxWidth est applicable.

openInfoWindowHtml(content:String, opts?:GInfoWindowOptions)

Aucune

Ouvre l'l'info-bulle sur l'icône du marqueur.

Le contenu de l'info-bulle est donné comme une chaîne qui contient du texte HTML.

Seule l'option GInfoWindowOptions.maxWidth est applicable.

openInfoWindowTabs(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)

Aucune

Ouvre l'info-bulle à onglets sur l'icône du marqueur.

Le contenu de l'info-bulle est donné comme un tableau d'onglets qui contient le contenu de l'onglet en tant que noeuds DOM.

Seules les options GInfoWindowOptions.maxWidth et InfoWindowOptions.selectedTab sont applicables.

openInfoWindowTabsHtml(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)

Aucune

Ouvre l'info-bulle à onglets sur l'icône du marqueur.

Le contenu de l'info-bulle est donné comme un tableau d'onglets qui contient le contenu de l'onglet en tant que chaînes contenant du texte HTML.

Seules les options InfoWindowOptions.maxWidth et InfoWindowOptions.selectedTab sont applicables.

bindInfoWindow(content:Node, opts?:GInfoWindowOptions)

Aucune

Lie le noeud DOM donné à ce marqueur.

Le contenu de ce noeud sera automatiquement affiché dans l'info-bulle quand le marqueur est cliqué.

Pass content comme null supprimer la liaison.

Depuis la version 2.85.

bindInfoWindowHtml(content:String, opts?:GInfoWindowOptions)

Aucune

Lié le code HTML donné à ce marqueur.

Le contenu HTML sera affiché automatiquement dans l'info-bulle quand le marqueur sera cliqué.

Passer content à null pour supprimer la liaison.

Depuis la version 2.85.

bindInfoWindowTabs(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)

Aucune

Lie GInfoWindowTab (à condition qu'il s'agisse de noeuds DOM) à ce marqueur.

Le contenu à l'intérieur de ces noeuds onglets sera automatiquement affiché dans l'info-bulle quand le marqueur est cliqué.

Passer tabs à null pour supprimer la liaison.

Depuis la version 2.85.

bindInfoWindowTabsHtml(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)

Aucune

Lie GInfoWindowTab (à condition qu'il s'agisse de chaînes HTML) à ce marqueur.

Le HTML contenu dans ces onglets seront automatiquement affichées dans l'info-bulle quand le marqueur est cliqué.

Passer tabs à null pour supprimer la liaison.

Depuis la version 2.85.

closeInfoWindow()

Aucune

Ferme l'info-bulle uniquement si elle appartient à ce marqueur.

Depuis la version 2.85.

showMapBlowup(opts?:GInfoWindowOptions)

Aucune

Ouvre l'info-bulle sur l'icône du marqueur.

Le contenu de l'info-bulle est un agrandissement de la carte autour de la position de marqueur.

Seules les options InfoWindowOptions.zoomLevel et InfoWindowOptions.mapType sont applicables.

getIcon()

GIcon

Retourne l'icône icon de ce marqueur, comme indiqué par le constructeur.

getTitle()

Chaîne

Renvoie le titre de ce marqueur, comme indiqué par le constructeur via la propriété GMarkerOptions.title.

Retourne undefined si aucun titre n'est déclaré.

Depuis la version 2.85.

getPoint()

GLatLng

Retourne les coordonnées géographiques auxquelles ce marqueur est ancré, comme déclarées par le constructeur ou par setPoint().

Déconseillé depuis 2.88.

getLatLng()

GLatLng

Retourne les coordonnées géographiques auxquelles ce marqueur est ancré, comme déclaré dans le constructeur ou par setLatLng().

Depuis la version 2.88.

setPoint(latlng:GLatLng)

Aucune

Définit les coordonnées géographiques du point auquel ce marqueur est ancré.

(Obsolète depuis 2.88.

setLatLng(latlng:GLatLng)

Aucune

Définit les coordonnées géographiques du point où ce marqueur est ancré.

Depuis la version 2.88.

enableDragging()

Aucune

Permet le glisser-déposer du marqueur sur la carte.

Pour fonctionner, le marqueur doit avoir été initialisé avec GMarkerOptions.draggable = true.

disableDragging()

Aucune

Désactive le glisser-déposer du marqueur sur la carte.

draggable()

Booleénne

true ou false

Retourne true si le marqueur a été initialisé par le constructeur en utilisant GMarkerOptions.draggable = true.

Sinon, retourne false

draggingEnabled()

Booleénne

true ou false

Retourne true si le glisser-déposer est activé pour le marqueur courant.

setImage(url:String)

Aucune

Demande à l'image indiquée par l'url d'être définie comme image de premier plan pour ce marqueur.

Noter que ni l'image du marqueur ni l'image de son ombre ne sont ajustées.

Par conséquent, cette méthode est principalement destinée à créer des effets permettant de surligner ou de masquer le marqueur, plutôt que d'effectuer des changements d'apparence radicaux du marqueur .

Depuis la version 2.75.

hide()

Aucune

Cache le marqueur si il est actuellement visible.

Notez que cette fonction déclenche l'événement GMarker.visibilitychanged si le marqueur est actuellement visible.

Depuis la version 2.77.

show()

Aucune

Affiche le marqueur si il est actuellement caché.

Notez que cette fonction déclenche l'événement GMarker.visibilitychanged si le marqueur est actuellement caché.

Depuis la version 2.77.

isHidden()

Booleénne

true ou false

Retourne true si le marqueur est actuellement caché.

Sinon, retourne false.

Depuis la version 2.77.

Haut de page.

Évènements

Tous ces événements se déclenchent uniquement si le marqueur n'est pas inerte (voir constructeur).

Événement

Description

click(latlng:GLatLng)

Cet événement est généré lorsque l'icône du marqueur a été cliqué, en passant les coordonnées du marqueur courant au sein de son argument latlng.

Notez que cet événement sera également généré pour la carte, avec le marqueur passé comme premier argument au gestionnaire d'événements.

dblclick(latlng:GLatLng)

Cet événement est généré lorsque l'icône du marqueur a été double-cliqué, en passant les coordonnées du marqueur courant au sein de son argument latlng.

Notez que cet événement ne se déclenchera pas pour la carte, car les centres de carte sur double-clic comme un comportement câblé.

mousedown(latlng:GLatLng)

Cet événement est généré lorsque l'événement DOM mousedown est tiré sur l'icône du marqueur, en passant les coordonnées du marqueur actuel au sein de son argument latlng.

Remarquez que le marqueur arrêtera l'événement DOM mousedown, de sorte qu'il ne cause pas de la carte pour commencer le glissement.

mouseup(latlng:GLatLng)

Cet événement est généré pour la mouseup DOM sur le marqueur, et en passant les coordonnées actuelles du marqueur au sein de son argument latlng.

Remarquez que le marqueur n'arrêtera pas l'événement DOM mousedown, parce qu'il ne confondra pas le gestionnaire de glisser la carte.

mouseover(latlng:GLatLng)

Cet événement est généré lorsque la souris survole la zone délimitant l'icône du marqueur, en passant les coordonnées actelles du marqueur au sein de son argument latlng

mouseout(latlng:GLatLng)

Cet événement est généré lorsque la souris quitte la zone délimitant l'icône de marqueur, en passant les coordonnées actuelles du marqueur au sein de son argument latlng.

infowindowopen()

Cet événement est généré quand l'info-bulle de la carte a été ouverte par ce marqueur.

infowindowbeforeclose()

Cet événement est généré avant que l'info-bulle de la carte qui a été ouverte par ce marqueur ne soit fermée.

Depuis la version 2.83.

infowindowclose()

Cet événement est généré quand l'info-bulle de la carte qui a été ouverte par ce marqueur est fermée.

Cela se produit soit lorsque l'info-bulle a été fermée, ou lorsqu'elle a été ouverte sur un autre marqueur, ou sur la carte.

L'événement infowindowbeforeclose est généré avant cet événement.

remove()

Cet événement est généré quand le marqueur est retiré de la carte, en utilisant GMap2.removeOverlay() ou GMap2.clearOverlays().

dragstart(latlng:GLatLng)

Si le gliser-déposer est activé pour ce marqueur, cet événement est généré quand le marqueur commence à glisser, en passant les coordonnées actuelles du marqueur au sein de son argument latlng

drag(latlng:GLatLng)

Si le gliser-déposer est activé pour ce marqueur, cet événement est généré quand le marqueur est déplacé, en passant les coordonnées actulles du marqueur au sein de son argument latlng.

dragend(latlng:GLatLng)

Si le gliser-déposer est activé pour ce marqueur, cet événement est généré quand le marqueur cesse d'être déplacé, en passant les coordonnées actuelles du marqueur au sein de son argument latlng.

visibilitychanged(isVisible:Boolean)

Cet événement est généré lorsque la visibilité du marqueur est modifiée (autrement dit lorsque le marqueur passe de l'état visible à l'état caché ou vice-versa).

isVisible se réfère à l'état du marqueur une fois le changement de visibilité opéré.

Depuis la version 2.77

Haut de page.


Ceci est une traduction non officielle de "Google Maps API Reference version 2".

La version originale, en Anglais, se situe ici : Google Maps API Reference version 2 #GMarker.

| | © 2010 | Référence Google Maps API Version 2 en Français |