Cette page a été traduite par l'API Cloud Translation.

Marker (legacy)

Classe Marker

Classe google.maps.Marker

Cette classe étend MVCObject.

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

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.

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

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 le repère est cliquable. Obtenez l'état cliquable du `Marker`.
`getCursor`	`getCursor()` Paramètres : aucun Valeur renvoyée : `string\|null\|undefined` Obtenez le type de curseur de la souris affiché au survol.
`getDraggable`	`getDraggable()` Paramètres : aucun Valeur renvoyée : `boolean` "True" si le repère est déplaçable. Obtenez l'état déplaçable du `Marker`.
`getIcon`	`getIcon()` Paramètres : aucun Valeur renvoyée : `string\|Icon\|Symbol\|null\|undefined` Obtenez l'icône de `Marker`. Consultez les `MarkerOptions.icon`.
`getLabel`	`getLabel()` Paramètres : aucun Valeur renvoyée : `MarkerLabel\|string\|null\|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 panorama sur lequel le `Marker` est affiché.
`getOpacity`	`getOpacity()` Paramètres : aucun Valeur renvoyée : `number\|null\|undefined`, un nombre compris entre 0,0 et 1,0. Obtenez l'opacité de `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. Consultez les `MarkerOptions.shape` et l'`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 Valeur renvoyée : `boolean` "True" si le repère est visible. Obtenez la visibilité de `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` L'animation à lire. Valeur renvoyée : aucune Lancez une animation. Toute animation en cours sera annulée. Les animations actuellement disponibles sont les suivantes : `Animation.BOUNCE`, `Animation.DROP`. Si vous transmettez `null`, toute animation s'arrête.
`setClickable`	`setClickable(flag)` Paramètres : `flag` : `boolean` Si la valeur est `true`, l'utilisateur peut cliquer sur le repère. Valeur renvoyée : aucune Indique si `Marker` est cliquable.
`setCursor`	`setCursor([cursor])` Paramètres : `cursor` : type de curseur de la souris `string optional`. Valeur renvoyée : aucune Définissez le type de curseur de la 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 renvoyée : aucune Définissez si `Marker` est déplaçable.
`setIcon`	`setIcon([icon])` Paramètres : `icon` : `string\|Icon\|Symbol optional` Valeur renvoyée : aucune Définissez l'icône pour `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 renvoyée : aucune Définissez le libellé pour `Marker`. Consultez les `MarkerOptions.label`.
`setMap`	`setMap(map)` Paramètres : `map` : `Map\|StreetViewPanorama` Valeur renvoyée : aucune Affiche `Marker` sur la carte ou le panorama spécifiés. Si la carte est définie sur `null`, le repère sera supprimé.
`setOpacity`	`setOpacity([opacity])` Paramètres : `opacity` : `number optional` nombre compris entre 0,0 (transparent) et 1,0 (opaque). Valeur renvoyée : aucune Définissez l'opacité de `Marker`.
`setOptions`	`setOptions(options)` Paramètres : `options` : `MarkerOptions` Valeur renvoyée : aucune Définissez les options pour `Marker`.
`setPosition`	`setPosition([latlng])` Paramètres : `latlng` : `LatLng\|LatLngLiteral optional` nouvelle position. Valeur renvoyée : aucune Définissez la position de `Marker`.
`setShape`	`setShape([shape])` Paramètres : `shape` : `MarkerShape optional` Valeur renvoyée : aucune Définissez la forme du `Marker` utilisé pour l'interaction. Consultez les `MarkerOptions.shape` et l'`MarkerShape`.
`setTitle`	`setTitle([title])` Paramètres : `title` : `string optional` Valeur renvoyée : 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 renvoyée : aucune Défini si `Marker` est visible.
`setZIndex`	`setZIndex([zIndex])` Paramètres : `zIndex` : `number optional` Valeur renvoyée : aucune Définissez le zIndex de `Marker`. Consultez les `MarkerOptions.zIndex`.
Hérité : `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

É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'icône `Marker` est sélectionnée.
`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 contextmenu du DOM est déclenché sur le `Marker`.
`cursor_changed`	`function()` Arguments : aucun Cet événement est déclenché lorsque la propriété de curseur `Marker` change.
`dblclick`	`function(event)` Arguments : `event` : `MapMouseEvent` Cet événement est déclenché lorsque l'utilisateur double-clique sur l'icône `Marker`.
`drag`	`function(event)` Arguments : `event` : `MapMouseEvent` Cet événement est déclenché à plusieurs reprises lorsque l'utilisateur fait glisser `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é d'icône `Marker` change.
`mousedown`	`function(event)` Arguments : `event` : `MapMouseEvent` Cet événement est déclenché lorsqu'un clic gauche est effectué sur `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 entre dans la zone de l'icône `Marker`.
`mouseup`	`function(event)` Arguments : `event` : `MapMouseEvent` Cet événement est déclenché lorsqu'un bouton de la souris est relâché 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é de forme `Marker` change.
`title_changed`	`function()` Arguments : aucun Cet événement est déclenché lorsque la propriété de titre `Marker` change.
`visible_changed`	`function()` Arguments : aucun Cet événement est déclenché lorsque la propriété visible de `Marker` change.
`zindex_changed`	`function()` Arguments : aucun Cet événement est déclenché lorsque la propriété zIndex de `Marker` change.
`rightclick`	Obsolète : utilisez l'événement `Marker.contextmenu` à la place pour prendre en charge les schémas d'utilisation tels que le contrôle-clic sur macOS. `function(event)` Arguments : `event` : `MapMouseEvent` Cet événement est déclenché lorsqu'un utilisateur effectue un clic droit sur `Marker`.

Interface MarkerOptions

Interface google.maps.MarkerOptions

Objet MarkerOptions utilisé pour 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 InfoWindow ouverte avec le repère comme point d'ancrage.
`animation optional`	Type : `Animation optional` Par défaut : `null` Animation à lire lorsqu'un 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 tactiles et de souris.
`collisionBehavior optional`	Obsolète : `collisionBehavior` est obsolète depuis juillet 2023. Utilisez plutôt `AdvancedMarkerElement.collisionBehavior`. Remarque : Disponible uniquement dans le canal v=beta. Type : `string\|CollisionBehavior optional` Par défaut : `null` Définissez le comportement en cas de collision pour les repères sur les cartes vectorielles.
`crossOnDrag optional`	Type : `boolean optional` Par défaut : `true` Si la valeur est `false`, la croix qui s'affiche sous le repère lors du déplacement est désactivée.
`cursor optional`	Type : `string optional` Par défaut : `pointer` Type de curseur de la souris à afficher au pointage.
`draggable optional`	Type : `boolean optional` Par défaut : `false` Si la valeur est `true`, le repère peut être déplacé. Remarque : Si vous définissez ce paramètre sur `true`, le repère sera cliquable même si `clickable` est défini sur `false`.
`icon optional`	Type : `string\|Icon\|Symbol optional` Icône du 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. Le libellé peut être une chaîne ou un objet `MarkerLabel`. Si ce champ est renseigné et que `MarkerOptions.title` ne l'est pas, un texte d'accessibilité (par exemple, pour les lecteurs d'écran) sera 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 nécessaire pour afficher le repère. Elle peut être fournie avec `Marker.setMap` si elle ne l'a pas été 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.0 (opaque).
`optimized optional`	Type : `boolean optional` L'optimisation permet d'améliorer 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 Remarque : Cette optimisation n'a aucun effet sur les repères des cartes vectorielles.
`position optional`	Type : `LatLng\|LatLngLiteral optional` Définit la position du repère. Un repère peut être construit, mais ne pas être affiché tant que sa position n'est pas fournie (par exemple, par les actions ou les choix d'un 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 la carte d'image utilisée pour le glisser-déposer/cliquer.
`title optional`	Type : `string optional` Par défaut : `undefined` Texte de roulement. Si un texte d'accessibilité (par exemple, à utiliser avec des lecteurs d'écran) est fourni, il sera 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 plus élevées s'affichant devant les repères ayant des valeurs plus faibles. Par défaut, les repères sont affichés en fonction de leur position verticale à l'écran. Les repères situés plus bas apparaissent devant ceux situés plus haut.

Constantes CollisionBehavior

google.maps.CollisionBehavior constantes

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

Constantes
`OPTIONAL_AND_HIDES_LOWER_PRIORITY`	Le repère s'affiche uniquement s'il n'en chevauche pas d'autres. Si deux repères de ce type se chevauchent, celui avec le z-index le plus élevé est affiché. S'ils ont le même zIndex, celui dont la position verticale à l'écran est la plus basse est affiché.
`REQUIRED`	Le repère s'affiche toujours, quelle que soit la collision. Il s'agit du comportement par défaut.
`REQUIRED_AND_HIDES_OPTIONAL`	Toujours afficher le repère, quelle que soit la collision, et masquer les repères ou libellés OPTIONAL_AND_HIDES_LOWER_PRIORITY qui le chevauchent.

Interface Icône

Interface google.maps.Icon

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 :

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

Classe Marker

Constructeur

Constantes

Méthodes

Événements