Marker (legacy)

Marker-Klasse

google.maps.Marker Klasse

Diese Klasse erweitert MVCObject.

Zugriff über 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.
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.
getAnimation
getAnimation()
Parameter:Keine
Rückgabewert:  Animation|null|undefined
Ruft die aktuell laufende Animation ab.
getClickable
getClickable()
Parameter:Keine
Rückgabewert:  boolean „True“, wenn die Markierung anklickbar ist.
Ruft den anklickbaren Status von Marker ab.
getCursor
getCursor()
Parameter:Keine
Rückgabewert:  string|null|undefined
Hiermit lässt sich der Typ des Cursors abrufen, der angezeigt wird, wenn der Mauszeiger auf ein Objekt bewegt wird.
getDraggable
getDraggable()
Parameter:Keine
Rückgabewert:  boolean True, wenn die Markierung ziehbar ist.
Ruft den ziehbaren Status von Marker ab.
getIcon
getIcon()
Parameter:Keine
Rückgabewert:  string|Icon|Symbol|null|undefined
Laden Sie das Symbol von Marker herunter. 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
Rufen Sie die Karte oder das Panaroama ab, auf dem Marker gerendert wird.
getOpacity
getOpacity()
Parameter:Keine
Rückgabewert:number|null|undefined Eine Zahl zwischen 0,0 und 1,0.
Ermitteln Sie die Deckkraft von Marker.
getPosition
getPosition()
Parameter:Keine
Rückgabewert:  LatLng|null|undefined
Rufen Sie die Position von Marker ab.
getShape
getShape()
Parameter:Keine
Rückgabewert:  MarkerShape|null|undefined
Form des Marker abrufen, der für die Interaktion verwendet wird. Weitere Informationen findest du unter 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.
Rufen Sie die Sichtbarkeit von Marker ab.
getZIndex
getZIndex()
Parameter:Keine
Rückgabewert:number|null|undefined-zIndex der Markierung.
Ruft den Z-Index von Marker ab. MarkerOptions.zIndex ansehen.
setAnimation
setAnimation([animation])
Parameter:
  • animationAnimation optional Die Animation, die wiedergegeben werden soll.
Rückgabewert:Keine
Animation starten. Alle laufenden Animationen werden abgebrochen. Derzeit werden folgende Animationen unterstützt: Animation.BOUNCE, Animation.DROP. Die Übergabe von null beendet alle Animationen.
setClickable
setClickable(flag)
Parameter:
  • flagboolean Wenn true festgelegt ist, kann auf die Markierung geklickt werden.
Rückgabewert:Keine
Legen Sie fest, ob Marker anklickbar ist.
setCursor
setCursor([cursor])
Parameter:
  • cursorstring optional Mauscursortyp.
Rückgabewert:Keine
Hier können Sie die Art des Cursors festlegen, der beim Bewegen des Mauszeigers angezeigt wird.
setDraggable
setDraggable(flag)
Parameter:
  • flagboolean optional Wenn true festgelegt ist, kann die Markierung gezogen werden.
Rückgabewert:Keine
Legt fest, ob Marker ziehbar ist.
setIcon
setIcon([icon])
Parameter:
Rückgabewert:Keine
Legen Sie das Symbol für Marker fest. MarkerOptions.icon ansehen.
setLabel
setLabel([label])
Parameter:
  • labelstring|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
Stellt das Marker auf der angegebenen Karte oder dem angegebenen Panorama dar. Ist für die Karte null festgelegt, wird die Markierung entfernt.
setOpacity
setOpacity([opacity])
Parameter:
  • opacitynumber optional Eine Zahl zwischen 0,0 (transparent) und 1,0 (undurchsichtig).
Rückgabewert:Keine
Legen Sie die Deckkraft von Marker fest.
setOptions
setOptions(options)
Parameter:
Rückgabewert:Keine
Legen Sie die Optionen für Marker fest.
setPosition
setPosition([latlng])
Parameter:
Rückgabewert:Keine
Legen Sie die Position für Marker fest.
setShape
setShape([shape])
Parameter:
Rückgabewert:Keine
Legt die Form des Marker fest, der für die Interaktion verwendet wird. Weitere Informationen findest du unter MarkerOptions.shape und MarkerShape.
setTitle
setTitle([title])
Parameter:
  • titlestring optional
Rückgabewert:Keine
Legen Sie den Titel der Kurzinfo Marker fest. MarkerOptions.title ansehen.
setVisible
setVisible(visible)
Parameter:
  • visibleboolean Wenn true, ist die Markierung sichtbar
Rückgabewert:Keine
Legen Sie fest, ob Marker sichtbar ist.
setZIndex
setZIndex([zIndex])
Parameter:
  • zIndexnumber optional
Rückgabewert:Keine
Legen Sie den ZIndex von Marker fest. MarkerOptions.zIndex ansehen.
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
animation_changed
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die Animationseigenschaft 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 tritt ein, wenn das DOM-Kontextmenüereignis beim Marker ausgelöst wird.
cursor_changed
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die Cursoreigenschaft Marker ändert.
dblclick
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn auf das Symbol Marker doppelt geklickt wurde.
drag
function(event)
Argumente: 
Dieses Ereignis wird wiederholt ausgelöst, während der Nutzer das Marker-Element verschiebt.
dragend
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn der Nutzer das Ziehen von Marker beendet.
draggable_changed
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die ziehbare Eigenschaft Marker ändert.
dragstart
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn der Nutzer beginnt, Marker zu ziehen.
flat_changed
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die flache Eigenschaft Marker ändert.
icon_changed
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die Symboleigenschaft Marker ändert.
mousedown
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn ein Mauszeiger auf Marker bewegt wird.
mouseout
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn die Maus den Bereich des Symbols Marker verlässt.
mouseover
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn die Maus in den Bereich des Symbols Marker bewegt wird.
mouseup
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn ein Mouseup-Ereignis für Marker ausgelöst wird.
position_changed
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft Marker für die Position ä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 Titeleigenschaft Marker ändert.
visible_changed
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die sichtbare Eigenschaft Marker ändert.
zindex_changed
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich das Attribut „zIndex“ Marker ändert.
rightclick
function(event)
Argumente: 
Dieses Ereignis wird durch einen Rechtsklick auf Marker ausgelöst.

MarkerOptions-Schnittstelle.

google.maps.MarkerOptions-Schnittstelle

MarkerOptions-Objekt, mit dem die Eigenschaften 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
Standardwert: null
Gibt an, welche Animation abgespielt werden soll, wenn der Karte eine Markierung hinzugefügt wird.
clickable optional
Typ:boolean optional
Standardwert: true
Bei true empfängt die Markierung Maus- und Touch-Ereignisse.
BetacollisionBehavior optional
Typ:string|CollisionBehavior optional
Standardwert: null
Konfliktverhalten für Markierungen auf Vektorkarten festlegen
crossOnDrag optional
Typ:boolean optional
Standardwert: true
Wenn false, wird das Kreuz deaktiviert, das beim Ziehen unter der Markierung angezeigt wird.
cursor optional
Typ:string optional
Standardwert: pointer
Mauszeigertyp, der angezeigt wird, wenn der Mauszeiger auf ein Objekt bewegt wird.
draggable optional
Typ:boolean optional
Standardwert: false
Ist der Wert true, kann die Markierung verschoben werden.
icon optional
Typ:string|Icon|Symbol optional
Symbol für den Vordergrund. Wenn ein String angegeben wird, wird er so behandelt, als wäre er ein Icon mit dem String url.
label optional
Typ:string|MarkerLabel optional
Standardwert: 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. Wenn MarkerOptions.title angegeben und nicht angegeben ist, wird der Markierung ein Text für Bedienungshilfen (z.B. zur Verwendung mit Screenreadern) mit dem Text des angegebenen Labels hinzugefügt. Beachten Sie, dass label derzeit nur für Bedienungshilfen-Text für nicht optimierte Markierungen verwendet wird.
map optional
Typ:Map|StreetViewPanorama optional
Karte, auf der die Markierung angezeigt werden soll. Die Karte ist erforderlich, um die Markierung anzuzeigen. Sie kann mit Marker.setMap zur Verfügung gestellt werden, wenn sie bei der Erstellung der Markierung nicht vorhanden ist.
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, da 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 Markierungsoptimierung
position optional
Typ:LatLng|LatLngLiteral optional
Legt die Position der Markierung fest. Eine Markierung kann erstellt, aber erst angezeigt werden, wenn ihre Position festgelegt wurde, zum Beispiel durch die Aktionen oder Auswahlmöglichkeiten eines Nutzers. Mit Marker.setPosition kann eine Markierungsposition angegeben werden, wenn sie beim Erstellen der Markierung nicht angegeben wurde.
shape optional
Typ:MarkerShape optional
Definition des Kartenbildbereichs, der für Verschieben/Klicken verwendet wird.
title optional
Typ:string optional
Standardwert: undefined
Rollover-Text. Falls angegeben, wird der Markierung ein Text für die Barrierefreiheit (z.B. zur Verwendung mit Screenreadern) mit dem angegebenen Wert hinzugefügt. Beachten Sie, dass title derzeit nur für Bedienungshilfen-Text für nicht optimierte Markierungen verwendet wird.
visible optional
Typ:boolean optional
Standardwert: true
Falls 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

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

OPTIONAL_AND_HIDES_LOWER_PRIORITY Zeigen Sie die Markierung nur an, wenn sie sich nicht mit anderen Markierungen überschneidet. Falls sich zwei Markierungen dieses Typs überschneiden, wird die Markierung mit dem höheren zIndex angezeigt. Haben beide denselben zIndex, wird die Markierung mit der niedrigeren vertikalen Bildschirmposition angezeigt.
REQUIRED Die Markierung wird immer angezeigt, auch bei Konflikten mit anderen Markierungen. Das ist das Standardverhalten.
REQUIRED_AND_HIDES_OPTIONAL Die Markierung wird unabhängig von Konflikten mit anderen Markierungen immer angezeigt. OPTIONAL_AND_HIDES_LOWER_PRIORITY-Markierungen oder Labels, die sich mit der Markierung überschneiden würden, werden ausgeblendet.

Symbol-Oberfläche

google.maps.Icon-Schnittstelle

Struktur, die ein Markierungssymbol darstellt.

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 oberen linken Ecke des Symbolbilds, wenn von der Markierung ein Label bereitgestellt wird. Standardmäßig befindet sich der Ursprung im Mittelpunkt des Bildes.
origin optional
Typ:Point optional
Die Position des Bildes innerhalb von einem Sprite, falls vorhanden. Standardmäßig befindet sich der Ursprung in der linken oberen Ecke des Bilds (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.

MarkerLabel-Oberfläche

google.maps.MarkerLabel-Schnittstelle

Mit diesen Optionen wird das Aussehen eines Markierungslabels festgelegt. Ein Markierungslabel ist eine Zeichenfolge (oft aus einem Zeichen), die innerhalb der Markierung angezeigt wird. Wenn du sie mit einer benutzerdefinierten Markierung verwendest, kannst du 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. Schriftfarbe, -größe, -stärke und -familie 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 Übersetzungen und Rotationen), wenn auch das Management von Markierungskonflikten verwendet wird.
color optional
Typ:string optional
Standardwert: 'black'
Die Farbe des Labeltexts.
fontFamily optional
Typ:string optional
Die Schriftfamilie des Labeltexts (entspricht der CSS-Eigenschaft „font-family“).
fontSize optional
Typ:string optional
Standardwert: '14px'
Die Schriftgröße des Labeltexts (entspricht der CSS-Eigenschaft „font-size“).
fontWeight optional
Typ:string optional
Die Schriftstärke des Labeltexts (entspricht der CSS-Eigenschaft „font-weight“).

MarkerShape-Oberfläche

google.maps.MarkerShape-Schnittstelle

Dieses Objekt definiert den anklickbaren Bereich eines Markierungsbilds. Die Form besteht aus den beiden Eigenschaften type und coord, die den nicht transparenten Bereich eines Bildes definieren.

coords
Typ:Array<number>
Das Format dieses Attributs hängt vom Wert von type ab und entspricht der W3-Spezifikation für AREA coords unter http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords.
Das Attribut coords ist ein Array mit Ganzzahlwerten, mit denen die Pixelposition der Form relativ zur oberen linken Ecke des Zielbilds angegeben wird. Die Koordinaten hängen wie folgt vom Wert von type ab:
- circle: coords sind [x1,y1,r],wobei x1, y2 die Koordinaten des Kreismittelpunkts sind und r der Radius des Kreises ist.
- poly: coords wird in der Form [x1,y1,x2,y2...xn,yn] angegeben, wobei jedes x,y-Paar die Koordinaten eines Scheitelpunkts des Polygons enthält.
- rect: coords wird in der Form [x1,y1,x2,y2] angegeben, wobei x1,y1 die Koordinaten der linken oberen Ecke des Rechtecks sind und x2,y2 die Koordinaten der rechten unteren Ecke.
type
Typ:string
Beschreibt den Typ der Form und kann circle, poly oder rect sein.

Symbol-Schnittstelle

google.maps.Symbol-Schnittstelle

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, bei dem es sich um einen integrierten Symbolpfad oder um einen benutzerdefinierten Pfad handelt, der in der SVG-Pfadnotation ausgedrückt wird. Erforderlich.
anchor optional
Typ:Point optional
Standardwert: 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 mit demselben 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 wird standardmäßig „black“ verwendet. Für Symbole auf Polylinien entspricht dies standardmäßig der Strichfarbe der entsprechenden Polylinie.
fillOpacity optional
Typ:number optional
Standardwert: 0
Die Deckkraft der Füllung für das Symbol.
labelOrigin optional
Typ:Point optional
Standardwert: google.maps.Point(0,0)
Der Ursprung des Labels relativ zum Ursprung des Pfads, wenn das Label von der Markierung bereitgestellt wird. Der Ursprung wird mit demselben Koordinatensystem ausgedrückt wie der Pfad des Symbols. Diese Eigenschaft wird für Symbole auf Polylinien nicht verwendet.
rotation optional
Typ:number optional
Standardwert: 0
Der Winkel, um den das Symbol gedreht werden soll, ausgedrückt im Uhrzeigersinn in Grad. Ein Symbol in einer IconSequence, bei dem fixedRotation den Wert false hat, wird relativ zum Winkel des Rands gedreht, an dem es liegt.
scale optional
Typ:number optional
Der Wert, um den die Größe des Symbols skaliert wird. Für Symbolmarkierungen ist die Standardeinstellung 1. Nach der Skalierung kann das Symbol eine beliebige Größe haben. Für Symbole auf Polylinien entspricht dies standardmäßig der Strichstärke der Polylinie. Nach der Skalierung muss das Symbol innerhalb eines Quadrats mit einer Größe 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 wird standardmäßig „black“ verwendet. Für Symbole auf Polylinien entspricht dies standardmäßig der Strichfarbe der Polylinie.
strokeOpacity optional
Typ:number optional
Die Deckkraft des Symbols. Für Symbolmarkierungen ist die Standardeinstellung „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.

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

BACKWARD_CLOSED_ARROW Ein Rückwärtspfeil.
BACKWARD_OPEN_ARROW Ein rückwärts zeigender, offener Pfeil.
CIRCLE Ein Kreis
FORWARD_CLOSED_ARROW Ein Vorwärtspfeil.
FORWARD_OPEN_ARROW Ein Vorwärtspfeil.

Animationskonstanten

google.maps.Animation-Konstanten

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

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

BOUNCE Die Markierung springt zurück, bis die Animation durch Aufrufen von Marker.setAnimation mit null gestoppt wird.
DROP Die Markierung wird vom oberen Kartenrand an 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.