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.

Mit dieser Klasse wird AdvancedMarkerElementOptions implementiert.

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 der AdvancedMarkerElement der Karte bei der Erstellung hinzugefügt.
collisionBehavior
Typ:CollisionBehavior optional
content
Typ:Node optional
element
Dieses Feld ist schreibgeschützt. Das DOM-Element, das die Ansicht stützt.
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. Dabei wird die Groß- und Kleinschreibung berücksichtigt.
  • listenerEventListener|EventListenerObject Das Objekt, das eine Benachrichtigung empfängt. 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 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 Entspricht dem Ereignis-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 Event-Listener, der zuvor mit addEventListener registriert wurde, aus dem Ziel. Siehe removeEventListener.
click
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn auf das AdvancedMarkerElement-Element geklickt wird.

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

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 AdvancedMarkerElement-Element geklickt wird. Wird am besten mit addEventListener() (anstelle von addListener()) verwendet.

AdvancedMarkerElementOptions-Schnittstelle

google.maps.marker.AdvancedMarkerElementOptions-Schnittstelle

Optionen zum Erstellen eines AdvancedMarkerElement-Objekts.

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

Hinweis: Der Konflikt zwischen AdvancedMarkerElement und AdvancedMarkerElement funktioniert sowohl bei Raster- als auch bei Vektorkarten. Der Konflikt zwischen AdvancedMarkerElement und dem Label der Basiskarte kann jedoch nur bei Vektorkarten verursacht werden.

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

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

gmpDraggable optional
Typ:boolean optional
Standardwert: false
Wenn true festgelegt ist, kann das AdvancedMarkerElement-Element 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 Bauarbeit noch nicht vorhanden ist.
position optional
Legt die Position von AdvancedMarkerElement fest. Ein AdvancedMarkerElement-Objekt kann ohne Position erstellt werden. Es wird jedoch erst angezeigt, wenn seine Position angegeben wurde – beispielsweise durch die Aktionen oder Auswahl eines Nutzers. Die Position einer AdvancedMarkerElement kann durch Festlegen von AdvancedMarkerElement.position angegeben werden, sofern das bei der Erstellung nicht vorhanden ist.

Hinweis: Die Höhe von AdvancedMarkerElement wird nur für Vektorkarten unterstützt.

title optional
Typ:string optional
Rollover-Text. Falls angegeben, wird AdvancedMarkerElement ein Text für die Barrierefreiheit (z.B. zur Verwendung mit Screenreadern) mit dem angegebenen Wert 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 AdvancedMarkerElement-Elemente entsprechend ihrer vertikalen Position auf dem Bildschirm angezeigt, wobei die niedrigeren AdvancedMarkerElement-Werte vor AdvancedMarkerElement-Elementen 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 weist auf eine höhere Priorität hin.

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-Klasse

google.maps.marker.PinElement Klasse

Ein PinElement steht für ein DOM-Element, das aus einer Form und einer Glyphe besteht. Die Form hat den gleichen Info-Pop-up-Stil wie im standardmäßigen AdvancedMarkerElement. Das Glyphe ist ein optionales DOM-Element, das in der 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 HTMLElement-Unterklasse oder über HTML) wird noch nicht unterstützt.

Diese Klasse erweitert HTMLElement.

Mit dieser Klasse wird PinElementOptions implementiert.

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 stü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 Event-Listener, der zuvor mit addEventListener registriert wurde, aus dem Ziel. Siehe removeEventListener.

PinElementOptions-Schnittstelle

google.maps.marker.PinElementOptions-Schnittstelle

Optionen zum Erstellen eines PinElement-Objekts.

background optional
Typ:string optional
Die Hintergrundfarbe der Stecknadelform. 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 der Glyphe. Unterstützt alle CSS-Farbwerte
scale optional
Typ:number optional
Standardwert: 1
Die Größe der Markierung.