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.

Konstruktor
Marker	Marker([opts]) Parameter: opts:  MarkerOptions optional. Benannte optionale Argumente 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.

Methoden
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|null|Symbol|undefined Rufen Sie das Symbol von Marker ab. MarkerOptions.icon ansehen.
getLabel	getLabel() Parameter:Keine Rückgabewert:  MarkerLabel|null|string|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: icon:  string|Icon|Symbol optional 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: map:  Map|StreetViewPanorama 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: options:  MarkerOptions Rückgabewert: Keine Legen Sie die Optionen für Marker fest.
setPosition	setPosition([latlng]) Parameter: latlng:  LatLng|LatLngLiteral optional Die neue Position. Rückgabewert: Keine Legt den Satz für Marker fest.
setShape	setShape([shape]) Parameter: shape:  MarkerShape optional 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

Konstanten
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.

Veranstaltungen
animation_changed	function() Argumente: Keine Dieses Ereignis wird ausgelöst, wenn sich die Animationseigenschaft von Marker ändert.
click	function(event) Argumente:  event:  MapMouseEvent 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:  event:  MapMouseEvent 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:  event:  MapMouseEvent Dieses Ereignis wird ausgelöst, wenn das Symbol Marker doppelt angeklickt wurde.
drag	function(event) Argumente:  event:  MapMouseEvent Dieses Ereignis wird wiederholt ausgelöst, während der Nutzer die Marker zieht.
dragend	function(event) Argumente:  event:  MapMouseEvent 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:  event:  MapMouseEvent 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:  event:  MapMouseEvent Dieses Ereignis wird ausgelöst, wenn bei Marker ein Mousedown ausgelöst wird.
mouseout	function(event) Argumente:  event:  MapMouseEvent Dieses Ereignis wird ausgelöst, wenn die Maus den Bereich des Marker-Symbols verlässt.
mouseover	function(event) Argumente:  event:  MapMouseEvent Dieses Ereignis wird ausgelöst, wenn die Maus in den Bereich des Symbols Marker gelangt.
mouseup	function(event) Argumente:  event:  MapMouseEvent 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	Verworfen: Verwenden Sie stattdessen das Ereignis Marker.contextmenu, um Nutzungsmuster wie Strg-Klick unter macOS zu unterstützen. function(event) Argumente:  event:  MapMouseEvent 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.

Attribute
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.
collisionBehavior optional	Hinweis: Nur im Kanal „v=beta“ verfügbar. 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.

Konstanten
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.

Attribute
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.

Attribute
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.

Attribute
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.

Attribute
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.

Konstanten
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.

Konstanten
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.