Marker

Klasse Marker

google.maps.Marker-Klasse

Diese Klasse erweitert MVCObject.

Durch Aufrufen von const {Marker} = await google.maps.importLibrary("marker") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Marker
Marker([opts])
Parameter:
Erstellt eine Markierung mit den angegebenen Optionen. Wenn die Karte spezifiziert wird, wird die Markierung der Karte bei der Konstruktion hinzugefügt. Beachten Sie, dass die Position festgelegt sein muss, damit der Marker angezeigt werden kann.
getAnimation
getAnimation()
Parameter:Keine
Rückgabewert:  Animation|null|undefined
Aktuell laufende Animation abrufen.
getClickable
getClickable()
Parameter:Keine
Rückgabewert:boolean „true“, wenn die Markierung anklickbar ist.
den anklickbaren Status von Marker abrufen,
getCursor
getCursor()
Parameter:Keine
Rückgabewert:  string|null|undefined
den Mauszeiger bewegen kann, wenn der Mauszeiger darauf bewegt wird.
getDraggable
getDraggable()
Parameter:Keine
Rückgabewert:boolean „true“, wenn die Markierung ziehbar ist.
Den ziehbaren Status von Marker abrufen.
getIcon
getIcon()
Parameter:Keine
Rückgabewert:  string|Icon|Symbol|null|undefined
Rufen Sie das Symbol von Marker ab. MarkerOptions.icon ansehen.
getLabel
getLabel()
Parameter:Keine
Rückgabewert:  MarkerLabel|string|null|undefined
Rufen Sie das Label von Marker ab. MarkerOptions.label ansehen.
getMap
getMap()
Parameter:Keine
Rückgabewert:  Map|StreetViewPanorama
Karte oder Panoramen abrufen, auf denen die Marker gerendert wird.
getOpacity
getOpacity()
Parameter:Keine
Rückgabewert:number|null|undefined Eine Zahl zwischen 0,0 und 1,0.
Rufen Sie die Deckkraft von Marker ab.
getPosition
getPosition()
Parameter:Keine
Rückgabewert:  LatLng|null|undefined
Bestimme die Position des Marker.
getShape
getShape()
Parameter:Keine
Rückgabewert:  MarkerShape|null|undefined
Findet die Form des Marker für die Interaktion. Siehe MarkerOptions.shape und MarkerShape.
getTitle
getTitle()
Parameter:Keine
Rückgabewert:  string|null|undefined
Rufen Sie den Titel der Marker-Kurzinfo ab. MarkerOptions.title ansehen.
getVisible
getVisible()
Parameter:Keine
Rückgabewert:boolean „true“, wenn die Markierung sichtbar ist.
Sichtbarkeit von Marker abrufen.
getZIndex
getZIndex()
Parameter:Keine
Rückgabewert:number|null|undefined z-Index der Markierung.
Rufen Sie den zIndex der Marker ab. MarkerOptions.zIndex ansehen.
setAnimation
setAnimation([animation])
Parameter:
  • animation:  Animation optional Die wiedergegebene Animation.
Rückgabewert: Keine
Animation starten. Alle laufenden Animationen werden abgebrochen. Derzeit werden folgende Animationen unterstützt: Animation.BOUNCE, Animation.DROP. Wenn Sie null übergeben, wird die Animation beendet.
setClickable
setClickable(flag)
Parameter:
  • flag:  boolean Bei true kann auf die Markierung geklickt werden.
Rückgabewert: Keine
Legt fest, ob die Marker anklickbar ist.
setCursor
setCursor([cursor])
Parameter:
  • cursor:  string optional Mauszeigertyp
Rückgabewert: Keine
Den Mauszeigertyp festlegen, der erscheint, wenn der Mauszeiger darauf bewegt wird.
setDraggable
setDraggable(flag)
Parameter:
  • flag:  boolean optional Bei true kann die Markierung gezogen werden.
Rückgabewert: Keine
Legen Sie fest, ob Marker verschoben werden soll.
setIcon
setIcon([icon])
Parameter:
Rückgabewert: Keine
Legen Sie das Symbol für Marker fest. MarkerOptions.icon ansehen.
setLabel
setLabel([label])
Parameter:
  • label:  string|MarkerLabel optional Das Label kann entweder ein Zeichenstring oder ein MarkerLabel-Objekt sein.
Rückgabewert: Keine
Legen Sie das Label für Marker fest. MarkerOptions.label ansehen.
setMap
setMap(map)
Parameter:
Rückgabewert: Keine
Gibt das Marker-Objekt auf der angegebenen Karte oder dem angegebenen Panorama wieder. Wenn für die Karte null festgelegt ist, wird die Markierung entfernt.
setOpacity
setOpacity([opacity])
Parameter:
  • opacity:  number optional Eine Zahl zwischen 0,0, transparent und 1,0, undurchsichtig.
Rückgabewert: Keine
Deckkraft von Marker festlegen.
setOptions
setOptions(options)
Parameter:
Rückgabewert: Keine
Legen Sie die Optionen für Marker fest.
setPosition
setPosition([latlng])
Parameter:
Rückgabewert: Keine
Legt den Satz für Marker fest.
setShape
setShape([shape])
Parameter:
Rückgabewert: Keine
Legen Sie die Form des Marker für die Interaktion fest. Siehe MarkerOptions.shape und MarkerShape.
setTitle
setTitle([title])
Parameter:
  • title:  string optional
Rückgabewert: Keine
Legen Sie den Titel der Kurzinfo Marker fest. MarkerOptions.title ansehen.
setVisible
setVisible(visible)
Parameter:
  • visible:  boolean Wenn true, ist die Markierung sichtbar
Rückgabewert: Keine
Legen Sie fest, ob Marker sichtbar ist.
setZIndex
setZIndex([zIndex])
Parameter:
  • zIndex:  number optional
Rückgabewert: Keine
Legen Sie den zIndex der Marker fest. MarkerOptions.zIndex ansehen.
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
MAX_ZINDEX Der maximale Standard-Z-Index, den das API einer Markierung zuweist. Sie können einen höheren Z-Index festlegen, um eine Markierung in den Vordergrund zu bringen.
animation_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Animationseigenschaft von Marker ändert.
click
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn auf das Symbol Marker geklickt wurde.
clickable_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die anklickbare Eigenschaft Marker ändert.
contextmenu
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn das DOM-Kontextmenüereignis für Marker ausgelöst wird.
cursor_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft Marker-Cursor ändert.
dblclick
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn das Symbol Marker doppelt angeklickt wurde.
drag
function(event)
Argumente: 
Dieses Ereignis wird wiederholt ausgelöst, während der Nutzer die Marker zieht.
dragend
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn der Nutzer das Ziehen der Marker beendet.
draggable_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die verschiebbare Eigenschaft Marker ändert.
dragstart
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn der Nutzer beginnt, die Marker zu ziehen.
flat_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die flache Property Marker ändert.
icon_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich das Symbolattribut Marker ändert.
mousedown
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn bei Marker ein Mousedown ausgelöst wird.
mouseout
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn die Maus den Bereich des Marker-Symbols verlässt.
mouseover
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn die Maus in den Bereich des Symbols Marker gelangt.
mouseup
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn ein Mouseup auf Marker ausgelöst wird.
position_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Positionseigenschaft Marker ändert.
shape_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Formeigenschaft Marker ändert.
title_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft Marker des Titels ändert.
visible_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die sichtbare Property Marker ändert.
zindex_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft MarkerzIndex ändert.
rightclick
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn mit der rechten Maustaste auf Marker geklickt wird.

Schnittstelle MarkerOptions

Schnittstelle google.maps.MarkerOptions

MarkerOptions-Objekt, mit dem die Attribute definiert werden, die für eine Markierung festgelegt werden können.
anchorPoint optional
Typ:Point optional
Der Versatz von der Position der Markierung bis zur Spitze eines Infofensters, das mit der Markierung als Anker geöffnet wurde.
animation optional
Typ:Animation optional
Standard: null
Gibt an, welche Animation abgespielt werden soll, wenn der Karte eine Markierung hinzugefügt wird.
clickable optional
Typ:boolean optional
Standard: true
Bei true empfängt die Markierung Maus- und Touch-Ereignisse.
BetacollisionBehavior optional
Typ:string|CollisionBehavior optional
Standard: null
Legen Sie ein Konfliktverhalten für Markierungen auf Vektorkarten fest.
crossOnDrag optional
Typ:boolean optional
Standard: true
Wenn false, wird das Kreuz deaktiviert, das beim Ziehen unter der Markierung erscheint.
cursor optional
Typ:string optional
Standard: pointer
Cursortyp, der angezeigt wird, wenn der Mauszeiger darauf bewegt wird.
draggable optional
Typ:boolean optional
Standard: false
Bei true kann die Markierung gezogen werden.
icon optional
Typ:string|Icon|Symbol optional
Symbol für den Vordergrund. Wenn ein String angegeben ist, wird er so behandelt, als wäre ein Icon mit dem String url.
label optional
Typ:string|MarkerLabel optional
Standard: null
Fügt der Markierung ein Label hinzu. Ein Markierungslabel ist ein Buchstabe oder eine Zahl, der bzw. die innerhalb einer Markierung angezeigt wird. Das Label kann entweder ein String oder ein MarkerLabel-Objekt sein. Ist kein Wert angegeben, wird MarkerOptions.title kein Text zur Barrierefreiheit (z.B. zur Verwendung mit Screenreadern) eingefügt, der mit dem Text des angegebenen Labels versehen wird. Hinweis: label wird derzeit nur für Bedienungshilfentext für nicht optimierte Markierungen verwendet.
map optional
Typ:Map|StreetViewPanorama optional
Karte, auf der die Markierung angezeigt werden soll. Die Karte ist zum Anzeigen der Markierung erforderlich. Sie kann mit Marker.setMap bereitgestellt werden, sofern sie nicht beim Erstellen der Markierung angegeben wurde.
opacity optional
Typ:number optional
Standard: 1,0
Eine Zahl zwischen 0,0, transparent und 1,0, undurchsichtig.
optimized optional
Typ:boolean optional
Durch die Optimierung wird die Leistung verbessert, weil viele Markierungen als einzelnes statisches Element gerendert werden. Das ist in Fällen nützlich, in denen eine große Anzahl von Markierungen erforderlich ist. Weitere Informationen zur Optimierung von Markierungen
position optional
Typ:LatLng|LatLngLiteral optional
Legt die Position der Markierung fest. Eine Markierung kann konstruiert, aber erst angezeigt werden, wenn ihre Position angegeben wurde, z. B. durch die Aktionen oder Entscheidungen eines Nutzers. Eine Markierungsposition kann mit Marker.setPosition angegeben werden, sofern sie nicht beim Erstellen von Markierungen angegeben wurde.
shape optional
Typ:MarkerShape optional
Definition des Kartenbildbereichs, der für Verschieben/Klicken verwendet wird.
title optional
Typ:string optional
Standard: undefined
Rollover-Text. Falls angegeben, wird der Markierung mit einem angegebenen Wert eine Bedienungshilfe hinzugefügt (z.B. zur Verwendung mit Screenreadern). Hinweis: title wird derzeit nur für Bedienungshilfentext für nicht optimierte Markierungen verwendet.
visible optional
Typ:boolean optional
Standard: true
Bei true ist die Markierung sichtbar.
zIndex optional
Typ:number optional
Sämtliche Markierungen werden auf der Karte in der Reihenfolge ihres zIndex angezeigt, wobei Markierungen mit höheren Werten vor Markierungen mit niedrigeren Werten rangieren. Standardmäßig werden Markierungen gemäß ihrer vertikalen Positionen auf dem Bildschirm angezeigt, wobei niedrigere Markierungen vor Markierungen stehen, die sich höher oben auf dem Bildschirm befinden.

CollisionBehavior-Konstanten

google.maps.CollisionBehavior Konstanten

Durch Aufrufen von const {CollisionBehavior} = await google.maps.importLibrary("marker") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
OPTIONAL_AND_HIDES_LOWER_PRIORITY Die Markierung wird nur angezeigt, wenn sie sich nicht mit anderen Markierungen überschneidet. Wenn sich zwei Markierungen dieses Typs überschneiden, wird die Markierung mit dem höheren ZIndex angezeigt. Wenn sie denselben zIndex haben, wird der mit der niedrigeren vertikalen Bildschirmposition angezeigt.
REQUIRED Die Markierung wird unabhängig von Konflikten mit anderen Markierungen immer angezeigt. Das ist das Standardverhalten.
REQUIRED_AND_HIDES_OPTIONAL Die Markierung unabhängig von Konflikten mit Markierungen anzeigen und alle OPTIONAL_AND_HIDES_LOWER_PRIORITY-Markierungen oder Labels, die sich mit ihr überschneiden würden, ausblenden.

Symbol-Schnittstelle

Schnittstelle google.maps.Icon

Eine Struktur für ein Bild des Markierungssymbols.
url
Typ:string
Die URL des Bildes oder Sprite-Blattes.
anchor optional
Typ:Point optional
Die Position, an der ein Bild entsprechend der Position der Markierung auf der Karte verankert werden soll. Standardmäßig befindet sich der Anker am zentralen Punkt am unteren Rand des Bildes.
labelOrigin optional
Typ:Point optional
Der Ursprung des Labels relativ zur linken oberen Ecke des Symbolbilds, falls ein Label von der Markierung bereitgestellt wird. Standardmäßig befindet sich der Ursprung im Bildmittelpunkt.
origin optional
Typ:Point optional
Die Position des Bildes innerhalb von einem Sprite, falls vorhanden. Standardmäßig befindet sich der Ursprung in der oberen linken Ecke des Bildes (0, 0).
scaledSize optional
Typ:Size optional
Die Größe des gesamten Bildes nach der Skalierung, falls diese durchgeführt wurde. Verwenden Sie diese Eigenschaft, um ein Bild oder ein Sprite zu strecken oder zu verkleinern.
size optional
Typ:Size optional
Die Anzeigegröße von einem Sprite oder Bild. Bei der Verwendung von Sprites müssen Sie die Sprite-Größe festlegen. Wenn keine Angabe für die Größe vorhanden ist, wird diese beim Laden des Bildes festgelegt.

Schnittstelle MarkerLabel

Schnittstelle google.maps.MarkerLabel

Mithilfe dieser Optionen wird die Darstellung eines Markierungslabels festgelegt. Ein Markierungslabel ist ein String (oft ein einzelnes Zeichen), der in der Markierung erscheint. Wenn Sie sie mit einer benutzerdefinierten Markierung verwenden, können Sie sie mit der Eigenschaft labelOrigin in der Klasse Icon neu positionieren.
text
Typ:string
Der Text, der im Label angezeigt werden soll.
className optional
Typ:string optional
Standard: '' (leerer String)
Die Eigenschaft „className“ des Elements des Labels (entspricht dem Klassenattribut des Elements). Es können mehrere durch Leerzeichen getrennte CSS-Klassen hinzugefügt werden. Farbe, Größe, Gewicht und Familie der Schrift können nur über die anderen Eigenschaften von MarkerLabel festgelegt werden. CSS-Klassen sollten nicht verwendet werden, um die Position oder Ausrichtung des Labels zu ändern (z.B. bei Verwendung von Übersetzungen und Drehungen), wenn auch das Verwalten von Markierungskonflikten verwendet wird.
color optional
Typ:string optional
Standard: 'black'
Die Farbe des Labeltexts.
fontFamily optional
Typ:string optional
Die Schriftfamilie des Labeltexts (entspricht der Eigenschaft der CSS-Schriftfamilie).
fontSize optional
Typ:string optional
Standard: '14px'
Die Schriftgröße des Labeltexts (entspricht der Eigenschaft der CSS-Schriftgröße).
fontWeight optional
Typ:string optional
Die Schriftstärke des Labeltexts (entspricht der Eigenschaft der CSS-Schriftart).

Schnittstelle MarkerShape

Schnittstelle google.maps.MarkerShape

Dieses Objekt definiert den anklickbaren Bereich eines Markierungsbilds. Die Form besteht aus den beiden Properties type und coord, mit denen der nicht transparente Bereich eines Bildes definiert wird.
coords
Typ:Array<number>
Das Format dieses Attributs hängt vom Wert von type ab und entspricht der Spezifikation von w3 AREA coords unter http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords.
Das Attribut coords ist ein Array von Ganzzahlen, mit denen die Pixelposition der Form relativ zur linken oberen Ecke des Zielbildes angegeben wird. Die Koordinaten richten sich nach dem Wert von type:
circle: Koordiniert ist [x1,y1,r],wobei x1, y2 die Koordinaten des Kreismittelpunkts sind und r der Radius des Kreises ist.
poly: Koordiniert ist [x1,y1,x2,y2...xn,yn], wobei jedes x,y-Paar die Koordinaten eines Scheitelpunkts des Polygons enthält.
- rect: Koordiniert ist [x1,y1,x2,y2], wobei x1,y1 die Koordinaten der linken oberen Ecke des Rechtecks und x2,y2 die Koordinaten der rechten unteren Ecke sind.
type
Typ:string
Beschreibt den Typ der Form und kann circle, poly oder rect sein.

Symbol-Schnittstelle

Schnittstelle google.maps.Symbol

Beschreibt ein Symbol, das aus einem Vektorpfad mit Stilen besteht. Ein Symbol kann als Symbol einer Markierung verwendet oder auf einer Polylinie platziert werden.
path
Typ:SymbolPath|string
Der Pfad des Symbols. Dabei handelt es sich um einen integrierten Symbolpfad oder einen benutzerdefinierten Pfad, der in SVG-Pfadnotation ausgedrückt wird. Erforderlich.
anchor optional
Typ:Point optional
Standard: google.maps.Point(0,0)
Die Position des Symbols relativ zur Markierung oder Polylinie. Die Koordinaten des Symbolpfads werden durch die x- und x-Koordinaten des Ankerpunkts nach links und oben umgesetzt. Die Position wird im selben Koordinatensystem ausgedrückt wie der Pfad des Symbols.
fillColor optional
Typ:string optional
Die Füllfarbe des Symbols. Alle CSS3-Farben werden unterstützt, mit Ausnahme von Farben mit erweiterten Namen. Für Symbolmarkierungen ist der Standardwert „black“. Für Symbole auf Polylinien entspricht dies der Strichfarbe der jeweiligen Polylinie.
fillOpacity optional
Typ:number optional
Standard: 0
Die Deckkraft des Symbols.
labelOrigin optional
Typ:Point optional
Standard: google.maps.Point(0,0)
Der Ursprung des Labels relativ zum Ursprung des Pfads, wenn das Label von der Markierung angegeben wird. Der Ursprung wird im selben Koordinatensystem wie der Pfad des Symbols ausgedrückt. Diese Eigenschaft wird für Polyliniensymbole nicht verwendet.
rotation optional
Typ:number optional
Standard: 0
Der Winkel, um den das Symbol gedreht werden soll. Der Wert wird im Uhrzeigersinn in Grad ausgedrückt. Ein Symbol in einem IconSequence, wobei fixedRotation false relativ zum Winkel der Kante gedreht wird, auf der es liegt.
scale optional
Typ:number optional
Der Wert, um den die Größe des Symbols skaliert wird. Für Symbolmarkierungen ist der Standardwert „1“. Nach der Skalierung kann das Symbol eine beliebige Größe haben. Für Symbole auf Polylinien entspricht das standardmäßig der Strichstärke der Polylinie. Nach der Skalierung muss das Symbol innerhalb eines quadratischen Quadrats von 22 Pixeln liegen, dessen Mittelpunkt der Anker des Symbols ist.
strokeColor optional
Typ:string optional
Die Strichfarbe des Symbols Alle CSS3-Farben werden unterstützt, mit Ausnahme von Farben mit erweiterten Namen. Für Symbolmarkierungen ist der Standardwert „black“. Für Symbole auf Polylinien wird standardmäßig die Strichfarbe der Polylinie verwendet.
strokeOpacity optional
Typ:number optional
Die Deckkraft des Symbols. Für Symbolmarkierungen ist der Standardwert „1“. Für Symbole auf Polylinien entspricht dies standardmäßig der Strichdeckkraft der Polylinie.
strokeWeight optional
Typ:number optional
Standard: Symbol.scale des Symbols
Die Strichstärke des Symbols.

SymbolPath-Konstanten

google.maps.SymbolPath Konstanten

Integrierte Symbolpfade.

Durch Aufrufen von const {SymbolPath} = await google.maps.importLibrary("core") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
BACKWARD_CLOSED_ARROW Ein geschlossener Pfeil, der nach hinten zeigt.
BACKWARD_OPEN_ARROW Ein offener Pfeil, der nach hinten zeigt
CIRCLE Ein Kreis
FORWARD_CLOSED_ARROW Ein nach vorne zeigender geschlossener Pfeil
FORWARD_OPEN_ARROW Ein nach vorne zeigender offener Pfeil

Animationskonstanten

google.maps.Animation Konstanten

Animationen, die auf einer Markierung abgespielt werden können. Verwende die Methode Marker.setAnimation für Markierungen oder die Option MarkerOptions.animation, um eine Animation abzuspielen.

Durch Aufrufen von const {Animation} = await google.maps.importLibrary("marker") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
BOUNCE Die Markierung wird so lange abgespielt, bis die Animation beendet wird. Dazu wird Marker.setAnimation mit null aufgerufen.
DROP Die Markierung wird vom oberen Kartenrand auf ihre endgültige Position bewegt. Die Animation wird beendet, sobald die Markierung ihre Position erreicht hat, und Marker.getAnimation gibt null zurück. Diese Art von Animation wird normalerweise bei der Erstellung der Markierung festgelegt.