Advanced Markers

Klasse AdvancedMarkerElement

google.maps.marker.AdvancedMarkerElement-Klasse

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

Hinweis: Nutzung als Web-Komponente (z.B. unter Verwendung des benutzerdefinierten HTML-Elements <gmp-advanced-marker> ist nur im Kanal v=beta verfügbar).

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

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert AdvancedMarkerElementOptions.

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

AdvancedMarkerElement
AdvancedMarkerElement([options])
Parameter:
Erstellt eine AdvancedMarkerElement mit den angegebenen Optionen. Wenn eine Karte angegeben ist, wird das AdvancedMarkerElement-Element beim Erstellen der Karte hinzugefügt.
collisionBehavior
Typ:CollisionBehavior optional
content
Typ:Node optional
element
Dieses Feld ist schreibgeschützt. Das DOM-Element, das die Ansicht unterstü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 Groß- und Kleinschreibung, der den Ereignistyp darstellt, auf den gewartet werden soll.
  • listenerEventListener|EventListenerObject Das Objekt, das eine Benachrichtigung erhält. Dies muss eine Funktion oder ein Objekt mit derhandleEvent-Methode sein
  • optionsboolean|AddEventListenerOptions optional Optionen ansehen 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 übergeben wird. Weitere Informationen findest du im Abschnitt Optionen.
addListener
addListener(eventName, handler)
Parameter:
  • eventNamestring Erfasstes Ereignis.
  • handlerFunction – Funktion zum Verarbeiten von Ereignissen.
Rückgabewert:MapsEventListener Resultierter Ereignis-Listener.
Fügt die angegebene Listener-Funktion dem angegebenen Ereignisnamen im Maps Eventing-System hinzu.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter:
Rückgabewert:  void
Entfernt einen zuvor mit ASPMX registrierten Event-Listener aus dem Ziel. Siehe removeEventListener
click
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn auf das AdvancedMarkerElement-Element geklickt wird.

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

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

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

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

Schnittstelle AdvancedMarkerElementOptions

Schnittstelle google.maps.marker.AdvancedMarkerElementOptions

Optionen zum Erstellen eines AdvancedMarkerElement.

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

Hinweis: Die Konflikte von AdvancedMarkerElement zu AdvancedMarkerElement funktionieren sowohl in Raster- als auch in Vektorkarten. Die AdvancedMarkerElement-Zusammenführung in einem Label funktioniert jedoch nur bei Vektorkarten.

content optional
Typ:Node optional
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 wird, wird das DOM-Element verschoben, wenn das gleiche DOM-Element an ein anderes AdvancedMarkerElement-Element übergeben wird, sodass das vorherige AdvancedMarkerElement-Element leer aussieht.

gmpDraggable optional
Typ:boolean optional
Standard: false
Bei true kann AdvancedMarkerElement gezogen werden.

Hinweis: AdvancedMarkerElement kann nicht verschoben werden.

map optional
Typ:Map optional
Karte, auf der die AdvancedMarkerElement angezeigt werden soll. Die Karte muss zur Darstellung von AdvancedMarkerElement verwendet werden. Wenn keine AdvancedMarkerElement.map-Konstruktion bei der Konstruktion vorhanden ist, können Sie sie angeben.
position optional
Legt die Position des AdvancedMarkerElement fest. Ein AdvancedMarkerElement-Objekt kann ohne Position erstellt werden. Es wird jedoch erst angezeigt, wenn seine Position bereitgestellt wurde. Beispiel: Aktionen oder Auswahlmöglichkeiten eines Nutzers. Die Position von AdvancedMarkerElement kann angegeben werden, indem AdvancedMarkerElement.position festgelegt wird, wenn diese nicht in der Konstruktion angegeben ist.

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

title optional
Typ:string optional
Rollover-Text. Wenn angegeben, wird dem AdvancedMarkerElement mit dem angegebenen Wert ein Bedienungshilfentext (z.B. zur Verwendung mit Screenreadern) hinzugefügt.
zIndex optional
Typ:number optional
Alle AdvancedMarkerElements werden auf der Karte in der Reihenfolge ihres ZIndex angezeigt. Höhere Werte werden vor AdvancedMarkerElements mit niedrigeren Werten angezeigt. Standardmäßig werden AdvancedMarkerElements entsprechend ihrer vertikalen Position auf dem Bildschirm angezeigt. Die unteren AdvancedMarkerElements stehen vor AdvancedMarkerElement weiter oben auf dem Bildschirm. Beachten Sie, dass zIndex auch zur Bestimmung der relativen Priorität zwischen CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY-erweiterten Markierungen verwendet wird. Ein höherer zIndex-Wert gibt eine höhere Priorität an.

Klasse AdvancedMarkerClickEvent

google.maps.marker.AdvancedMarkerClickEvent-Klasse

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

Diese Klasse erweitert Event.

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

Klasse PinElement

google.maps.marker.PinElement-Klasse

Ein PinElement-Objekt repräsentiert ein DOM-Element, das aus einer Form und einem Symbol besteht. Die Form hat das gleiche Ballonformat wie bei der standardmäßigen AdvancedMarkerElement. Das Symbol ist ein optionales DOM-Element, das in der Info-Pop-up-Form angezeigt wird. Das Format PinElement kann je nach PinElement.scale ein anderes Seitenverhältnis haben.

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

Diese Klasse erweitert HTMLElement.

Diese Klasse implementiert PinElementOptions.

Durch Aufrufen von 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:
Rückgabewert:  void
Entfernt einen zuvor mit ASPMX registrierten Event-Listener aus dem Ziel. Siehe removeEventListener

Schnittstelle PinElementOptions

Schnittstelle google.maps.marker.PinElementOptions

Optionen zum Erstellen einer PinElement.

background optional
Typ:string optional
Die Hintergrundfarbe der Stecknadelform. Unterstützt alle Farbwert für CSS
borderColor optional
Typ:string optional
Die Rahmenfarbe der Stecknadelform. Unterstützt alle Farbwert für CSS
glyph optional
Typ:string|Element|URL optional
Das in der Markierung angezeigte DOM-Element.
glyphColor optional
Typ:string optional
Die Farbe des Glyphen. Unterstützt alle Farbwert für CSS
scale optional
Typ:number optional
Standard: 1
Die Waage der Markierung