Advanced Markers

Classe AdvancedMarkerElement

Classe google.maps.marker.AdvancedMarkerElement

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

Remarque:L'utilisation en tant que composant Web (par exemple, avec l'élément HTML <gmp-advanced-marker> personnalisé n'est disponible que sur la version 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 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 y est ajouté lors de la construction.

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 qui sauvegarde la vue.
gmpClickable	Avertissement:Disponible uniquement dans la version 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	Avertissement:Disponible uniquement dans la version 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é est envoyé à la cible. Découvrez addEventListener.
addListener	addListener(eventName, handler) Paramètres:  eventName:  string événement observé. handler:  Function fonction permettant de gérer les événements. Valeur renvoyée:MapsEventListener Écouteur d'événements obtenus. Ajoute la fonction d'écouteur donnée au nom d'événement indiqué dans le système Maps Eventing.
removeEventListener	Avertissement:Disponible uniquement dans la version 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é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 la section removeEventListener.

Événements
click	function(event) Arguments:  event:  MapMouseEvent Cet événement est déclenché lorsque l'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 fois lorsque l'utilisateur fait glisser AdvancedMarkerElement. Non disponible avec addEventListener().
dragend	function(event) Arguments:  event:  MapMouseEvent Cet événement est déclenché lorsque l'utilisateur cesse 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 AdvancedMarkerElement. Non disponible avec addEventListener().
gmp-click	Avertissement:Disponible uniquement dans la version v=beta. function(event) Arguments:  event:  AdvancedMarkerClickEvent Cet événement est déclenché lorsque l'utilisateur clique sur l'élément AdvancedMarkerElement. Il est préférable d'utiliser addEventListener() (plutôt que addListener()).

AdvancedMarkerElementOptions.

Interface google.maps.marker.AdvancedMarkerElementOptions

Options pour construire un AdvancedMarkerElement.

Propriétés
collisionBehavior optional	Type:CollisionBehavior optional Énumération spécifiant le comportement d'une AdvancedMarkerElement en cas de collision avec une autre AdvancedMarkerElement ou avec les libellés de la carte de base sur une carte vectorielle. Remarque: La collision entre AdvancedMarkerElement et AdvancedMarkerElement fonctionne sur les cartes matricielles et vectorielles, mais la collision AdvancedMarkerElement avec 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 est transmis à un AdvancedMarkerElement, le fait de transmettre le même élément DOM à un autre AdvancedMarkerElement déplace l'élément DOM et le AdvancedMarkerElement précédent semble vide.
gmpClickable optional	Avertissement:Disponible uniquement dans la version v=beta. Type:boolean optional Par défaut:false Si la valeur est true, le AdvancedMarkerElement sera cliquable et déclenchera l'événement gmp-click. Il sera également interactif pour des raisons d'accessibilité (par exemple, pour permettre la navigation au clavier via les touches fléchées).
gmpDraggable optional	Type:boolean optional Par défaut:false Si la valeur est true, vous pouvez faire glisser l'élément 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. Elle peut être fournie en définissant AdvancedMarkerElement.map si elle n'est pas fournie au moment de la construction.
position optional	Type:LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral 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 d'un utilisateur). La position d'une AdvancedMarkerElement peut être fournie en définissant AdvancedMarkerElement.position si elle n'est pas fournie au moment de la construction. Remarque: L'élément AdvancedMarkerElement avec l'altitude n'est compatible qu'avec les cartes vectorielles.
title optional	Type:string optional Texte de roulement. Si ce paramètre est fourni, un texte d'accessibilité (à utiliser avec les lecteurs d'écran, par exemple) sera ajouté à la 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 ayant des valeurs plus faibles. Par défaut, les AdvancedMarkerElements sont affichés 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. Une valeur zIndex supérieure indique une priorité plus élevée.

Classe AdvancedMarkerClickEvent

Classe google.maps.marker.AdvancedMarkerClickEvent

Avertissement:Disponible uniquement dans la version v=beta.

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

Remarque:L'utilisation en tant que composant Web (par exemple, via une 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 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 qui sauvegarde 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	Avertissement:Disponible uniquement dans la version v=beta. addEventListener(type, listener[, options]) Paramètres:  type:  string listener:  EventListener|EventListenerObject options:  boolean|AddEventListenerOptions optional Valeur renvoyée:  void Cette fonction n'est pas encore disponible.
removeEventListener	Avertissement:Disponible uniquement dans la version 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é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 la section removeEventListener.

PinElementOptions.

Interface google.maps.marker.PinElementOptions

Options pour créer un PinElement.

Propriétés
background optional	Type:string optional Couleur d'arrière-plan de la forme du repère. Compatible avec n'importe quelle valeur de couleur CSS.
borderColor optional	Type:string optional Couleur de la bordure de la forme de la broche. Compatible avec n'importe quelle valeur 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 n'importe quelle valeur de couleur CSS.
scale optional	Type:number optional Par défaut:1 Échelle du repère.