Markierung klasse
google.maps.Marker
Kurs
Diese Klasse erweitert MVCObject
.
Rufe const {Marker} = await google.maps.importLibrary("marker")
auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
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. |
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. |
Methoden | |
---|---|
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 der Markierungspunkt anklickbar ist.Rufen Sie den Klickstatus der Marker ab. |
getCursor |
getCursor() Parameter:Keine
Rückgabewert:
string|null|undefined Den Mauszeigertyp abrufen, der beim Bewegen des Mauszeigers angezeigt wird. |
getDraggable |
getDraggable() Parameter:Keine
Rückgabewert:
boolean „True“, wenn der Markierungspunkt verschiebbar ist.Rufen Sie den Status der Verschiebbarkeit der Marker ab. |
getIcon |
getIcon() Parameter:Keine
Rufen Sie das Symbol der 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 Rufen Sie die Karte oder das Panorama ab, auf der bzw. dem die Marker gerendert wird. |
getOpacity |
getOpacity() Parameter:Keine
Rückgabewert:
number|null|undefined Eine Zahl zwischen 0,0 und 1,0.Deckkraft der Marker abrufen |
getPosition |
getPosition() Parameter:Keine
Rückgabewert:
LatLng|null|undefined Position der Marker abrufen |
getShape |
getShape() Parameter:Keine
Rückgabewert:
MarkerShape|null|undefined Holen Sie sich die Form der Marker , die für die Interaktion verwendet wird. Weitere Informationen finden Sie 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 „Wahr“, wenn die Markierung sichtbar ist.Rufen Sie die Sichtbarkeit der Marker ab. |
getZIndex |
getZIndex() Parameter:Keine
Rückgabewert:
number|null|undefined Z-Index der Markierung.Rufen Sie den Z-Index des Marker ab. MarkerOptions.zIndex ansehen. |
setAnimation |
setAnimation([animation]) Parameter:
Rückgabewert:Keiner
Animation starten. Alle laufenden Animationen werden abgebrochen. Derzeit werden folgende Animationen unterstützt: Animation.BOUNCE , Animation.DROP . Wenn Sie null übergeben, wird jede Animation angehalten. |
setClickable |
setClickable(flag) Parameter:
Rückgabewert:Keiner
Gibt an, ob der Marker anklickbar ist. |
setCursor |
setCursor([cursor]) Parameter:
Rückgabewert:Keiner
Legen Sie den Mauszeigertyp fest, der beim Bewegen des Mauszeigers angezeigt wird. |
setDraggable |
setDraggable(flag) Parameter:
Rückgabewert:Keiner
Legt fest, ob der Marker verschiebbar ist. |
setIcon |
setIcon([icon]) Rückgabewert:Keiner
Legen Sie das Symbol für die Marker fest. MarkerOptions.icon ansehen. |
setLabel |
setLabel([label]) Parameter:
Rückgabewert:Keiner
Legen Sie das Label für die Marker fest. MarkerOptions.label ansehen. |
setMap |
setMap(map) Parameter:
Rückgabewert:Keiner
Rendert die Marker auf der angegebenen Karte oder dem angegebenen Panorama. Wenn „map“ auf null gesetzt ist, wird die Markierung entfernt. |
setOpacity |
setOpacity([opacity]) Parameter:
Rückgabewert:Keiner
Legen Sie die Deckkraft der Marker fest. |
setOptions |
setOptions(options) Parameter:
Rückgabewert:Keiner
Legen Sie die Optionen für die Marker fest. |
setPosition |
setPosition([latlng]) Parameter:
Rückgabewert:Keiner
Legen Sie die Position für die Marker fest. |
setShape |
setShape([shape]) Parameter:
Rückgabewert:Keiner
Legen Sie die Form der Marker fest, die für die Interaktion verwendet wird. Weitere Informationen finden Sie unter MarkerOptions.shape und MarkerShape . |
setTitle |
setTitle([title]) Parameter:
Rückgabewert:Keiner
Legen Sie den Titel der Marker -Kurzinfo fest. MarkerOptions.title ansehen. |
setVisible |
setVisible(visible) Parameter:
Rückgabewert:Keiner
Wird festgelegt, wenn der Marker sichtbar ist. |
setZIndex |
setZIndex([zIndex]) Parameter:
Rückgabewert:Keiner
Legen Sie den Z-Index der Marker fest. MarkerOptions.zIndex ansehen. |
Übernommen:addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Ereignisse | |
---|---|
animation_changed |
function() Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die Marker -Animationseigenschaft ä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 Property Marker ändert. |
contextmenu |
function(event) Argumente:
Dieses Ereignis wird ausgelöst, wenn das DOM-Ereignis „contextmenu“ auf dem Marker |
cursor_changed |
function() Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die Cursor-Property 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 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 das Attribut „dragable“ von 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 die Marker -Symbol-Property ändert. |
mousedown |
function(event) Argumente:
Dieses Ereignis wird ausgelöst, wenn auf die Marker geklickt 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 den Bereich des Marker -Symbols betritt. |
mouseup |
function(event) Argumente:
Dieses Ereignis wird ausgelöst, wenn die Maus auf dem Marker bewegt wird. |
position_changed |
function() Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die Position der 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 von 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 Z-Index-Eigenschaft Marker ändert. |
|
function(event) Argumente:
Dieses Ereignis wird ausgelöst, wenn Sie mit der rechten Maustaste auf das Marker klicken. |
MarkerOptions-Schnittstelle
google.maps.MarkerOptions
Benutzeroberfläche
Mit dem MarkerOptions-Objekt werden die Properties definiert, die für eine Markierung festgelegt werden können.
Attribute | |
---|---|
anchorPoint optional |
Typ:
Point optional Der Abstand 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 Wenn true festgelegt ist, empfängt die Markierung Maus- und Touch-Ereignisse. |
|
Typ:
string|CollisionBehavior optional Standard:
null Konfliktverhalten für Markierungen auf Vektorkarten festlegen |
crossOnDrag optional |
Typ:
boolean optional Standard:
true Bei false wird das Kreuz deaktiviert, das beim Ziehen unter der Markierung angezeigt wird. |
cursor optional |
Typ:
string optional Standard:
pointer Art des Mauszeigers, der beim Bewegen des Mauszeigers angezeigt wird. |
draggable optional |
Typ:
boolean optional Standard:
false Bei true kann die Markierung verschoben werden. |
icon optional |
Symbol für den Vordergrund. Wenn ein String angegeben wird, wird er als Icon mit dem String als url behandelt. |
label optional |
Typ:
string|MarkerLabel optional Standard:
null Fügen Sie 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 ein Label angegeben ist und MarkerOptions.title nicht, wird der Markierung ein barrierefreier Text (z.B. für die Verwendung mit Screenreadern) mit dem Text des angegebenen Labels hinzugefügt. Hinweis: Das Symbol 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, damit die Markierung angezeigt werden kann. Sie kann mit Marker.setMap angegeben werden, wenn sie beim Erstellen der Markierung nicht 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 Markierungsoptimierung |
position optional |
Typ:
LatLng|LatLngLiteral optional Hiermit wird die Position der Markierung festgelegt. Eine Markierung kann erstellt werden, wird aber erst angezeigt, wenn ihre Position angegeben wurde, z. B. durch die Aktionen oder Auswahl eines Nutzers. Die Position einer Markierung 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. Wenn Sie einen Wert angeben, wird der Markierung ein barrierefreier Text (z.B. für die Verwendung mit Screenreadern) hinzugefügt. Hinweis: Das Symbol 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
constants
Rufe const {CollisionBehavior} = await google.maps.importLibrary("marker")
auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
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 Z-Index 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-Oberfläche
google.maps.Icon
Benutzeroberfläche
Eine Struktur, die ein Bild für ein Markierungssymbol darstellt.
Attribute | |
---|---|
url |
Typ:
string Die URL des Bildes oder Sprite-Blattes. |
anchor optional |
Typ:
Point optional Die Position, an der ein Bild an 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, sofern für die Markierung ein Label angegeben ist. 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 links oben im Bild (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-Schnittstelle
google.maps.MarkerLabel
Benutzeroberfläche
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.
Attribute | |
---|---|
text |
Typ:
string Der Text, der im Label angezeigt werden soll. |
className optional |
Typ:
string optional Standard:
'' (leerer String)Die Eigenschaft „className“ des Labels (entspricht dem Attribut „class“ des Elements). Es können mehrere CSS-Klassen hinzugefügt werden, die durch Leerzeichen getrennt sind. 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. durch Verschiebungen und Drehungen), wenn auch die Markierungskollisionen verwaltet werden. |
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 der CSS-Eigenschaft „font-size“). |
fontWeight optional |
Typ:
string optional Die Schriftstärke des Labeltexts (entspricht der CSS-Eigenschaft „font-weight“). |
MarkerShape-Schnittstelle
google.maps.MarkerShape
Benutzeroberfläche
Dieses Objekt definiert den anklickbaren Bereich eines Markierungsbilds. Die Form besteht aus zwei Eigenschaften – type
und coord
–, die den nicht transparenten Bereich eines Bildes definieren.
Attribute | |
---|---|
coords |
Typ:
Array<number> Das Format dieses Attributs hängt vom Wert von type ab und entspricht der W3 AREA coords -Spezifikation unter http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. Das Attribut coords ist ein Array von Ganzzahlen, das die Pixelposition der Form relativ zur linken oberen Ecke des Zielbilds angibt. Die Koordinaten hängen 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 sind. - 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. |
type |
Typ:
string Beschreibt den Typ der Form und kann circle , poly oder rect sein. |
Symbol-Oberfläche
google.maps.Symbol
Benutzeroberfläche
Beschreibt ein Symbol, das aus einem Vektorpfad mit Stil besteht. Ein Symbol kann als Symbol einer Markierung verwendet oder auf einer Polylinie platziert werden.
Attribute | |
---|---|
path |
Typ:
SymbolPath|string Der Pfad des Symbols, ein vordefinierter Symbolpfad oder ein benutzerdefinierter Pfad, der in der 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 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 = false ist, wird relativ zum Winkel des Randes gedreht, an dem es liegt. |
scale optional |
Typ:
number optional Der Wert für die Skalierung der Symbolgröße. Für Symbolmarkierungen ist dies standardmäßig „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 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 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 Standard:Die
Symbol.scale des Symbols.Die Strichstärke des Symbols. |
SymbolPath-Konstanten
google.maps.SymbolPath
constants
Integrierte Symbolpfade
Rufe const {SymbolPath} = await google.maps.importLibrary("core")
auf, um auf die Daten zuzugreifen. 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 geschlossener Pfeil, der nach vorne zeigt. |
FORWARD_OPEN_ARROW |
Ein nach vorne zeigender offener Pfeil. |
Animation konstanten
google.maps.Animation
constants
Animationen, die auf einer Markierung abgespielt werden können. Verwenden Sie die Methode Marker.setAnimation
für Markierungen oder die Option MarkerOptions.animation
, um eine Animation abzuspielen.
Rufe const {Animation} = await google.maps.importLibrary("marker")
auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
BOUNCE |
Die Markierung springt, 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 wird auf null zurückgesetzt. Diese Art von Animation wird normalerweise bei der Erstellung der Markierung definiert. |