Marker

Marker

Classe google.maps.Marker

Cette classe étend MVCObject.

Constructeur
Marker	Marker([opts]) Paramètres: opts : MarkerOptions optional arguments facultatifs nommés Crée un repère avec les options spécifiées. Si une carte est spécifiée, le repère y est ajouté lors de la construction. Notez que la position doit être définie pour que le repère s'affiche.

Méthodes
getAnimation	getAnimation() Paramètres:aucun Valeur renvoyée : Animation|null|undefined Obtenez l'animation en cours d'exécution.
getClickable	getClickable() Paramètres : aucun Valeur renvoyée : boolean True si l'élément Marker est cliquable. Obtenez l'état cliquable de Marker.
getCursor	getCursor() Paramètres : aucun Valeur renvoyée : string|null|undefined Affiche le type de curseur de souris affiché au passage de la souris.
getDraggable	getDraggable() Paramètres:aucun Return Value:boolean True si le repère est déplaçable. Obtenez l'état déplaçable de Marker.
getIcon	getIcon() Paramètres:aucun Valeur renvoyée:string|Icon|null|Symbol|undefined Obtenez l'icône de Marker. Consultez les MarkerOptions.icon.
getLabel	getLabel() Paramètres:aucun Valeur renvoyée:MarkerLabel|null|string|undefined Obtenez le libellé de Marker. Consultez les MarkerOptions.label.
getMap	getMap() Paramètres : aucun Valeur renvoyée:Map|StreetViewPanorama Obtenez la carte ou le panaroama sur lequel le Marker est affiché.
getOpacity	getOpacity() Paramètres:aucun Valeur renvoyée : number|null|undefined : nombre compris entre 0,0 et 1,0. Obtenez l'opacité du Marker.
getPosition	getPosition() Paramètres:aucun Valeur renvoyée:LatLng|null|undefined Obtenez la position de Marker.
getShape	getShape() Paramètres : aucun Valeur renvoyée:MarkerShape|null|undefined Obtenez la forme du Marker utilisé pour l'interaction. Voir MarkerOptions.shape et MarkerShape.
getTitle	getTitle() Paramètres:aucun Valeur renvoyée:string|null|undefined Obtenez le titre de l'info-bulle Marker. Consultez les MarkerOptions.title.
getVisible	getVisible() Paramètres:aucun Return Value (Valeur renvoyée) : boolean (vrai) si le repère est visible. Obtenez la visibilité du Marker.
getZIndex	getZIndex() Paramètres:aucun Valeur renvoyée : number|null|undefined zIndex du repère. Obtenez le zIndex de Marker. Consultez les MarkerOptions.zIndex.
setAnimation	setAnimation([animation]) Paramètres : animation : Animation optional animation à lire. Valeur de retour : aucune Démarrer une animation Toute animation en cours sera annulée. Les animations actuellement compatibles sont les suivantes : Animation.BOUNCE et Animation.DROP. Si vous transmettez null, l'animation s'arrête.
setClickable	setClickable(flag) Paramètres: flag : boolean si la valeur est true, il est possible de cliquer sur le repère. Valeur de retour : aucune Définissez ce paramètre si l'élément Marker est cliquable.
setCursor	setCursor([cursor]) Paramètres : cursor : string optional type de curseur de souris. Valeur de retour : aucune Définir le type de curseur de souris affiché au passage de la souris
setDraggable	setDraggable(flag) Paramètres: flag:  boolean optional si la valeur est true, le repère peut être déplacé. Valeur de retour:aucune Définissez ce paramètre si Marker peut être déplacé.
setIcon	setIcon([icon]) Paramètres : icon:  string|Icon|Symbol optional Valeur de retour : aucune Définissez l'icône de Marker. Consultez les MarkerOptions.icon.
setLabel	setLabel([label]) Paramètres: label : string|MarkerLabel optional le libellé peut être une chaîne de caractères ou un objet MarkerLabel. Valeur de retour : aucune Définissez le libellé pour Marker. Consultez les MarkerOptions.label.
setMap	setMap(map) Paramètres : map:  Map|StreetViewPanorama Valeur de retour : aucune Affiche le Marker sur la carte ou le panorama spécifié. Si la carte est définie sur null, le repère est supprimé.
setOpacity	setOpacity([opacity]) Paramètres : opacity : number optional : nombre compris entre 0,0 (transparent) et 1,0 (opaque). Valeur de retour : aucune Définissez l'opacité du Marker.
setOptions	setOptions(options) Paramètres: options:  MarkerOptions Valeur de retour : aucune Définissez les options pour Marker.
setPosition	setPosition([latlng]) Paramètres : latlng : LatLng|LatLngLiteral optional nouvelle position. Valeur de retour : aucune Définissez la position pour Marker.
setShape	setShape([shape]) Paramètres: shape : MarkerShape optional Valeur de retour:aucune Définissez la forme du Marker utilisé pour l'interaction. Voir MarkerOptions.shape et MarkerShape.
setTitle	setTitle([title]) Paramètres: title:  string optional Valeur de retour : aucune Définissez le titre de l'info-bulle Marker. Consultez les MarkerOptions.title.
setVisible	setVisible(visible) Paramètres: visible:  boolean si la valeur est true, le repère est visible Valeur de retour : aucune Définissez ce paramètre si Marker est visible.
setZIndex	setZIndex([zIndex]) Paramètres: zIndex:  number optional Valeur de retour:aucune Définissez le zIndex de Marker. Consultez les MarkerOptions.zIndex.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Constantes
MAX_ZINDEX	Valeur z-index maximale par défaut que l'API attribuera à un repère. Vous pouvez définir un z-index plus élevé pour placer un repère au premier plan.

Événements
animation_changed	function() Arguments : aucun Cet événement est déclenché lorsque la propriété d'animation Marker change.
click	function(event) Arguments : event : MapMouseEvent Cet événement est déclenché lorsque l'utilisateur clique sur l'icône Marker.
clickable_changed	function() Arguments : aucun Cet événement est déclenché lorsque la propriété cliquable Marker change.
contextmenu	function(event) Arguments: event : MapMouseEvent Cet événement est déclenché lorsque l'événement DOM menu contextuel est déclenché sur Marker
cursor_changed	function() Arguments:aucun Cet événement est déclenché lorsque la propriété de curseur Marker est modifiée.
dblclick	function(event) Arguments : event : MapMouseEvent Cet événement est déclenché lorsque l'icône Marker a fait l'objet d'un double clic.
drag	function(event) Arguments: event : MapMouseEvent Cet événement est déclenché à plusieurs reprises pendant que l'utilisateur fait glisser le Marker.
dragend	function(event) Arguments : event:  MapMouseEvent Cet événement est déclenché lorsque l'utilisateur arrête de faire glisser le Marker.
draggable_changed	function() Arguments:aucun Cet événement est déclenché lorsque la propriété déplaçable Marker change.
dragstart	function(event) Arguments: event : MapMouseEvent Cet événement est déclenché lorsque l'utilisateur commence à faire glisser le Marker.
flat_changed	function() Arguments : aucun Cet événement est déclenché lorsque la propriété plate Marker change.
icon_changed	function() Arguments : aucun Cet événement est déclenché lorsque la propriété de l'icône Marker change.
mousedown	function(event) Arguments: event : MapMouseEvent Cet événement est déclenché pour un survol à la souris sur le Marker.
mouseout	function(event) Arguments : event:  MapMouseEvent Cet événement est déclenché lorsque la souris quitte la zone de l'icône Marker.
mouseover	function(event) Arguments : event : MapMouseEvent Cet événement est déclenché lorsque la souris accède à la zone de l'icône Marker.
mouseup	function(event) Arguments: event:  MapMouseEvent Cet événement est déclenché pour une souris sur le Marker.
position_changed	function() Arguments : aucun Cet événement est déclenché lorsque la propriété de position Marker change.
shape_changed	function() Arguments : aucun Cet événement est déclenché lorsque la propriété Marker de la forme change.
title_changed	function() Arguments:aucun Cet événement est déclenché lorsque la propriété de titre Marker est modifiée.
visible_changed	function() Arguments : aucun Cet événement est déclenché lorsque la propriété Marker visible change.
zindex_changed	function() Arguments : aucun Cet événement est déclenché lorsque la propriété zIndex Marker change.
rightclick	Obsolète : utilisez plutôt l'événement Marker.contextmenu afin de prendre en charge les modèles d'utilisation tels que Ctrl + clic sur macOS. function(event) Arguments: event:  MapMouseEvent Cet événement est déclenché pour un clic droit sur le Marker.

MarkerOptions

google.maps.MarkerOptions interface

MarkerOptions permettant de définir les propriétés pouvant être définies sur un repère.

Propriétés
anchorPoint optional	Type : Point optional Décalage entre la position du repère et l'extrémité d'une fenêtre d'informations ouverte avec le repère comme ancre.
animation optional	Type : Animation optional Par défaut : null Animation à lire lorsque le repère est ajouté à une carte
clickable optional	Type:boolean optional Par défaut : true Si la valeur est true, le repère reçoit les événements de souris et de toucher.
">collisionBehavior optional	Avertissement:Disponible uniquement dans la version v=beta. Type:string|CollisionBehavior optional Par défaut : null Définissez un comportement de collision pour les repères sur les cartes vectorielles.
crossOnDrag optional	Type:boolean optional Par défaut:true Si la valeur est false, désactive la croix qui apparaît sous le repère lorsque l'utilisateur le fait glisser.
cursor optional	Type : string optional Par défaut:pointer Type de curseur de la souris à afficher lors du survol.
draggable optional	Type : boolean optional Par défaut : false Si la valeur est true, le repère peut être déplacé.
icon optional	Type:string|Icon|Symbol optional Icône pour le premier plan. Si une chaîne est fournie, elle est traitée comme s'il s'agissait d'un Icon avec la chaîne comme url.
label optional	Type : string|MarkerLabel optional Par défaut : null Ajoute un libellé au repère. Un libellé de repère est une lettre ou un nombre affiché à l'intérieur d'un repère. L'étiquette peut être une chaîne ou un objet MarkerLabel. Si aucune valeur n'est indiquée, MarkerOptions.title n'est pas renseigné. Un texte d'accessibilité (par exemple, pour les lecteurs d'écran, par exemple) est ajouté au repère avec le texte du libellé fourni. Veuillez noter que label n'est actuellement utilisé que pour le texte d'accessibilité des repères non optimisés.
map optional	Type : Map|StreetViewPanorama optional Carte sur laquelle afficher le repère. La carte est requise pour afficher le repère et peut être fournie avec Marker.setMap si elle n'est pas fournie lors de la construction du repère.
opacity optional	Type : number optional Par défaut:1.0 Nombre compris entre 0,0 (transparent) et 1 (opaque)
optimized optional	Type:boolean optional L'optimisation améliore les performances en affichant de nombreux repères sous la forme d'un seul élément statique. Cette fonctionnalité est utile lorsqu'un grand nombre de repères est requis. En savoir plus sur l'optimisation des repères
position optional	Type:LatLng|LatLngLiteral optional Définit la position du repère. Un repère peut être construit, mais ne s'affiche pas tant que sa position n'est pas fournie (par exemple, en fonction des actions ou des choix de l'utilisateur). Une position de repère peut être fournie avec Marker.setPosition si elle n'est pas fournie lors de la construction du repère.
shape optional	Type:MarkerShape optional Définition de la région de l'image cliquable utilisée pour glisser-déposer.
title optional	Type:string optional Par défaut : undefined Texte de roulement. Si ce champ est fourni, un texte d'accessibilité (par exemple, pour les lecteurs d'écran) est ajouté au repère avec la valeur fournie. Veuillez noter que title n'est actuellement utilisé que pour le texte d'accessibilité des repères non optimisés.
visible optional	Type:boolean optional Par défaut:true Si la valeur est true, le repère est visible.
zIndex optional	Type : number optional Tous les repères sont affichés sur la carte par ordre de zIndex. Les valeurs les plus élevées s'affichent devant celles dont la valeur est inférieure. Par défaut, les repères s'affichent en fonction de leur position verticale à l'écran. Les repères plus bas apparaissent devant les repères plus haut sur l'écran.

Constantes CollisionBehavior

constantes google.maps.CollisionBehavior

Avertissement : Disponible uniquement dans la version v=beta.

Constantes
OPTIONAL_AND_HIDES_LOWER_PRIORITY	N'affichez le repère que s'il ne chevauche pas d'autres repères. Si deux repères de ce type se chevauchent, celui présentant le zIndex le plus élevé est affiché. S'ils ont le même zIndex, celui dont la position d'écran verticale est la plus basse est affiché.
REQUIRED	Toujours afficher le repère, quelle que soit la collision. Il s'agit du comportement par défaut.
REQUIRED_AND_HIDES_OPTIONAL	Affichez toujours le repère quelle que soit la collision et masquez les repères ou les libellés OPTIONAL_AND_HIDES_LOWER_PRIORITY qui se superposent au repère.

Icône

google.maps.Icon interface

Structure représentant une image d'icône de repère.

Propriétés
url	Type : string URL de l'image ou de la feuille de sprites.
anchor optional	Type:Point optional Position à laquelle ancrer une image en correspondance avec l'emplacement du repère sur la carte. Par défaut, l'ancre est située le long du point central du bas de l'image.
labelOrigin optional	Type : Point optional Origine du libellé par rapport à l'angle supérieur gauche de l'image de l'icône, si un libellé est fourni par le repère. Par défaut, l'origine est située au centre de l'image.
origin optional	Type:Point optional Position de l'image dans un sprite, le cas échéant. Par défaut, l'origine est située dans l'angle supérieur gauche de l'image (0, 0).
scaledSize optional	Type : Size optional Taille de l'image entière après la mise à l'échelle, le cas échéant. Utilisez cette propriété pour agrandir ou réduire une image ou un sprite.
size optional	Type:Size optional Taille d'affichage du sprite ou de l'image. Lorsque vous utilisez des sprites, vous devez spécifier leur taille. Si la taille n'est pas indiquée, elle sera définie lors du chargement de l'image.

Interface MarkerLabel

google.maps.MarkerLabel interface

Ces options permettent d'indiquer l'apparence d'un libellé de repère. Un libellé de repère est une chaîne (souvent un seul caractère) qui apparaît à l'intérieur du repère. Si vous l'utilisez avec un repère personnalisé, vous pouvez le repositionner à l'aide de la propriété labelOrigin de la classe Icon.

Propriétés
text	Type:string Texte à afficher dans le libellé.
className optional	Type : string optional Par défaut:'' (chaîne vide) Propriété className de l'élément de l'étiquette (équivalente à l'attribut class de l'élément). Vous pouvez ajouter plusieurs classes CSS séparées par des espaces. La couleur, la taille, l'épaisseur et la famille de la police ne peuvent être définies que via les autres propriétés de MarkerLabel. Les classes CSS ne doivent pas être utilisées pour modifier la position ou l'orientation du libellé (par exemple, en utilisant des traductions et des rotations) si vous utilisez également la gestion des conflits de repères.
color optional	Type : string optional Par défaut:'black' Couleur du texte du libellé.
fontFamily optional	Type : string optional Famille de polices du texte du libellé (équivalente à la propriété CSS famille de polices).
fontSize optional	Type:string optional Par défaut : '14px' Taille de police du texte du libellé (équivalente à la propriété de taille de police CSS).
fontWeight optional	Type:string optional Épaisseur de police du texte du libellé (équivalente à la propriété CSS "weight-weight").

Interface MarkerShape

google.maps.MarkerShape interface

Cet objet définit la zone cliquable d'une image de repère. La forme se compose de deux propriétés (type et coord) qui définissent la zone non transparente d'une image.

Propriétés
coords	Type:Array<number> Le format de cet attribut dépend de la valeur type et est conforme à la spécification w3 AREA coords disponible à l'adresse http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. L'attribut coords est un tableau d'entiers qui spécifie la position en pixels de la forme par rapport à l'angle supérieur gauche de l'image cible. Les coordonnées dépendent de la valeur de type comme suit : - circle coords : [x1,y1,r],où x1, y2 correspond aux coordonnées du centre du cercle et r est le rayon du cercle. - poly : coordonnées est [x1,y1,x2,y2...xn,yn], où chaque paire x,y contient les coordonnées d'un sommet du polygone. - rect: les coordonnées sont [x1,y1,x2,y2], où x1,y1 correspond aux coordonnées de l'angle supérieur gauche du rectangle et x2,y2 aux coordonnées des angles inférieurs.
type	Type:string Décrit le type de la forme. Il peut s'agir de circle, poly ou rect.

Symbol

google.maps.Symbol interface

Décrit un symbole, qui se compose d'un tracé vectoriel avec des styles. Vous pouvez utiliser un symbole comme icône d'un repère ou le placer sur une polyligne.

Propriétés
path	Type:SymbolPath|string Le chemin du symbole (chemin d'accès aux symboles intégré) ou un chemin personnalisé exprimé à l'aide du format SVG. Obligatoire.
anchor optional	Type:Point optional Par défaut : google.maps.Point(0,0) Position du symbole par rapport au repère ou à la polyligne. Les coordonnées du tracé du symbole sont traduites vers la gauche et le haut par les coordonnées x et y de l'ancre, respectivement. La position est exprimée dans le même système de coordonnées que le tracé du symbole.
fillColor optional	Type : string optional Couleur de remplissage du symbole. Toutes les couleurs CSS3 sont prises en charge, à l'exception des noms de couleurs étendus. Pour les repères de symboles, la valeur par défaut est "noir". Pour les symboles sur des polylignes, la couleur par défaut est celle du trait de la polyligne correspondante.
fillOpacity optional	Type:number optional Par défaut : 0 Opacité du remplissage du symbole.
labelOrigin optional	Type:Point optional Par défaut : google.maps.Point(0,0) Origine du libellé par rapport au tracé du tracé, si le libellé est fourni par le repère. L'origine est exprimée dans le même système de coordonnées que le tracé du symbole. Cette propriété n'est pas utilisée pour les symboles sur les polylignes.
rotation optional	Type:number optional Par défaut:0 Angle de rotation du symbole, exprimé en degrés dans le sens horaire. Dans un IconSequence, un symbole où fixedRotation est false est orienté par rapport à l'angle du bord sur lequel il se trouve.
scale optional	Type:number optional Proportion selon laquelle le symbole est mis à l'échelle. Pour les repères de symboles, la valeur par défaut est 1. Après la mise à l'échelle, le symbole peut avoir n'importe quelle taille. Pour les symboles sur une polyligne, la valeur par défaut correspond à l'épaisseur du trait de la polyligne. Une fois mise à l'échelle, le symbole doit se trouver dans un carré de 22 pixels centré à l'ancre du symbole.
strokeColor optional	Type:string optional Couleur du trait du symbole. Toutes les couleurs CSS3 sont prises en charge, à l'exception des noms de couleurs étendus. Pour les repères de symboles, la valeur par défaut est "noir". Pour les symboles sur une polyligne, la couleur par défaut du trait est appliquée à la polyligne.
strokeOpacity optional	Type : number optional Opacité du trait du symbole. Pour les repères de symboles, la valeur par défaut est 1. Pour les symboles sur une polyligne, l'opacité du trait de la polyligne est définie par défaut.
strokeWeight optional	Type : number optional Par défaut:Symbol.scale du symbole. Épaisseur du trait du symbole.

Constantes SymbolPath

constantes google.maps.SymbolPath

Chemins de symboles intégrés.

Constantes
BACKWARD_CLOSED_ARROW	Flèche fermée pointant vers l'arrière.
BACKWARD_OPEN_ARROW	Flèche ouverte pointant vers l'arrière.
CIRCLE	Cercle.
FORWARD_CLOSED_ARROW	Flèche fermée pointant vers l'avant.
FORWARD_OPEN_ARROW	Flèche ouverte vers le haut.

Constantes d'animation

constantes google.maps.Animation

Animations pouvant être lues sur un repère. Utilisez la méthode Marker.setAnimation sur le repère ou l'option MarkerOptions.animation pour lancer une animation.

Constantes
BOUNCE	Le repère rebondit jusqu'à ce que l'animation soit arrêtée en appelant Marker.setAnimation avec null.
DROP	Le repère est déplacé du haut de la carte jusqu'à son emplacement final. L'animation s'arrête une fois que le repère est au repos et Marker.getAnimation renvoie null. Ce type d'animation est généralement spécifié lors de la création du repère.