Marker (legacy)

Klasse Marker

Klasse google.maps.Marker

Diese Klasse erweitert MVCObject.

Zugriff durch Aufrufen von const {Marker} = await google.maps.importLibrary("marker").
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 ausgeführte Animation ab.
getClickable
getClickable()
Parameter: Keine
Rückgabewert: boolean „True“, wenn die Markierung anklickbar ist.
Klickbarkeitsstatus der Marker abrufen
getCursor
getCursor()
Parameter: Keine
Rückgabewert: string|null|undefined
Ruft den Typ des Mauszeigers ab, der beim Bewegen des Mauszeigers angezeigt wird.
getDraggable
getDraggable()
Parameter: Keine
Rückgabewert:  boolean „True“, wenn die Markierung ziehbar ist.
Ruft den Ziehbarkeitsstatus des Marker ab.
getIcon
getIcon()
Parameter: Keine
Rückgabewert: string|Icon|Symbol|null|undefined
Rufen Sie das Symbol für Marker ab. MarkerOptions.icon ansehen.
getLabel
getLabel()
Parameter: Keine
Rückgabewert: MarkerLabel|string|null|undefined
Rufen Sie das Label des Marker ab. MarkerOptions.label ansehen.
getMap
getMap()
Parameter: Keine
Rückgabewert: Map|StreetViewPanorama|null
Ruft die Karte oder das Panorama ab, auf dem das Marker gerendert wird.
getOpacity
getOpacity()
Parameter: Keine
Rückgabewert:  number|null|undefined Eine Zahl zwischen 0,0 und 1,0.
Ruft die Deckkraft des Marker ab.
getPosition
getPosition()
Parameter: Keine
Rückgabewert: LatLng|null|undefined
Rufen Sie die Position des Marker ab.
getShape
getShape()
Parameter: Keine
Rückgabewert: MarkerShape|null|undefined
Ruft die Form des Marker ab, der für die Interaktion verwendet wird. Siehe MarkerOptions.shape und MarkerShape.
getTitle
getTitle()
Parameter: Keine
Rückgabewert: string|null|undefined
Ruft den Titel des Kurzinfos Marker 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 zIndex des Marker ab. MarkerOptions.zIndex ansehen.
setAnimation
setAnimation([animation])
Parameter: 
  • animation:  Animation optional Die Animation, die abgespielt werden soll.
Rückgabewert: Keiner
Animation starten. Alle laufenden Animationen werden abgebrochen. Derzeit unterstützte Animationen: Animation.BOUNCE, Animation.DROP. Wenn Sie null übergeben, wird die Animation beendet.
setClickable
setClickable(flag)
Parameter: 
  • flag:  boolean Wenn true festgelegt ist, kann auf die Markierung geklickt werden.
Rückgabewert: Keiner
Legen Sie fest, ob die Marker anklickbar ist.
setCursor
setCursor([cursor])
Parameter: 
  • cursor:  string optional Mauszeigertyp.
Rückgabewert: Keiner
Legt den Mauszeigertyp fest, der beim Bewegen des Mauszeigers angezeigt wird.
setDraggable
setDraggable(flag)
Parameter: 
  • flag:  boolean optional Wenn true festgelegt ist, kann die Markierung gezogen werden.
Rückgabewert: Keiner
Legt fest, ob die Marker ziehbar ist.
setIcon
setIcon([icon])
Parameter: 
Rückgabewert: Keiner
Legen Sie das Symbol für Marker fest. MarkerOptions.icon ansehen.
setLabel
setLabel([label])
Parameter: 
Rückgabewert: Keiner
Legen Sie das Label für Marker fest. MarkerOptions.label ansehen.
setMap
setMap(map)
Parameter: 
Rückgabewert: Keiner
Rendert das Marker auf der angegebenen Karte oder im angegebenen Panorama. Wenn „map“ auf null gesetzt ist, wird die Markierung entfernt.
setOpacity
setOpacity([opacity])
Parameter: 
  • opacity:  number optional Eine Zahl zwischen 0,0 (transparent) und 1,0 (undurchsichtig).
Rückgabewert: Keiner
Legen Sie die Deckkraft des Marker fest.
setOptions
setOptions(options)
Parameter: 
Rückgabewert: Keiner
Legen Sie die Optionen für Marker fest.
setPosition
setPosition([latlng])
Parameter: 
Rückgabewert: Keiner
Legen Sie die Position für Marker fest.
setShape
setShape([shape])
Parameter: 
Rückgabewert: Keiner
Legt die Form des Marker fest, der für die Interaktion verwendet wird. Siehe MarkerOptions.shape und MarkerShape.
setTitle
setTitle([title])
Parameter: 
  • title:  string optional
Rückgabewert: Keiner
Legen Sie den Titel des Kurzinfos Marker fest. MarkerOptions.title ansehen.
setVisible
setVisible(visible)
Parameter: 
  • visible:  boolean Wenn true festgelegt ist, ist die Markierung sichtbar.
Rückgabewert: Keiner
Wird festgelegt, wenn die Marker sichtbar ist.
setZIndex
setZIndex([zIndex])
Parameter: 
  • zIndex:  number optional
Rückgabewert: Keiner
Legen Sie den zIndex des 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 Eigenschaft Marker ändert.
contextmenu
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn das DOM-Kontextmenü-Ereignis für das Marker ausgelöst wird.
cursor_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Cursor-Eigenschaft Marker ändert.
dblclick
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn auf das Symbol Marker doppelgeklickt wurde.
drag
function(event)
Argumente: 
Dieses Ereignis wird wiederholt ausgelöst, während der Nutzer das Marker zieht.
dragend
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn der Nutzer das Ziehen des Marker beendet.
draggable_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Ziehbarkeit (Marker) ändert.
dragstart
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn der Nutzer beginnt, das 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 die Symboleigenschaft Marker ändert.
mousedown
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn die Maustaste auf dem Marker gedrückt wird.
mouseout
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn der Mauszeiger den Bereich des Marker-Symbols verlässt.
mouseover
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn der Mauszeiger in den Bereich des Symbols Marker bewegt wird.
mouseup
function(event)
Argumente: 
Dieses Ereignis wird ausgelöst, wenn die Maustaste auf dem Marker losgelassen 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 Titeleigenschaft Marker ändert.
visible_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Sichtbarkeitseigenschaft Marker ändert.
zindex_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Marker-Eigenschaft „zIndex“ ändert.
rightclick
function(event)
Argumente: 
Dieses Ereignis wird bei einem Rechtsklick auf das Marker-Objekt ausgelöst.

MarkerOptions-Schnittstelle

Schnittstelle google.maps.MarkerOptions

MarkerOptions-Objekt, mit dem die Eigenschaften definiert werden, die für einen Marker festgelegt werden können.
anchorPoint optional
Typ: Point optional
Der Abstand von der Position der Markierung zur Spitze eines InfoWindow, 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
Wenn true festgelegt ist, empfängt die Markierung Maus- und Touch-Events.
BetacollisionBehavior optional
Typ: string|CollisionBehavior optional
Standard: null
Konfliktverhalten für Markierungen auf Vektorkarten konfigurieren
crossOnDrag optional
Typ: boolean optional
Standard: true
Wenn false, wird das Kreuz deaktiviert, das beim Ziehen unter der Markierung angezeigt wird.
cursor optional
Typ: string optional
Standard: pointer
Der Mauszeigertyp, der angezeigt werden soll, wenn der Mauszeiger auf ein Objekt bewegt wird.
draggable optional
Typ: boolean optional
Standard: false
Wenn true, kann die Markierung gezogen werden. Hinweis: Wenn Sie diese Option auf true setzen, kann die Markierung auch dann angeklickt werden, wenn clickable auf false gesetzt ist.
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 als 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. Wenn MarkerOptions.title nicht angegeben ist, wird der Markierung ein Text für Bedienungshilfen (z.B. für Screenreader) mit dem Text des angegebenen Labels hinzugefügt. Der label wird derzeit nur für barrierefreien Text für nicht optimierte Markierungen verwendet.
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 angegeben werden, wenn sie nicht beim Erstellen der Markierung angegeben wurde.
opacity optional
Typ: number optional
Standardwert: 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 Markierungsoptimierung Hinweis: Diese Optimierung hat keine Auswirkungen auf Markierungen auf Vektorkarten.
position optional
Typ: LatLng|LatLngLiteral optional
Legt die Position der Markierung fest. Eine Markierung kann erstellt, aber erst angezeigt werden, wenn ihre Position angegeben wurde, z. B. durch die Aktionen oder Auswahlmöglichkeiten eines Nutzers. Eine Markierungsposition kann mit Marker.setPosition angegeben werden, wenn sie nicht beim Erstellen der Markierung 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 ein Text für Bedienungshilfen (z.B. für Screenreader) mit dem angegebenen Wert hinzugefügt. Der title wird derzeit nur für barrierefreien Text 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

Zugriff durch Aufrufen von const {CollisionBehavior} = await google.maps.importLibrary("marker").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
OPTIONAL_AND_HIDES_LOWER_PRIORITY Die Markierung wird nur dann 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. Falls beide denselben zIndex haben, wird die Markierung 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 wird unabhängig von Konflikten mit anderen Markierungen immer angezeigt. OPTIONAL_AND_HIDES_LOWER_PRIORITY-Markierungen oder Labels, die sich mit ihr überschneiden würden, werden ausgeblendet.

Symbol-Schnittstelle

Schnittstelle google.maps.Icon

Eine Struktur, die ein Markierungssymbolbild 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 ein Label von der Markierung bereitgestellt wird. Standardmäßig befindet sich der Ursprung in der Mitte 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 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

Mit diesen Optionen wird die Darstellung eines Markierungslabels festgelegt. Ein Markierungslabel ist ein String (häufig ein einzelnes Zeichen), der innerhalb der Markierung angezeigt wird. Wenn Sie es mit einer benutzerdefinierten Markierung verwenden, können Sie es mit der Property 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)
Das className-Attribut des Label-Elements (entspricht dem class-Attribut 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 Attribute von MarkerLabel festgelegt werden. CSS-Klassen sollten nicht verwendet werden, um die Position oder Ausrichtung des Labels zu ändern (z.B. durch Translationen und Rotationen), wenn auch die Verwaltung 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 CSS-Eigenschaft „font-family“).
fontSize optional
Typ: string optional
Standard: '14px'
Die Schriftgröße des Labeltexts (entspricht dem CSS-Attribut „font-size“).
fontWeight optional
Typ: string optional
Die Schriftstärke des Labeltexts (entspricht dem CSS-Attribut „font-weight“).

MarkerShape-Schnittstelle

Schnittstelle google.maps.MarkerShape

Dieses Objekt definiert den anklickbaren Bereich eines Markierungsbilds. Die Form besteht aus zwei Attributen, type und coord, die den nicht transparenten Bereich eines Bildes definieren.
type
Typ: string
Beschreibt den Typ der Form. Mögliche Werte sind circle, poly oder rect.
coords optional
Typ: Array<number> optional
Das Format dieses Attributs hängt vom Wert des type ab und entspricht der W3-Spezifikation AREA coords unter http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords.
Das Attribut coords ist ein Array von Ganzzahlen, die die Pixelposition der Form relativ zur oberen linken Ecke des Zielbilds angeben. Die Koordinaten hängen folgendermaßen vom Wert von type ab:
  – circle: „coords“ ist [x1,y1,r], wobei x1, y2 die Koordinaten des Mittelpunkts des Kreises und r der Radius des Kreises ist.
  - poly: coords ist [x1,y1,x2,y2...xn,yn], wobei jedes x,y-Paar die Koordinaten eines Eckpunkts des Polygons enthält.
  - rect: coords ist [x1,y1,x2,y2], wobei x1,y1 die Koordinaten der oberen linken Ecke des Rechtecks und x2,y2 die Koordinaten der unteren rechten Ecke des Rechtecks sind.

Symbol-Schnittstelle

Schnittstelle google.maps.Symbol

Beschreibt ein Symbol, das aus einem Vektorpfad mit Stil besteht. Ein Symbol kann als Icon einer Markierung verwendet oder auf einer Polylinie platziert werden.
path
Typ: SymbolPath|string
Der Pfad des Symbols, der ein integrierter Symbolpfad oder ein benutzerdefinierter Pfad in der SVG-Pfadnotation ist. 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 die Standardfarbe der Strichfarbe der jeweiligen Polylinie.
fillOpacity optional
Typ: number optional
Standard: 0
Die Deckkraft der Füllung 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 bereitgestellt wird. Der Ursprung wird im selben Koordinatensystem ausgedrückt wie der Pfad des Symbols. Diese Property wird für Symbole auf Polylinien 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 einer IconSequence, bei der fixedRotation den Wert false hat, wird relativ zum Winkel des Rands gedreht, an dem es liegt.
scale optional
Typ: number optional
Der Wert für die Skalierung der Symbolgröße. Für Symbolmarkierungen ist der Standardwert „1“. Nach der Skalierung kann das Symbol eine beliebige Größe haben. Für Symbole auf einer Polylinie entspricht die Standardskalierung der Strichstärke der entsprechenden Polylinie. Nach der Skalierung muss das Symbol innerhalb eines Quadrats von 22 Pixel 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 entspricht die Standardfarbe der Strichfarbe der Polylinie.
strokeOpacity optional
Typ: number optional
Die Deckkraft des Strichs des Symbols. Für Symbolmarkierungen ist der Standardwert „1“. Für Symbole auf Polylinien entspricht der Standardwert der Strichdeckkraft der Polylinie.
strokeWeight optional
Typ: number optional
Standardwert: Der Symbol.scale-Wert des Symbols.
Die Strichstärke des Symbols.

SymbolPath-Konstanten

google.maps.SymbolPath-Konstanten

Integrierte Symbolpfade.

Zugriff durch Aufrufen von const {SymbolPath} = await google.maps.importLibrary("core").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
BACKWARD_CLOSED_ARROW Ein Rückwärtspfeil, der auf allen Seiten geschlossen ist
BACKWARD_OPEN_ARROW Ein Rückwärtspfeil, der auf einer Seite offen ist
CIRCLE Ein Kreis
FORWARD_CLOSED_ARROW Ein geschlossener Vorwärtspfeil.
FORWARD_OPEN_ARROW Ein Vorwärtspfeil, der auf einer Seite offen ist

Animation-Konstanten

google.maps.Animation-Konstanten

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

Zugriff durch Aufrufen von const {Animation} = await google.maps.importLibrary("marker").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
BOUNCE Die Markierung springt, bis die Animation durch Aufrufen von Marker.setAnimation mit null beendet 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 wird auf null zurückgesetzt. Diese Art von Animation wird normalerweise bei der Erstellung der Markierung definiert.