Advanced Markers

AdvancedMarkerElement-Klasse

google.maps.marker.AdvancedMarkerElement Klasse

Zeigt eine Position auf einer Karte an. Beachten Sie, dass position festgelegt sein muss, damit AdvancedMarkerElement angezeigt wird.

Hinweis:Die Verwendung als Webkomponente (z.B. die Verwendung des benutzerdefinierten HTML-Elements <gmp-advanced-marker> 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.

Zugriff über const {AdvancedMarkerElement} = await google.maps.importLibrary("marker") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

AdvancedMarkerElement
AdvancedMarkerElement([options])
Parameter:
Erstellt ein AdvancedMarkerElement mit den angegebenen Optionen. Wenn eine Karte angegeben ist, wird das AdvancedMarkerElement der Karte bei der Konstruktion hinzugefügt.
collisionBehavior
Typ:CollisionBehavior optional
content
Typ:Node optional
element
Dieses Feld ist schreibgeschützt. Das DOM-Element, das die Ansicht unterstützt.
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 zu überwachenden Ereignistyp darstellt. Dabei wird die Groß- und Kleinschreibung berücksichtigt.
  • listenerEventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit der Methode "handleEvent" sein
  • optionsboolean|AddEventListenerOptions optional Weitere Informationen finden Sie unter Optionen. Benutzerdefinierte Ereignisse unterstützen nur capture und passive.
Rückgabewert:  void
Richtet eine Funktion ein, die immer aufgerufen wird, wenn das angegebene Ereignis an das Ziel geliefert wird. Siehe addEventListener
addListener
addListener(eventName, handler)
Parameter:
  • eventNamestring beobachtetes Ereignis.
  • handlerFunction-Funktion zum Verarbeiten von Ereignissen.
Rückgabewert:MapsEventListener Daraus resultierender Event-Listener.
Fügt die angegebene Listener-Funktion dem angegebenen Ereignisnamen im Maps Eventing-System hinzu.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter:
  • typestring Ein String, der die Art des Ereignisses angibt, für das ein Ereignis-Listener entfernt werden soll.
  • listenerEventListener|EventListenerObject Der Event-Listener des Event-Handlers, der aus dem Ereignisziel entfernt werden soll
  • optionsboolean|EventListenerOptions optional siehe Optionen
Rückgabewert:  void
Entfernt einen zuvor mit addEventListener registrierten Event-Listener aus dem Ziel. Siehe removeEventListener.
click
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn auf das Element AdvancedMarkerElement geklickt wird.

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

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

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

In Kombination mit addEventListener() nicht verfügbar.
Betagmp-click
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn auf das Element AdvancedMarkerElement geklickt wird. Wird am besten mit addEventListener() (anstelle von addListener()) verwendet.

AdvancedMarkerElementOptions.

google.maps.marker.AdvancedMarkerElementOptions-Schnittstelle

Optionen zum Erstellen eines AdvancedMarkerElement-Objekts.

collisionBehavior optional
Typ:CollisionBehavior optional
Eine Aufzählung, die angibt, wie sich ein AdvancedMarkerElement verhalten soll, wenn es mit einem anderen AdvancedMarkerElement oder den Basiskartenlabels auf einer Vektorkarte kollidiert.

Hinweis: Die Kollision von AdvancedMarkerElement zu AdvancedMarkerElement funktioniert sowohl in Raster- als auch in Vektorkarten, während AdvancedMarkerElement mit der Labelkollision der Basiskarte nur bei Vektorkarten funktioniert.

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

Hinweis: AdvancedMarkerElement klont nicht das übergebene DOM-Element. Sobald das DOM-Element an ein AdvancedMarkerElement-Element übergeben wurde, wird es durch Übergeben desselben DOM-Elements an ein anderes AdvancedMarkerElement verschoben, sodass das vorherige AdvancedMarkerElement-Element leer aussieht.

BetagmpClickable optional
Typ:boolean optional
Standard: false
Wenn true festgelegt ist, ist AdvancedMarkerElement anklickbar und löst das gmp-click-Ereignis aus. Außerdem ist es für Bedienungshilfen interaktiv, z. B. die Tastaturnavigation über Pfeiltasten.
gmpDraggable optional
Typ:boolean optional
Standard: false
Wenn true, kann AdvancedMarkerElement gezogen werden.

Hinweis: AdvancedMarkerElement mit Höhe kann nicht gezogen werden.

map optional
Typ:Map optional
Karte, auf der das AdvancedMarkerElement angezeigt werden soll. Die Karte ist zur Darstellung von AdvancedMarkerElement erforderlich und kann durch Festlegen von AdvancedMarkerElement.map bereitgestellt werden, wenn sie bei der Konstruktion nicht angegeben wurde.
position optional
Legt die Position von AdvancedMarkerElement fest. Ein AdvancedMarkerElement kann ohne Position erstellt werden, wird aber erst angezeigt, wenn seine Position angegeben wurde – beispielsweise durch die Aktionen oder Auswahlmöglichkeiten eines Nutzers. Die Position einer AdvancedMarkerElement kann durch Festlegen von AdvancedMarkerElement.position angegeben werden, wenn das bei der Konstruktion nicht angegeben wurde.

Hinweis: Die Höhe der Funktion AdvancedMarkerElement wird nur auf Vektorkarten unterstützt.

title optional
Typ:string optional
Rollover-Text. Falls angegeben, wird ein Text für die Barrierefreiheit (z.B. zur Verwendung mit Screenreadern) mit dem angegebenen Wert zu AdvancedMarkerElement hinzugefügt.
zIndex optional
Typ:number optional
Alle AdvancedMarkerElement-Werte werden auf der Karte in der Reihenfolge ihres zIndex angezeigt, wobei höhere Werte vor AdvancedMarkerElement-Werten mit niedrigeren Werten stehen. Standardmäßig werden AdvancedMarkerElements entsprechend ihrer vertikalen Position auf dem Bildschirm angezeigt, wobei niedrigere AdvancedMarkerElements vor AdvancedMarkerElements weiter oben auf dem Bildschirm erscheinen. Beachten Sie, dass zIndex auch zum Festlegen der relativen Priorität zwischen CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY erweiterten Markierungen verwendet wird. Ein höherer zIndex-Wert bedeutet eine höhere Priorität.

AdvancedMarkerClickEvent-Klasse

google.maps.marker.AdvancedMarkerClickEvent Klasse

Dieses Ereignis wird durch Klicken auf eine erweiterte Markierung erstellt. Mit event.target.position können Sie auf die Position der Markierung zugreifen.

Diese Klasse erweitert Event.

Zugriff über const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

PinElement

google.maps.marker.PinElement Klasse

Ein PinElement steht für ein DOM-Element, das aus einer Form und einem Symbol besteht. Die Form hat den gleichen Info-Pop-up-Stil wie die Standard-AdvancedMarkerElement. Das Symbol ist ein optionales DOM-Element, das in Form eines Info-Pop-ups angezeigt wird. Ein PinElement kann je nach PinElement.scale ein anderes Seitenverhältnis haben.

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

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert PinElementOptions.

Zugriff über const {PinElement} = await google.maps.importLibrary("marker") aufrufen. 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 die Ansicht unterstützt.
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:
  • typestring Ein String, der die Art des Ereignisses angibt, für das ein Ereignis-Listener entfernt werden soll.
  • listenerEventListener|EventListenerObject Der Event-Listener des Event-Handlers, der aus dem Ereignisziel entfernt werden soll
  • optionsboolean|EventListenerOptions optional siehe Optionen
Rückgabewert:  void
Entfernt einen zuvor mit addEventListener registrierten Event-Listener aus dem Ziel. Siehe removeEventListener.

PinElementOptions.

google.maps.marker.PinElementOptions-Schnittstelle

Optionen zum Erstellen eines PinElement.

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