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'aide de 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.

Accédez-y en appelant const {AdvancedMarkerElement} = await google.maps.importLibrary("marker"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constructeur
AdvancedMarkerElement	AdvancedMarkerElement([options]) Paramètres: options:  AdvancedMarkerElementOptions optional Crée un AdvancedMarkerElement avec les options spécifiées. Si une carte est spécifiée, le AdvancedMarkerElement est ajouté à la carte lors de la création.

Propriétés
collisionBehavior	Type:CollisionBehavior optional Consultez les AdvancedMarkerElementOptions.collisionBehavior.
content	Type:Node optional Consultez les AdvancedMarkerElementOptions.content.
element	Type:HTMLElement Ce champ est en lecture seule. Élément DOM sous-jacent à la vue.
gmpClickable	Remarque:Disponible uniquement dans le canal v=beta. Type:boolean optional Consultez les AdvancedMarkerElementOptions.gmpClickable.
gmpDraggable	Type:boolean optional Consultez les AdvancedMarkerElementOptions.gmpDraggable.
map	Type:Map optional Consultez les AdvancedMarkerElementOptions.map.
position	Type:LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional 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.

Méthodes
addEventListener	Remarque:Disponible uniquement dans le canal v=beta. 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 avec 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é sera envoyé à la cible. Voir 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 généré. Ajoute la fonction d'écouteur donnée au nom d'événement donné dans le système d'événements Maps.
removeEventListener	Remarque:Disponible uniquement dans le canal v=beta. removeEventListener(type, listener[, options]) Paramètres: type:  string Chaîne spécifiant le type d'événement pour lequel supprimer un écouteur d'événement. listener:  EventListener|EventListenerObject Écouteur d'événements du gestionnaire d'événements à supprimer de la cible d'événement. options:  boolean|EventListenerOptions optional Voir les options Valeur renvoyée:void Supprime de la cible un écouteur d'événement précédemment enregistré avec addEventListener. Voir removeEventListener

Événements
click	function(event) Arguments:  event:  MapMouseEvent Cet événement est déclenché lorsqu'un utilisateur clique sur l'élément AdvancedMarkerElement. Non disponible avec addEventListener() (utilisez plutôt gmp-click).
drag	function(event) Arguments:  event:  MapMouseEvent Cet événement est déclenché à plusieurs reprises pendant que l'utilisateur fait glisser le AdvancedMarkerElement. Non disponible avec addEventListener().
dragend	function(event) Arguments:  event:  MapMouseEvent Cet événement se déclenche lorsque l'utilisateur arrête de faire glisser le AdvancedMarkerElement. Non disponible avec addEventListener().
dragstart	function(event) Arguments:  event:  MapMouseEvent Cet événement est déclenché lorsque l'utilisateur commence à faire glisser l'AdvancedMarkerElement. Non disponible avec addEventListener().
gmp-click	Remarque:Disponible uniquement dans le canal v=beta. function(event) Arguments:  event:  AdvancedMarkerClickEvent Cet événement est déclenché lorsqu'un utilisateur clique sur l'élément AdvancedMarkerElement. À utiliser de préférence avec addEventListener() (plutôt que addListener()).

Interface AdvancedMarkerElementOptions

Interface google.maps.marker.AdvancedMarkerElementOptions

Options de création d'un AdvancedMarkerElement.

Propriétés
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. Toutefois, la collision entre AdvancedMarkerElement et le libellé 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 sous-jacent au visuel d'un AdvancedMarkerElement. Remarque: AdvancedMarkerElement ne clone pas l'élément DOM transmis. Une fois l'élément DOM transmis à un AdvancedMarkerElement, le fait de transmettre le même élément DOM à un autre AdvancedMarkerElement le déplace et fait apparaître l'AdvancedMarkerElement précédent comme vide.
gmpClickable optional	Remarque:Disponible uniquement dans le canal v=beta. Type:boolean optional Par défaut:false Si la valeur est true, le AdvancedMarkerElement est cliquable et déclenche l'événement gmp-click. Il est également interactif à des fins d'accessibilité (par exemple, il permet la navigation au clavier à l'aide des touches fléchées).
gmpDraggable optional	Type:boolean optional Par défaut:false Si la valeur est true, le AdvancedMarkerElement peut être déplacé. Remarque: AdvancedMarkerElement avec altitude n'est pas déplaçable.
map optional	Type:Map optional Carte sur laquelle afficher le AdvancedMarkerElement. La carte est nécessaire pour afficher le AdvancedMarkerElement et peut être fournie en définissant AdvancedMarkerElement.map si elle n'est pas fournie lors de la création.
position optional	Type:LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Définit la position de AdvancedMarkerElement. Un AdvancedMarkerElement peut être construit sans position, mais ne s'affichera que lorsque sa position sera fournie (par exemple, par les actions ou les choix d'un utilisateur). La position d'un AdvancedMarkerElement peut être fournie en définissant AdvancedMarkerElement.position si elle n'est pas fournie lors de la création. Remarque: AdvancedMarkerElement avec altitude n'est compatible qu'avec les cartes vectorielles.
title optional	Type:string optional Texte de roulement. Si elle est fournie, une valeur d'accessibilité (par exemple, pour une utilisation avec des lecteurs d'écran) est ajoutée à AdvancedMarkerElement.
zIndex optional	Type:number optional Tous les AdvancedMarkerElement sont affichés sur la carte par ordre de zIndex, les valeurs les plus élevées s'affichant devant les AdvancedMarkerElement ayant des valeurs plus faibles. Par défaut, les AdvancedMarkerElement sont affichées en fonction de leur position verticale à l'écran, les AdvancedMarkerElement les plus basses apparaissant devant les AdvancedMarkerElement situées plus haut 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 supérieure indique une priorité plus élevée).

Classe AdvancedMarkerClickEvent

Classe google.maps.marker.AdvancedMarkerClickEvent

Remarque:Disponible uniquement dans le canal v=beta.

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

Cette classe étend Event.

Accédez-y en appelant const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker"). Consultez la section Bibliothèques de 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 de ballon que celui de l'AdvancedMarkerElement par défaut. Le glyphe est un élément DOM facultatif affiché sous la forme d'un ballon. Un 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 prise en charge.

Cette classe étend HTMLElement.

Cette classe implémente PinElementOptions.

Accédez-y en appelant const {PinElement} = await google.maps.importLibrary("marker"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constructeur
PinElement	PinElement([options]) Paramètres: options:  PinElementOptions optional

Propriétés
background	Type:string optional Consultez les PinElementOptions.background.
borderColor	Type:string optional Consultez les PinElementOptions.borderColor.
element	Type:HTMLElement Ce champ est en lecture seule. Élément DOM sous-jacent à 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.

Méthodes
addEventListener	Remarque:Disponible uniquement dans le canal v=beta. addEventListener(type, listener[, options]) Paramètres: type:  string listener:  EventListener|EventListenerObject options:  boolean|AddEventListenerOptions optional Valeur renvoyée:void Cette fonctionnalité n'est pas encore disponible.
removeEventListener	Remarque:Disponible uniquement dans le canal v=beta. removeEventListener(type, listener[, options]) Paramètres: type:  string Chaîne spécifiant le type d'événement pour lequel supprimer un écouteur d'événement. listener:  EventListener|EventListenerObject Écouteur d'événements du gestionnaire d'événements à supprimer de la cible d'événement. options:  boolean|EventListenerOptions optional Voir les options Valeur renvoyée:void Supprime de la cible un écouteur d'événement précédemment enregistré avec addEventListener. Voir removeEventListener

Interface PinElementOptions

Interface google.maps.marker.PinElementOptions

Options de création d'un PinElement.

Propriétés
background optional	Type:string optional Couleur d'arrière-plan de la forme du repère. Compatible avec toutes les valeurs de couleur CSS.
borderColor optional	Type:string optional Couleur de la 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.