Advanced Markers (beta)

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Classe AdvancedMarkerView

Classe google.maps.marker.AdvancedMarkerView

Crée un AdvancedMarkerView avec les options spécifiées. Si une carte est spécifiée, AdvancedMarkerView y est ajouté lors de la construction. Notez que la position doit être définie pour que AdvancedMarkerView s'affiche.

Cette classe implémente AdvancedMarkerViewOptions.

Chargez à l'aide du paramètre d'URL &libraries=marker. Consultez Bibliothèques dans l'API Maps JavaScript.

Lorsque vous utilisez v=beta, vous pouvez y accéder en appelant const {AdvancedMarkerView} = await google.map.importLibrary("marker"). Consultez Bibliothèques dans l'API Maps JavaScript.

AdvancedMarkerView
AdvancedMarkerView([options])
Paramètres:
collisionBehavior
Type:CollisionBehavior optional
content
Type:Element optional
draggable
Type : boolean optional
element optional
Type:HTMLElement|SVGElement optional
Ce champ est en lecture seule. Élément DOM supportant la vue.
map
Type:Map optional
position
title
Type:string optional
zIndex
Type : number optional
addListener
addListener(eventName, handler)
Paramètres:
  • eventName : string
  • handlerFunction
Valeur renvoyée : MapsEventListener
Ajoute la fonction d'écouteur donnée au nom de l'événement donné.
click
function(event)
Arguments :
Cet événement est déclenché lorsque l'utilisateur clique sur l'élément AdvancedMarkerView.
drag
function(event)
Arguments :
Cet événement est déclenché à plusieurs reprises pendant que l'utilisateur fait glisser le AdvancedMarkerView.
dragend
function(event)
Arguments :
Cet événement est déclenché lorsque l'utilisateur arrête de faire glisser le AdvancedMarkerView.
dragstart
function(event)
Arguments :
Cet événement est déclenché lorsque l'utilisateur commence à faire glisser le AdvancedMarkerView.

Interface AdvancedMarkerViewOptions

google.maps.marker.AdvancedMarkerViewOptions interface

Options pour créer un AdvancedMarkerView.

Chargez à l'aide du paramètre d'URL &libraries=marker. Consultez Bibliothèques dans l'API Maps JavaScript.

collisionBehavior optional
Type:CollisionBehavior optional
Énumération spécifiant le comportement d'une AdvancedMarkerView lorsqu'elle entre en conflit avec une autre AdvancedMarkerView ou avec les étiquettes de la carte de base sur une carte vectorielle.

Remarque: La collision AdvancedMarkerView vers AdvancedMarkerView ne fonctionne que sur les cartes matricielles et vectorielles. Toutefois, la collision de AdvancedMarkerView vers la carte de base ne fonctionne que sur les cartes vectorielles.

content optional
Type : Element optional
Par défaut:PinView.element
Élément DOM supportant le visuel d'un AdvancedMarkerView.

Remarque: AdvancedMarkerView ne clone pas l'élément DOM transmis. Une fois l'élément DOM transmis à un AdvancedMarkerView, le transfert du même élément DOM à un autre AdvancedMarkerView déplace l'élément DOM et fait apparaître l'AdvancedMarkerView précédent vide.

draggable optional
Type : boolean optional
Par défaut:false
Si elle est définie sur true, AdvancedMarkerView peut être déplacé.

Remarque: Il n'est pas possible de faire glisser les éléments AdvancedMarkerView avec l'altitude.

element optional
Type:HTMLElement|SVGElement optional
Ce champ est en lecture seule. Élément DOM supportant la vue.
map optional
Type:Map optional
Carte sur laquelle afficher le AdvancedMarkerView. La carte est requise pour afficher AdvancedMarkerView et peut être définie en définissant AdvancedMarkerView.map si elle n'est pas fournie lors de la construction.
position optional
Définit la position de AdvancedMarkerView. Une AdvancedMarkerView peut être construite sans position, mais ne s'affichera pas tant qu'elle n'aura pas été fournie (par exemple, en fonction des actions ou des choix de l'utilisateur). La position d'une AdvancedMarkerView peut être définie en définissant AdvancedMarkerView.position si elle n'est pas fournie lors de la construction.

Remarque: AdvancedMarkerView avec l'altitude n'est compatible qu'avec les cartes vectorielles.

title optional
Type:string optional
Texte de roulement. Si ce champ est fourni, un texte d'accessibilité (à utiliser avec des lecteurs d'écran, par exemple) sera ajouté à AdvancedMarkerView avec la valeur fournie.
zIndex optional
Type : number optional
Tous les AdvancedMarkerView s'affichent sur la carte par ordre de zIndex. Les valeurs les plus élevées s'affichent devant celles de AdvancedMarkerView. Par défaut, les AdvancedMarkerView s'affichent en fonction de leur position verticale sur l'écran, les AdvancedMarkerView plus faibles devant le AdvancedMarkerView plus loin sur l'écran. Notez que zIndex permet également de déterminer la priorité relative entre les repères avancés CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY. Une valeur zIndex plus élevée indique une priorité plus élevée.

PinView

Classe google.maps.marker.PinView

Un PinView représente un élément DOM composé d'une forme et d'un glyphe. La forme a le même style d'infobulle que dans le AdvancedMarkerView par défaut. Le glyphe est un élément DOM facultatif affiché dans la forme d'infobulle. Un PinView peut présenter des proportions différentes en fonction de son PinView.scale.

Cette classe implémente PinViewOptions.

Chargez à l'aide du paramètre d'URL &libraries=marker. Consultez Bibliothèques dans l'API Maps JavaScript.

Lorsque vous utilisez v=beta, vous pouvez y accéder en appelant const {PinView} = await google.map.importLibrary("marker"). Consultez Bibliothèques dans l'API Maps JavaScript.

PinView
PinView([options])
Paramètres:
background
Type : string optional
borderColor
Type:string optional
element optional
Type : HTMLElement|SVGElement optional
Ce champ est en lecture seule. Élément DOM supportant la vue.
glyph
Type:string|Element|URL optional
Consultez les PinViewOptions.glyph.
glyphColor
Type : string optional
scale
Type : number optional
Consultez les PinViewOptions.scale.
addListener
addListener(eventName, handler)
Paramètres:
  • eventNamestring
  • handler : Function
Valeur renvoyée : MapsEventListener
Ajoute la fonction d'écouteur donnée au nom de l'événement donné.

Interface PinViewOptions

google.maps.marker.PinViewOptions interface

Options de création d'un PinView.

Chargez à l'aide du paramètre d'URL &libraries=marker. Consultez Bibliothèques dans l'API Maps JavaScript.

background optional
Type:string optional
Couleur d'arrière-plan de la punaise. Compatible avec n'importe quelle valeur de couleur CSS.
borderColor optional
Type : string optional
Couleur de bordure de la forme de l'épingle. Compatible avec n'importe quelle valeur de couleur CSS.
element optional
Type:HTMLElement|SVGElement optional
Ce champ est en lecture seule. Élément DOM supportant la vue.
glyph optional
Type : string|Element|URL optional
Élément DOM affiché dans l'épingle.
glyphColor optional
Type:string optional
Couleur du glyphe. Compatible avec n'importe quelle valeur de couleur CSS.
scale optional
Type : number optional
Par défaut : 1
Échelle du repère.