Les instances de la classe GMarkerOptions sont utilisées via le paramètre optionnel opts? du constructeur GMarker.
Il n’y a pas de constructeur pour cette classe, elle instanciée comme un objet javascript.
NB : Toutes les propriétés listées ci-dessous sont optionnelles.
Voir aussi la gestion des événements liés aux markers et le contructeur GMarker.
icon dragCrossMove title clickable draggable bouncy bounceGravity autoPan zIndexProcess hide
Exemple d’utilisation : appliquer les paramètres optionnels à un marker.
<script type="text/javascript"> Exemple d'une fonction affichant un marker sur la carte : Ce marker sera déplaçable et aura pour attribut title : Ceci est mon marker function addThisMarker(point){ var marker = new GMarker(point, {draggable : true, title : 'Ceci est mon marker'}); /* Création du marker. Ce marker est déplaçable. (draggable : true) et dispose dun titre qui s'affichera au survol de ce marker */ return marker; } </script>
icon
Depuis la version 2.50 de l’Api Google Map.
Propriété icon : type GIcon.
Permet d’attribuer une icône spécifique au marker. Si cette propriété n’est pas renseignée, l’icône par défaut (G_DEFAULT_ICON) sera utilisée.
dragCrossMove
Depuis la version 2.63 de l’Api.
Propriété dragCrossMove : type booléen.
Lorsque qu’un marker est déplacé normallement, le marker se soulève et s’écarte légèrement de la croix (embase du marker). En passant la paramètre dragCrossMove à true, le marker reste “accroché” à son embase.
Par défaut, cette valeur est à false.
title
Depuis la version 2.50 de l’Api.
Propriété title : type string.
Permet d’attribuer un titre au marker au survol de celui-ci. Cette propriété fonctionne comme l’attribut title d’un élément HTML classique.
clickable
Depuis la version 2.50 de l’Api.
Propriété clickable : type booléen.
Permet de désactiver un marker. Les markers non cliquables et non déplaçables sont inactifs, consomment moins de ressources et ne réagissent pas aux événements. La valeur par défaut est à true, c’est-à-dire que le marker sera actif.
draggable
Depuis la version 2.61 de l’Api.
Propriété draggable : type booléen.
Permet de rendre un marker déplaçable sur la map par l’utilisateur. Les markers déplaçables (draggable) requièrent plus de ressources. À noter qu’un marker déplaçable sera aussi cliquable.
bouncy
Depuis la version 2.61 de l’Api.
Propriété bouncy : type booléen.
Lorsque l’on déplace un marker, celui-ci “rebondit” quand on le relâche. La propriété bouncy passée à false permet d’empêcher ce rebondissement. Par défaut, cette valeur est à true.
bounceGravity
Depuis la version 2.61 de l’Api.
Propriété bounceGravity : type nombre.
Lorsque l’on déplace un marker, celui-ci “rebondit” quand on le relâche. La propriété bounceGravity permet de gérer la “vitesse de rebondissement du marker” . Par défaut sa valeur est à 1. Plus cette valeur est basse, plus le rebondissement du marker une fois relâché sera lent (et inversement).
autoPan
Depuis la version 2.87 de l’Api.
Propriété autoPan : type booléen.
Lorsque l’on déplace un marker aux abords de la carte, celle-ci se recentre et se déplace afin de suivre le marker. En renseignant à false la propriété autoPan, la carte restera fixe lorsque que l’utilisateur souhaitera sortir le marker des limites de la carte.
Par défaut, cette valeur est à true (la carte suit le marker).
zIndexProcess
Depuis la version 2.98 de l’Api.
Propriété zIndexProcess : type Fonction.
Cette fonction est utilisée pour changer l’ordre des z-index des markers lorsque ces derniers sont superposés sur la carte et aussi à l’ouverture des fenêtres d’information associées aux markers.
L’ordre par défaut est le suivant:
Plus les points sont situés au Sud de la map, plus leur z-index est élevé.
Cette fonction est passée dans l’objet GMarker et retourne un nombre indiquant le nouvel indice du z-index.
hide
Depuis la version 2.139 de l’Api.
Propriété hide : type booléen.
Si cette valeur est à true, elle indique que la carte n’affichera pas le marker nativement. Il faudra alors utiliser la proriété show() pour rendre visible le marker.