Advanced Markers

Klasse AdvancedMarkerElement

google.maps.marker.AdvancedMarkerElement Kurs

Zeigt eine Position auf einer Karte an. Die position muss festgelegt sein, damit die AdvancedMarkerElement angezeigt wird.

Hinweis:Die Verwendung als Webansicht (z.B. mit dem benutzerdefinierten <gmp-advanced-marker>-HTML-Element) ist nur im v=beta-Kanal verfügbar.

Benutzerdefiniertes Element:
<gmp-advanced-marker position="lat,lng" title="string"></gmp-advanced-marker>

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert AdvancedMarkerElementOptions.

Rufe const {AdvancedMarkerElement} = await google.maps.importLibrary("marker") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

AdvancedMarkerElement
AdvancedMarkerElement([options])
Parameter: 
Erstellt einen AdvancedMarkerElement mit den angegebenen Optionen. Wenn eine Karte angegeben ist, wird das AdvancedMarkerElement beim Erstellen der Karte hinzugefügt.
collisionBehavior
Typ:CollisionBehavior optional
content
Typ:Node optional
element
Dieses Feld ist schreibgeschützt. Das DOM-Element, das der Ansicht zugrunde liegt.
BetagmpClickable
Typ:boolean optional
gmpDraggable
Typ:boolean optional
map
Typ:Map optional
position
HTML-Attribut:
  • <gmp-advanced-marker position="lat,lng"></gmp-advanced-marker>
  • <gmp-advanced-marker position="lat,lng,altitude"></gmp-advanced-marker>
title
Typ:string
HTML-Attribut:
  • <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex
Typ:number optional
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring Ein String, der den Ereignistyp darstellt, auf den gewartet werden soll. Die Groß- und Kleinschreibung ist dabei zu beachten.
  • listenerEventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der Methode „handleEvent“ sein.
  • optionsboolean|AddEventListenerOptions optional Siehe Optionen. Bei benutzerdefinierten Ereignissen werden nur capture und passive unterstützt.
Rückgabewert:void
Hiermit wird eine Funktion eingerichtet, die aufgerufen wird, wenn das angegebene Ereignis an das Ziel gesendet wird. Weitere Informationen finden Sie unter addEventListener.
addListener
addListener(eventName, handler)
Parameter: 
  • eventNamestring Beobachtetes Ereignis.
  • handlerFunction Funktion zum Bearbeiten von Ereignissen.
Rückgabewert:MapsEventListener Der resultierende Event-Listener.
Fügt dem angegebenen Ereignisnamen im Maps-Ereignissystem die angegebene Listenerfunktion hinzu.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter: 
Rückgabewert:void
Entfernt einen zuvor mit addEventListener registrierten Ereignis-Listener aus dem Ziel. Siehe removeEventListener
click
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn auf das Element AdvancedMarkerElement geklickt wird.

Nicht mit addEventListener() verfügbar (verwenden Sie stattdessen gmp-click).
drag
function(event)
Argumente: 
Dieses Ereignis wird wiederholt ausgelöst, während der Nutzer die AdvancedMarkerElement zieht.

Nicht mit addEventListener() verfügbar.
dragend
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn der Nutzer das Ziehen der AdvancedMarkerElement beendet.

Nicht mit addEventListener() verfügbar.
dragstart
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn der Nutzer beginnt, die AdvancedMarkerElement zu ziehen.

Nicht mit addEventListener() verfügbar.
Betagmp-click
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn auf das Element AdvancedMarkerElement geklickt wird. Am besten mit addEventListener() (anstelle von addListener()) verwenden.

AdvancedMarkerElementOptions-Schnittstelle

google.maps.marker.AdvancedMarkerElementOptions Benutzeroberfläche

Optionen zum Erstellen einer AdvancedMarkerElement

collisionBehavior optional
Typ:CollisionBehavior optional
Eine Aufzählung, die angibt, wie sich eine AdvancedMarkerElement verhalten soll, wenn sie mit einer anderen AdvancedMarkerElement oder mit den Labels der Basiskarte auf einer Vektorkarte kollidiert.

Hinweis: Konflikte zwischen AdvancedMarkerElement-Elementen funktionieren sowohl auf Raster- als auch auf Vektorkarten. Konflikte zwischen AdvancedMarkerElement-Elementen und Basiskartenlabels funktionieren jedoch nur auf Vektorkarten.AdvancedMarkerElement

content optional
Typ:Node optional
Das DOM-Element, das das visuelle Element eines AdvancedMarkerElement unterstützt.

Hinweis: AdvancedMarkerElement klont das übergebene DOM-Element nicht. Wenn das DOM-Element an eine AdvancedMarkerElement übergeben wurde, wird es verschoben, wenn dasselbe DOM-Element an eine andere AdvancedMarkerElement übergeben wird. Dadurch erscheint die vorherige AdvancedMarkerElement leer.

BetagmpClickable optional
Typ:boolean optional
Standard:false
Bei true ist das AdvancedMarkerElement anklickbar und löst das gmp-click-Ereignis aus. Außerdem ist es interaktiv und erfüllt Bedienungshilfen-Anforderungen, z. B. die Tastaturnavigation über die Pfeiltasten.
gmpDraggable optional
Typ:boolean optional
Standard:false
Bei true kann die AdvancedMarkerElement verschoben werden.

Hinweis: AdvancedMarkerElement mit Höhe ist nicht verschiebbar.

map optional
Typ:Map optional
Karte, auf der die AdvancedMarkerElement angezeigt werden soll. Die Karte ist erforderlich, um die AdvancedMarkerElement anzuzeigen. Sie kann durch Festlegen von AdvancedMarkerElement.map bereitgestellt werden, falls sie beim Erstellen nicht angegeben wurde.
position optional
Legt die Position von AdvancedMarkerElement fest. Ein AdvancedMarkerElement kann ohne Position erstellt werden, wird aber erst angezeigt, wenn die Position angegeben wurde, z. B. durch die Aktionen oder Auswahl eines Nutzers. Die Position einer AdvancedMarkerElement kann durch Festlegen von AdvancedMarkerElement.position angegeben werden, falls sie nicht bei der Konstruktion angegeben wurde.

Hinweis: AdvancedMarkerElement mit Höhe wird nur auf Vektorkarten unterstützt.

title optional
Typ:string optional
Rollover-Text. Wenn angegeben, wird dem AdvancedMarkerElement mit dem angegebenen Wert ein Bedienungshilfentext (z.B. für die Verwendung mit Screenreadern) hinzugefügt.
zIndex optional
Typ:number optional
Alle AdvancedMarkerElement werden auf der Karte in der Reihenfolge ihres Z-Index angezeigt. Elemente mit höheren Werten werden vor Elementen mit niedrigeren Werten angezeigt.AdvancedMarkerElement Standardmäßig werden AdvancedMarkerElements gemäß ihrer vertikalen Position auf dem Bildschirm angezeigt. Dabei werden niedrigere AdvancedMarkerElements vor AdvancedMarkerElements angezeigt, die weiter oben auf dem Bildschirm zu sehen sind. Hinweis: zIndex wird auch verwendet, um die relative Priorität zwischen erweiterten CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY-Markierungen zu bestimmen. Je höher der zIndex-Wert, desto höher die Priorität.

AdvancedMarkerClickEvent-Klasse

google.maps.marker.AdvancedMarkerClickEvent Kurs

Dieses Ereignis wird durch Klicken auf eine erweiterte Markierung erstellt. Rufen Sie mit event.target.position die Position der Markierung auf.

Diese Klasse erweitert Event.

Rufe const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Klasse PinElement

google.maps.marker.PinElement Kurs

Ein PinElement stellt ein DOM-Element dar, das aus einer Form und einem Schriftzeichen besteht. Die Form hat denselben Infofeldstil wie im Standard-AdvancedMarkerElement. Das Glyph ist ein optionales DOM-Element, das in der Blasenform angezeigt wird. Ein PinElement kann je nach PinElement.scale ein anderes Seitenverhältnis haben.

Hinweis:Die Verwendung als Webanwendung (z.B. als HTMLElement-Unterklasse oder über HTML) wird noch nicht unterstützt.

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert PinElementOptions.

Rufe const {PinElement} = await google.maps.importLibrary("marker") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

PinElement
PinElement([options])
Parameter: 
background
Typ:string optional
borderColor
Typ:string optional
element
Dieses Feld ist schreibgeschützt. Das DOM-Element, das der Ansicht zugrunde liegt.
glyph
Typ:string|Element|URL optional
glyphColor
Typ:string optional
scale
Typ:number optional
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter: 
Rückgabewert:void
Diese Funktion ist noch nicht verfügbar.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter: 
Rückgabewert:void
Entfernt einen zuvor mit addEventListener registrierten Ereignis-Listener aus dem Ziel. Siehe removeEventListener

PinElementOptions-Schnittstelle

google.maps.marker.PinElementOptions Benutzeroberfläche

Optionen zum Erstellen eines PinElement

background optional
Typ:string optional
Die Hintergrundfarbe der Markierung. Unterstützt alle CSS-Farbwerte.
borderColor optional
Typ:string optional
Die Rahmenfarbe der Markierung. Unterstützt alle CSS-Farbwerte.
glyph optional
Typ:string|Element|URL optional
Das DOM-Element, das in der Markierung angezeigt wird.
glyphColor optional
Typ:string optional
Die Farbe des Symbols. Unterstützt alle CSS-Farbwerte.
scale optional
Typ:number optional
Standard:1
Die Skalierung des Pins.