Advanced Markers

Classe AdvancedMarkerElement

Classe google.maps.marker.AdvancedMarkerElement

Affiche une position sur une carte. Notez que position doit être défini pour que AdvancedMarkerElement s'affiche.

Remarque:L'utilisation en tant que composant Web (par exemple, l'élément HTML <gmp-advanced-marker> personnalisé n'est disponible que dans le canal v=beta).

Élément personnalisé:
<gmp-advanced-marker position="lat,lng" title="string"></gmp-advanced-marker>

Cette classe étend HTMLElement.

Cette classe implémente AdvancedMarkerElementOptions.

Pour y accéder, appelez const {AdvancedMarkerElement} = await google.maps.importLibrary("marker"). Consultez Bibliothèques dans l'API Maps JavaScript.
AdvancedMarkerElement
AdvancedMarkerElement([options])
Paramètres: 
Crée un AdvancedMarkerElement avec les options spécifiées. Si une carte est spécifiée, le AdvancedMarkerElement y est ajouté lors de la construction.
collisionBehavior
Type:CollisionBehavior optional
Consultez les AdvancedMarkerElementOptions.collisionBehavior.
content
Type:Node optional
Consultez les AdvancedMarkerElementOptions.content.
element
Ce champ est en lecture seule. Élément DOM supportant la vue.
gmpDraggable
Type:boolean optional
Consultez les AdvancedMarkerElementOptions.gmpDraggable.
map
Type:Map optional
Consultez les AdvancedMarkerElementOptions.map.
position
Consultez les AdvancedMarkerElementOptions.position.
Attribut HTML:
  • <gmp-advanced-marker position="lat,lng"></gmp-advanced-marker>
  • <gmp-advanced-marker position="lat,lng,altitude"></gmp-advanced-marker>
title
Type:string
Consultez les AdvancedMarkerElementOptions.title.
Attribut HTML:
  • <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex
Type:number optional
Consultez les AdvancedMarkerElementOptions.zIndex.
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres: 
  • type:  string Chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener:  EventListener|EventListenerObject objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet utilisant la méthode handleEvent
  • options:  boolean|AddEventListenerOptions optional Voir les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée:  void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié est envoyé à la cible. Découvrez addEventListener.
addListener
addListener(eventName, handler)
Paramètres: 
  • eventName:  string événement observé.
  • handler:  fonction Function permettant de gérer les événements
Valeur renvoyée:MapsEventListener Écouteur d'événements résultant.
Ajoute la fonction d'écouteur au nom de l'événement indiqué dans le système Maps Eventing.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres: 
  • type:  string Chaîne spécifiant le type d'événement pour lequel supprimer un écouteur d'événements.
  • listener:  EventListener|EventListenerObject Écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options:  boolean|EventListenerOptions optional Voir les options
Valeur renvoyée:  void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.
click
function(event)
Arguments: 
Cet événement est déclenché lorsqu'un utilisateur clique sur l'élément AdvancedMarkerElement.

Non disponible avec addEventListener() (utilisez gmp-click à la place).
drag
function(event)
Arguments: 
Cet événement est déclenché plusieurs fois lorsque l'utilisateur fait glisser AdvancedMarkerElement.

Non disponible avec addEventListener().
dragend
function(event)
Arguments: 
Cet événement est déclenché lorsque l'utilisateur cesse de faire glisser le AdvancedMarkerElement.

Non disponible avec addEventListener().
dragstart
function(event)
Arguments: 
Cet événement est déclenché lorsque l'utilisateur commence à faire glisser AdvancedMarkerElement.

Non disponible avec addEventListener().
Betagmp-click
function(event)
Arguments: 
Cet événement est déclenché lorsqu'un utilisateur clique sur l'élément AdvancedMarkerElement. Il est préférable d'utiliser addEventListener() (au lieu de addListener()).

AdvancedMarkerElementOptions.

Interface google.maps.marker.AdvancedMarkerElementOptions

Options pour la construction d'un AdvancedMarkerElement.
collisionBehavior optional
Type:CollisionBehavior optional
Énumération spécifiant le comportement d'un AdvancedMarkerElement en cas de collision avec un autre AdvancedMarkerElement ou avec les libellés de la carte de base sur une carte vectorielle.

Remarque: La collision entre AdvancedMarkerElement et AdvancedMarkerElement fonctionne à la fois sur les cartes matricielles et vectorielles. Cependant, la collision entre AdvancedMarkerElement et les libellés de la carte de base ne fonctionne que sur les cartes vectorielles.
content optional
Type:Node optional
Par défaut:PinElement.element
Élément DOM supportant le visuel d'un AdvancedMarkerElement.

Remarque: AdvancedMarkerElement ne clone pas l'élément DOM transmis. Une fois que l'élément DOM a été transmis à un AdvancedMarkerElement, transmettre le même élément DOM à un autre AdvancedMarkerElement déplace l'élément DOM et donne à l'AdvancedMarkerElement précédent l'air vide.
gmpDraggable optional
Type:boolean optional
Par défaut:false
Si la valeur est true, vous pouvez faire glisser AdvancedMarkerElement.

Remarque: L'élément AdvancedMarkerElement avec l'altitude n'est pas déplaçable.
map optional
Type:Map optional
Carte sur laquelle afficher le AdvancedMarkerElement. La carte est requise pour afficher les AdvancedMarkerElement et peut être fournie en définissant AdvancedMarkerElement.map si elle n'est pas fournie au moment de la construction.
position optional
Définit la position de AdvancedMarkerElement. Une AdvancedMarkerElement peut être construite sans position, mais ne sera pas affichée tant que sa position n'aura pas été fournie (par exemple, par les actions ou les choix de l'utilisateur). La position d'une AdvancedMarkerElement peut être indiquée en définissant AdvancedMarkerElement.position si elle n'est pas fournie lors de la construction.

Remarque: AdvancedMarkerElement avec l'altitude n'est compatible qu'avec les cartes vectorielles.
title optional
Type:string optional
Texte de roulement. S'il est fourni, un texte d'accessibilité (à utiliser avec les lecteurs d'écran, par exemple) sera ajouté à AdvancedMarkerElement avec la valeur indiquée.
zIndex optional
Type:number optional
Tous les AdvancedMarkerElement sont affichés sur la carte par ordre de zIndex. Les valeurs plus élevées s'affichent devant les AdvancedMarkerElement dont les valeurs sont les plus faibles. Par défaut, les AdvancedMarkerElement s'affichent en fonction de leur position verticale à l'écran, les AdvancedMarkerElement inférieurs s'affichant devant les AdvancedMarkerElement 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. Plus la valeur zIndex est élevée, plus la priorité est élevée.

Classe AdvancedMarkerClickEvent

Classe google.maps.marker.AdvancedMarkerClickEvent

Cet événement est créé en cliquant sur un repère avancé. Accédez à la position du repère avec event.target.position.

Cette classe étend Event.

Pour y accéder, appelez const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker"). Consultez Bibliothèques dans l'API Maps JavaScript.

Classe PinElement

Classe google.maps.marker.PinElement

Un PinElement 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 la AdvancedMarkerElement par défaut. Le glyphe est un élément DOM facultatif qui s'affiche dans la forme de l'infobulle. Une PinElement peut avoir un format différent en fonction de son PinElement.scale.

Remarque:L'utilisation en tant que composant Web (par exemple, en tant que sous-classe HTMLElement ou via HTML) n'est pas encore acceptée.

Cette classe étend HTMLElement.

Cette classe implémente PinElementOptions.

Pour y accéder, appelez const {PinElement} = await google.maps.importLibrary("marker"). Consultez Bibliothèques dans l'API Maps JavaScript.
PinElement
PinElement([options])
Paramètres: 
background
Type:string optional
Consultez les PinElementOptions.background.
borderColor
Type:string optional
Consultez les PinElementOptions.borderColor.
element
Ce champ est en lecture seule. Élément DOM supportant la vue.
glyph
Type:string|Element|URL optional
Consultez les PinElementOptions.glyph.
glyphColor
Type:string optional
Consultez les PinElementOptions.glyphColor.
scale
Type:number optional
Consultez les PinElementOptions.scale.
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres: 
Valeur renvoyée:  void
Cette fonction n'est pas encore disponible.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres: 
  • type:  string Chaîne spécifiant le type d'événement pour lequel supprimer un écouteur d'événements.
  • listener:  EventListener|EventListenerObject Écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options:  boolean|EventListenerOptions optional Voir les options
Valeur renvoyée:  void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

PinElementOptions.

Interface google.maps.marker.PinElementOptions

Options de création d'un PinElement
background optional
Type:string optional
Couleur d'arrière-plan de la forme de l'épingle. Compatible avec toutes les valeurs de couleur CSS.
borderColor optional
Type:string optional
Couleur de bordure de la forme du repère. Compatible avec toutes les valeurs de couleur CSS.
glyph optional
Type:string|Element|URL optional
Élément DOM affiché dans l'épingle.
glyphColor optional
Type:string optional
Couleur du glyphe. Compatible avec toutes les valeurs de couleur CSS.
scale optional
Type:number optional
Par défaut:1
Échelle du repère.