Marker-Klasse
google.maps.Marker
Klasse
Diese Klasse erweitert MVCObject.
Zugriff durch Anrufen von const {Marker} = await google.maps.importLibrary("marker").
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|undefinedDie aktuell laufende Animation abrufen. |
getClickable |
getClickable()Parameter:Keine
Rückgabewert:
boolean „True“, wenn der Marker anklickbar ist.Klickbaren Status der Marker abrufen |
getCursor |
getCursor()Parameter:Keine
Rückgabewert:
string|null|undefinedRufen Sie den Mauszeigertyp ab, der beim Bewegen des Mauszeigers auf ein Objekt angezeigt wird. |
getDraggable |
getDraggable()Parameter:Keine
Rückgabewert:
boolean „True“, wenn die Markierung gezogen werden kann.Rufen Sie den Status der Ziehbarkeit des 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|undefinedRufen Sie das Label des Marker ab. MarkerOptions.label ansehen. |
getMap |
getMap()Parameter:Keine
Rückgabewert:
Map|StreetViewPanoramaRuft die Karte oder das Panorama ab, auf dem Marker gerendert wird. |
getOpacity |
getOpacity()Parameter:Keine
Rückgabewert:
number|null|undefined Eine Zahl zwischen 0,0 und 1,0.Rufen Sie die Deckkraft des Marker ab. |
getPosition |
getPosition()Parameter:Keine
Rückgabewert:
LatLng|null|undefinedRufen Sie die Position des Marker ab. |
getShape |
getShape()Parameter:Keine
Rückgabewert:
MarkerShape|null|undefinedRuft die Form des Marker ab, die für die Interaktion verwendet wird. Weitere Informationen finden Sie unter MarkerOptions.shape und MarkerShape. |
getTitle |
getTitle()Parameter:Keine
Rückgabewert:
string|null|undefinedRufen Sie den Titel der Marker-Kurzinfo ab. MarkerOptions.title ansehen. |
getVisible |
getVisible()Parameter:Keine
Rückgabewert:
boolean „True“, wenn die Markierung sichtbar ist.Ruft die Sichtbarkeit des Marker ab. |
getZIndex |
getZIndex()Parameter:Keine
Rückgabewert:
number|null|undefined zIndex des Markers.Rufen Sie den zIndex von Marker ab. MarkerOptions.zIndex ansehen. |
setAnimation |
setAnimation([animation])Parameter:
Rückgabewert:Keiner
Animation starten. Alle laufenden Animationen werden abgebrochen. Derzeit werden die folgenden Animationen unterstützt: Animation.BOUNCE, Animation.DROP. Wenn Sie null übergeben, wird jede Animation beendet. |
setClickable |
setClickable(flag)Parameter:
Rückgabewert:Keiner
Legen Sie fest, ob das Marker anklickbar ist. |
setCursor |
setCursor([cursor])Parameter:
Rückgabewert:Keiner
Legt den Mauszeigertyp fest, der beim Hovern angezeigt wird. |
setDraggable |
setDraggable(flag)Parameter:
Rückgabewert:Keiner
Legen Sie fest, ob das Marker gezogen werden kann. |
setIcon |
setIcon([icon])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 die Marker auf der angegebenen Karte oder dem angegebenen Panorama. Wenn die Karte auf null gesetzt ist, wird die Markierung entfernt. |
setOpacity |
setOpacity([opacity])Parameter:
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
Legen Sie die Form des Marker fest, das 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 des Marker-Kurzinfos fest. MarkerOptions.title ansehen. |
setVisible |
setVisible(visible)Parameter:
Rückgabewert:Keiner
Gibt an, ob Marker sichtbar ist. |
setZIndex |
setZIndex([zIndex])Parameter:
Rückgabewert:Keiner
Legen Sie den zIndex von Marker fest. MarkerOptions.zIndex ansehen. |
Geerbt:addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |
Ereignisse | |
|---|---|
animation_changed |
function()Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die Marker-Animations-Property ä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 Property Marker ändert. |
contextmenu |
function(event)Argumente:
Dieses Ereignis wird ausgelöst, wenn das DOM-Ereignis „contextmenu“ für Marker ausgelöst wird. |
cursor_changed |
function()Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die Cursor-Eigenschaft von 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 von Marker beendet. |
draggable_changed |
function()Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die Marker-Eigenschaft ä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 Marker-Property ä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 das 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 in den Bereich des Marker-Symbols bewegt wird. |
mouseup |
function(event)Argumente:
Dieses Ereignis wird für ein „mouseup“-Ereignis auf dem Marker ausgelöst. |
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 Form-Property Marker ändert. |
title_changed |
function()Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die Titel-Property von Marker ä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 Marker-Eigenschaft ändert. |
|
function(event)Argumente:
Dieses Ereignis wird ausgelöst, wenn mit der rechten Maustaste auf Marker geklickt wird. |
MarkerOptions-Schnittstelle
google.maps.MarkerOptions-Schnittstelle
MarkerOptions-Objekt zum Definieren der Eigenschaften, die für einen Marker festgelegt werden können.
Attribute | |
|---|---|
anchorPoint optional |
Typ:
Point optionalDer Abstand von der Position der Markierung bis zur Spitze eines Infofensters, das mit der Markierung als Anker geöffnet wurde. |
animation optional |
Typ:
Animation optionalStandard:
nullGibt an, welche Animation abgespielt werden soll, wenn der Karte eine Markierung hinzugefügt wird. |
clickable optional |
Typ:
boolean optionalStandard:
trueWenn true festgelegt ist, empfängt die Markierung Maus- und Touch-Ereignisse. |
|
Typ:
string|CollisionBehavior optionalStandard:
nullKonfliktverhalten für Markierungen auf Vektorkarten festlegen |
crossOnDrag optional |
Typ:
boolean optionalStandard:
trueWenn false, wird das Kreuz deaktiviert, das beim Ziehen unter der Markierung angezeigt wird. |
cursor optional |
Typ:
string optionalStandard:
pointerDer Mauszeigertyp, der angezeigt werden soll, wenn der Mauszeiger auf ein Objekt bewegt wird. |
draggable optional |
Typ:
boolean optionalStandard:
falseBei true kann die Markierung gezogen werden. Hinweis:Wenn Sie diese Einstellung auf true setzen, ist der Marker auch dann anklickbar, wenn clickable auf false gesetzt ist. |
icon 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 optionalStandard:
nullFü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 angegeben und MarkerOptions.title nicht angegeben ist, wird der Markierung mit dem Text des angegebenen Labels ein Bedienungshilfen-Text (z.B. für die Verwendung mit Screenreadern) hinzugefügt. Beachten Sie, dass label derzeit nur für barrierefreien Text für nicht optimierte Markierungen verwendet wird. |
map optional |
Typ:
Map|StreetViewPanorama optionalKarte, 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 optionalStandard: 1.0
Eine Zahl zwischen 0,0 (transparent) und 1,0 (undurchsichtig). |
optimized optional |
Typ:
boolean optionalDurch 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 Marker-Optimierung Hinweis:Diese Optimierung hat keine Auswirkungen auf Markierungen auf Vektorkarten. |
position optional |
Typ:
LatLng|LatLngLiteral optionalLegt die Position der Markierung fest. Eine Markierung kann erstellt, aber erst angezeigt werden, wenn ihre Position angegeben wird, z. B. durch Aktionen oder Entscheidungen eines Nutzers. Eine Markierungsposition kann mit Marker.setPosition angegeben werden, wenn sie nicht beim Erstellen der Markierung angegeben wurde. |
shape optional |
Typ:
MarkerShape optionalDefinition des Kartenbildbereichs, der für Verschieben/Klicken verwendet wird. |
title optional |
Typ:
string optionalStandard:
undefinedRollover-Text. Falls angegeben, wird der Markierung ein barrierefreier Text (z.B. für die Verwendung mit Screenreadern) mit dem angegebenen Wert hinzugefügt. Beachten Sie, dass title derzeit nur für barrierefreien Text für nicht optimierte Markierungen verwendet wird. |
visible optional |
Typ:
boolean optionalStandard:
trueBei true ist die Markierung sichtbar. |
zIndex optional |
Typ:
number optionalSä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 Anrufen von const {CollisionBehavior} = await google.maps.importLibrary("marker").
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 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
google.maps.Icon-Schnittstelle
Eine Struktur, die ein Symbolbild für eine Markierung darstellt.
Attribute | |
|---|---|
url |
Typ:
stringDie URL des Bildes oder Sprite-Blattes. |
anchor optional |
Typ:
Point optionalDie Position, an der ein Bild in Bezug auf die 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 optionalDer Ursprung des Labels relativ zur oberen linken Ecke des Symbols, wenn ein Label vom Marker bereitgestellt wird. Standardmäßig befindet sich der Ursprung in der Mitte des Bildes. |
origin optional |
Typ:
Point optionalDie 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 optionalDie 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 optionalDie 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-Schnittstelle
Mit diesen Optionen wird die Darstellung eines Markierungs-Labels festgelegt. Ein Markierungslabel ist ein String (oft ein einzelnes Zeichen), der in der Markierung angezeigt wird. Wenn Sie es mit einer benutzerdefinierten Markierung verwenden, können Sie es mit der Eigenschaft labelOrigin in der Klasse Icon neu positionieren.
Attribute | |
|---|---|
text |
Typ:
stringDer Text, der im Label angezeigt werden soll. |
className optional |
Typ:
string optionalStandard:
'' (leerer String)Die className-Eigenschaft des Labels (entspricht dem class-Attribut des Elements). Es können mehrere durch Leerzeichen getrennte CSS-Klassen hinzugefügt werden. Die 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 Übersetzungen und Drehungen), wenn auch die Verwaltung von Markerkollisionen verwendet wird. |
color optional |
Typ:
string optionalStandard:
'black'Die Farbe des Labeltexts. |
fontFamily optional |
Typ:
string optionalDie Schriftfamilie des Labeltexts (entspricht der CSS-Eigenschaft „font-family“). |
fontSize optional |
Typ:
string optionalStandard:
'14px'Die Schriftgröße des Labeltexts (entspricht der CSS-Eigenschaft „font-size“). |
fontWeight optional |
Typ:
string optionalDie Schriftstärke des Labeltexts (entspricht der CSS-Eigenschaft „font-weight“). |
MarkerShape-Schnittstelle
google.maps.MarkerShape-Schnittstelle
Dieses Objekt definiert den klickbaren Bereich eines Markierungsbilds. Die Form besteht aus zwei Attributen: type und coord. Sie definieren den nicht transparenten Bereich eines Bildes.
Attribute | |
|---|---|
type |
Typ:
stringBeschreibt den Typ der Form und kann circle, poly oder rect sein. |
coords optional |
Typ:
Array<number> optionalDas Format dieses Attributs hängt vom Wert von type ab und entspricht der W3 AREA-Spezifikation coords 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 oberen linken Ecke des Zielbildes angibt. Die Koordinaten hängen vom Wert von type ab: – circle: „coords“ ist [x1,y1,r],wobei x1, y2 die Koordinaten des Kreismittelpunkts 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. |
Symbol-Schnittstelle
google.maps.Symbol-Schnittstelle
Beschreibt ein Symbol, das aus einem Vektorpfad mit Formatierung besteht. Ein Symbol kann als Symbol für eine Markierung verwendet oder auf einer Polylinie platziert werden.
Attribute | |
|---|---|
path |
Typ:
SymbolPath|stringDer Pfad des Symbols, der ein integrierter Symbolpfad oder ein benutzerdefinierter Pfad in SVG-Pfadnotation ist. Erforderlich. |
anchor optional |
Typ:
Point optionalStandard:
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 optionalDie 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 optionalStandard:
0Die Deckkraft der Füllung des Symbols. |
labelOrigin optional |
Typ:
Point optionalStandard:
google.maps.Point(0,0)Der Ursprung des Labels relativ zum Ursprung des Pfads, wenn das Label vom Marker 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 optionalStandard:
0Der Winkel, um den das Symbol gedreht werden soll. Der Wert wird im Uhrzeigersinn in Grad ausgedrückt. Ein Symbol in einem IconSequence, wobei fixedRotation gleich false ist, wird relativ zum Winkel des Rands gedreht, an dem es liegt. |
scale optional |
Typ:
number optionalDer 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 der Standardwert der Strichstärke der Polylinie. Nach der Skalierung muss das Symbol innerhalb eines Quadrats von 22 × 22 Pixel liegen, dessen Mittelpunkt der Anker des Symbols ist. |
strokeColor optional |
Typ:
string optionalDie 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 der Standardwert der Strichfarbe der Polylinie. |
strokeOpacity optional |
Typ:
number optionalDie 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 optionalStandard:Der
Symbol.scale-Wert des Symbols.Die Strichstärke des Symbols. |
SymbolPath-Konstanten
google.maps.SymbolPath
Konstanten
Integrierte Symbolpfade.
Zugriff durch Anrufen von const {SymbolPath} = await google.maps.importLibrary("core").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
|---|---|
BACKWARD_CLOSED_ARROW |
Ein geschlossener Pfeil, der nach links zeigt |
BACKWARD_OPEN_ARROW |
Ein offener Pfeil, der nach links zeigt. |
CIRCLE |
Ein Kreis |
FORWARD_CLOSED_ARROW |
Ein geschlossener Vorwärtspfeil |
FORWARD_OPEN_ARROW |
Ein offener Pfeil, der nach vorn zeigt. |
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 Anrufen von const {Animation} = await google.maps.importLibrary("marker").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
|---|---|
BOUNCE |
Die Markierung hüpft, 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. |