Les options des markers

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.

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.

Laisser une réponse

Security Code: