Auf der Google Maps Platform ist bald eine neue Version der Funktionen für das cloudbasierte Gestalten von Karteninhalten verfügbar. Die Aktualisierung umfasst eine neue Standardfarbvorlage und Optimierungen in Bezug auf die Nutzerfreundlichkeit der Karten. Alle Kartenstile werden im März 2025 automatisch aktualisiert. Weitere Informationen zur Verfügbarkeit und Aktivierung sind unter Neuer Kartenstil für die Google Maps Platform verfügbar.

Diese Seite wurde von der Cloud Translation API übersetzt.

Markierung

public final class Markierung erweitert Objekt

Ein Symbol, das an einem bestimmten Punkt auf der Kartenoberfläche platziert wird. Ein Markierungssymbol ist ausgerichtet nicht mit der Oberfläche der Karte, sondern mit dem Bildschirm des Geräts. d.h., sie ändert sich nicht unbedingt Ausrichtung aufgrund von Kartendrehungen, Neigen oder Zoomen der Karte.

Eine Markierung hat die folgenden Eigenschaften:

Alpha: Hiermit wird die Deckkraft der Markierung festgelegt. Die Standardeinstellung ist „1.0“.
Anchor: Der Punkt auf dem Bild, der an der Position LatLng der Markierung platziert wird. Die Standardeinstellung ist 50% vom linken Rand und vom unteren Rand des Bildes.
Position: Der Wert LatLng für die Position der Markierung auf der Karte. Sie können diesen Wert hier ändern: jederzeit, wenn Sie die Markierung verschieben möchten.
Titel: Textstring, der in einem Infofenster erscheint, wenn der Nutzer auf die Markierung tippt. Sie können jederzeit ändern.
Snippet: Zusätzlicher Text, der unterhalb des Titels erscheint. Sie können diesen Wert jedoch jederzeit ändern.
Symbol: Eine Bitmap, die für die Markierung angezeigt wird. Wenn das Symbol nicht konfiguriert ist, wird ein Standardsymbol angezeigt. Mit defaultMarker(float) können Sie eine alternative Farbe für das Standardsymbol festlegen.
Status Ziehen: Wenn Sie zulassen möchten, dass Nutzer die Markierung ziehen können, setzen Sie diese Eigenschaft auf true. Ich können Sie diesen Wert jederzeit ändern. Der Standardwert ist false.
Sichtbarkeit: Standardmäßig ist die Markierung sichtbar. Um die Markierung unsichtbar zu machen, setzen Sie diese Eigenschaft auf false Sie können diesen Wert jedoch jederzeit ändern.
Flat oder Billboard: Wenn die Markierung flach auf der Karte anliegt, bleibt sie als Kamerabild auf der Karte hängen. wird gedreht und geneigt, bleibt jedoch im Gegensatz zu GroundOverlay-Objekten dieselbe Größe wie beim Zoomen der Kamera. Handelt es sich bei der Markierung um eine Plakatwand, wird sie immer in Richtung Kamera gezeichnet und sich mit der Kamera drehen und neigen. Die Standardeinstellung ist eine Billboard-Anzeige (false).
Rotation: Die Drehung der Markierung um den Ankerpunkt in Grad im Uhrzeigersinn. Die Achse ist senkrecht zur Markierung. Eine Rotation von 0 entspricht dem Standardwert Position der Markierung. Wenn die Markierung flach auf der Karte aufliegt, ist die Standardposition Norden. ausgerichtet und die Drehung ist so, dass die Markierung immer flach auf der Karte bleibt. Wenn der Parameter ist eine Billboard-Markierung, die Standardposition zeigt nach oben und ist so gedreht, dass die Markierung immer in die Kamera zeigt. Der Standardwert ist 0.
zIndex: Die Zeichenreihenfolge der Markierung. Die Markierungen werden in der Reihenfolge des zIndex gezeichnet, wobei die Höchste zIndex-Markierung oben gezeichnet. Durch Festlegen der zIndex-Eigenschaft für jede Markierung können Sie steuern, welches Tippziel Nutzer am wahrscheinlichsten erreichen werden. Der Standardwert ist 0.
Tag: Eine Object, die der Markierung zugeordnet ist. Object kann beispielsweise Folgendes enthalten: Daten über die Bedeutung der Markierung Das ist einfacher als das Speichern einer separaten Map<Marker, Object>. Ein weiteres Beispiel: Du kannst eine String-ID der ID aus einem Datensatz entspricht. Google Maps SDK for Android kann weder lesen noch schreibt diese Property.

Methoden in dieser Klasse müssen im Android-UI-Thread aufgerufen werden. Andernfalls wird zur Laufzeit ein IllegalStateException ausgelöst.

Beispiel

GoogleMap map = ... // get a map.
 // Add a marker at San Francisco.
 Marker marker = map.addMarker(new MarkerOptions()
     .position(new LatLng(37.7750, 122.4183))
     .title("San Francisco")
     .snippet("Population: 776733"));

Entwicklerleitfaden

Weitere Informationen finden Sie auf der Website des Markers-Entwicklers. .

Zusammenfassung für geschachtelte Klassen

@interface Marker.CollisionBehavior Gibt an, wie mit der Markierung umgegangen wird, wenn sie an einer Kollision mit anderen Markierungen oder einer Basis beteiligt ist Kartenlabels.

Public Method Summary

boolean	ist gleich(anderes Objekt) Prüft, ob dieser `Marker` gleich einer anderen ist.
float	getAlpha() Ruft den Alphawert der Markierung ab.
String	getId() Ruft die ID dieser Markierung ab.
LatLng	getPosition() Gibt die Position der Markierung zurück.
float	getRotation() Ruft die Drehung der Markierung ab.
String	getSnippet() Ruft das Snippet der Markierung ab.
Object	getTag() Ruft das Tag für die Markierung ab.
String	getTitle() Ruft den Titel der Markierung ab.
float	getZIndex() Gibt den zIndex der Markierung zurück.
int	hashCode()
void	hideInfoWindow() Verbirgt das Infofenster, wenn es von dieser Markierung angezeigt wird.
boolean	isDraggable() Ruft die Ziehbarkeit der Markierung ab.
boolean	isFlat() Ruft die flache Einstellung der Markierung ab.
boolean	isInfoWindowShown() Gibt an, ob das Infofenster derzeit über dieser Markierung angezeigt wird.
boolean	isVisible() Ruft die Sichtbarkeitseinstellung dieser Markierung ab.
void	remove() Entfernt diese Markierung von der Karte.
void	setAlpha(Gleitkommazahl) Legt den Alphawert (Opazität) der Markierung fest.
void	setAnchor(float anchorU, float anchorV) Legt den Ankerpunkt für die Markierung fest.
void	setDraggable(boolean draggable) Legt die Ziehbarkeit der Markierung fest.
void	setFlat(Boolescher Flat) Legt fest, ob diese Markierung flach an der Karte `true` oder an einer Reklametafel angebracht werden soll, die nach Kamera `false`.
void	setIcon(BitmapDescriptor iconDescriptor) Legt das Symbol für die Markierung fest.
void	setInfoWindowAnchor(float anchorU, float anchorV) Gibt den Punkt im Markierungsbild an, an dem das Infofenster verankert werden soll, wenn es sich befindet angezeigt.
void	setPosition(LatLng-Breitengrad) Legt die Position der Markierung fest.
void	setRotation(Gleitkommarotation) Legt die Drehung der Markierung in Grad im Uhrzeigersinn um den Ankerpunkt der Markierung fest.
void	setSnippet(String-Snippet) Legt das Snippet der Markierung fest.
void	setTag(Objekt-Tag) Legt das Tag für die Markierung fest.
void	setTitle(Stringtitel) Legt den Titel der Markierung fest.
void	setVisible(boolean visible) Legt die Sichtbarkeit dieser Markierung fest.
void	setZIndex(Gleitkommazahl zIndex) Legt den zIndex der Markierung fest.
void	showInfoWindow() Zeigt das Infofenster dieser Markierung auf der Karte an, wenn diese Markierung `isVisible()` ist.

Inherited Method Summary

From class java.lang.Object

boolean	equals(Objekt arg0)
letzte Klasse<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Methods

<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert ist gleich (Anderes Objekt)

Prüft, ob dieser Marker gleich einer anderen ist.

Parameter

Weitere	ein `Object`.

Gibt Folgendes zurück:

"true", wenn beide Objekte dasselbe Objekt sind, d. h. dies == other.

<ph type="x-smartling-placeholder"></ph> öffentlich schweben getAlpha ()

Ruft den Alphawert der Markierung ab.

Gibt Folgendes zurück:

Der Alphawert der Markierung im Bereich [0, 1].

<ph type="x-smartling-placeholder"></ph> öffentlich Zeichenfolge getId ()

Ruft die ID dieser Markierung ab. Die ID ist für alle Markierungen auf einer Karte eindeutig.

Gibt Folgendes zurück:

ID dieser Markierung.

<ph type="x-smartling-placeholder"></ph> öffentlich LatLng getPosition ()

Gibt die Position der Markierung zurück.

Gibt Folgendes zurück:

Ein LatLng-Objekt, das die aktuelle Position der Markierung angibt.

<ph type="x-smartling-placeholder"></ph> öffentlich schweben getRotation ()

Ruft die Drehung der Markierung ab.

Gibt Folgendes zurück:

Drehung der Markierung von der Standardposition aus in Grad im Uhrzeigersinn.

<ph type="x-smartling-placeholder"></ph> öffentlich Zeichenfolge getSnippet ()

Ruft das Snippet der Markierung ab.

Gibt Folgendes zurück:

Ein String, der das Snippet der Markierung enthält.

<ph type="x-smartling-placeholder"></ph> öffentlich Objekt getTag ()

Ruft das Tag für die Markierung ab.

Gibt Folgendes zurück:

das Tag, wenn ein Tag mit setTag festgelegt wurde null, wenn kein Tag festgelegt wurde.

<ph type="x-smartling-placeholder"></ph> öffentlich Zeichenfolge getTitle ()

Ruft den Titel der Markierung ab.

Gibt Folgendes zurück:

Ein String, der den Titel der Markierung enthält.

<ph type="x-smartling-placeholder"></ph> öffentlich schweben getZIndex ()

Gibt den zIndex der Markierung zurück.

Gibt Folgendes zurück:

zIndex dieser Markierung.

<ph type="x-smartling-placeholder"></ph> öffentlich Ganzzahl hashCode ()

<ph type="x-smartling-placeholder"></ph> öffentlich voidm hideInfoWindow ()

Verbirgt das Infofenster, wenn es von dieser Markierung angezeigt wird.

Diese Methode hat keine Auswirkungen, wenn diese Markierung nicht sichtbar ist.

<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert isDraggable ()

Ruft die Ziehbarkeit der Markierung ab. Wenn eine Markierung ziehbar ist, kann sie vom Benutzer verschoben werden, indem sie lange auf die Markierung drückt.

Gibt Folgendes zurück:

true, wenn die Markierung ziehbar ist; Andernfalls wird false zurückgegeben.

<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert isFlat ()

Ruft die flache Einstellung der Markierung ab.

Gibt Folgendes zurück:

true, wenn die Markierung flach auf der Karte anliegt; false, wenn die Markierung in die Kamera schauen.

<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert isInfoWindowShown ()

Gibt an, ob das Infofenster derzeit über dieser Markierung angezeigt wird. Hierbei wird nicht berücksichtigt, ob das Infofenster tatsächlich auf dem Bildschirm sichtbar ist.

<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert isVisible ()

Ruft die Sichtbarkeitseinstellung dieser Markierung ab. Dies gibt jedoch nicht an, ob die Markierung sich im Darstellungsbereich des Bildschirms befindet. Es gibt an, ob die Markierung gezeichnet wird, falls die im Darstellungsbereich des Bildschirms eine Rolle spielen.

Gibt Folgendes zurück:

Sichtbarkeit dieser Markierung.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm entfernen ()

Entfernt diese Markierung von der Karte. Nachdem eine Markierung entfernt wurde, ist das Verhalten aller ihrer sind nicht definiert.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setAlpha (Gleitkommazahl)

Legt den Alphawert (Opazität) der Markierung fest. Dies ist ein Wert zwischen 0 und 1, wobei 0 bedeutet, dass die Markierung ist vollständig transparent und 1 bedeutet, dass die Markierung vollständig undurchsichtig ist.

Parameter

Alpha

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setAnchor (Gleitkommazahl bei AnkerU, Gleitkommazahl bei AnkerV)

Legt den Ankerpunkt für die Markierung fest.

Der Ankerpunkt gibt den Punkt im Symbolbild an, der an der Position der Markierung verankert ist. auf der Erdoberfläche.

Der Ankerpunkt wird in einem durchgehenden Bereich [0.0, 1.0] x [0.0, 1.0] angegeben, wobei (0, 0) ist die obere linke Ecke des Bildes und (1, 1) die untere rechte Ecke. Der Ankerpunkt in einem Bild mit W x H ist der nächste diskrete Rasterpunkt in (W + 1) x (H + 1)-Raster, das sich durch Skalieren der dann Rundung ergibt. In einem 4 × 2-Bild wird der Ankerpunkt (0,7, 0,6) in den Rasterpunkt bei (3, 1) aufgelöst.

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----X-----+   (X, Y) = (3, 1)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*

Parameter

anchorU	u-Koordinate des Ankers als Verhältnis der Bildbreite (im Bereich [0, 1]).
anchorV	v-Koordinate des Ankers als Verhältnis der Bildhöhe (im Bereich [0, 1]).

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setDraggable (Boolescher ziehbarer Wert)

Legt die Ziehbarkeit der Markierung fest. Wenn eine Markierung ziehbar ist, kann sie vom Benutzer verschoben werden, indem sie lange auf die Markierung drückt.

Parameter

ziehbar

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setFlat (Boolescher Flat)

Legt fest, ob diese Markierung flach an der Karte true oder an einer Reklametafel angebracht werden soll, die nach Kamera false.

Parameter

auf dem gleichen Level

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setIcon (BitmapDescriptor iconDescriptor)

Legt das Symbol für die Markierung fest.

Parameter

iconDescriptor	Falls null, wird die Standardmarkierung verwendet.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setInfoWindowAnchor (Gleitkommazahl bei AnkerU, Gleitkommazahl bei AnkerV)

Gibt den Punkt im Markierungsbild an, an dem das Infofenster verankert werden soll, wenn es sich befindet angezeigt. Wird im selben Koordinatensystem wie der Anker angegeben. Unter setAnchor(float, float) finden Sie weitere Informationen. Standardmäßig ist dies die obere Mitte des Bilds.

Parameter

anchorU	u-Koordinate des Infofensterankers als Verhältnis der Bildbreite (in der Bereich [0, 1]).
anchorV	v-Koordinate des Infofensterankers als Verhältnis der Bildhöhe (in der Bereich [0, 1]).

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setPosition (LatLng-Breitengrad)

Legt die Position der Markierung fest.

Parameter

Latlng

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setRotation (Rotation mit Gleitkommazahl)

Legt die Drehung der Markierung in Grad im Uhrzeigersinn um den Ankerpunkt der Markierung fest. Die Achse ist senkrecht zur Markierung. Eine Drehung von 0 entspricht der Standardposition. der Markierung.

Parameter

Rotation

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setSnippet (String-Snippet)

Legt das Snippet der Markierung fest.

Parameter

Snippet	Wenn null, wird das Snippet gelöscht.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setTag (Objekt-Tag)

Legt das Tag für die Markierung fest.

Sie können diese Eigenschaft verwenden, um eine beliebige Object mit dieser Markierung zu verknüpfen. Für Beispiel: Object kann Daten über die Bedeutung der Markierung enthalten. Das ist einfacher als separate Map<Marker, Object> speichern. Als weiteres Beispiel können Sie String ID, die der ID aus einem Datensatz entspricht. Google Maps SDK for Android weder liest oder schreibt diese Eigenschaft. Sie sind dafür verantwortlich, setTag(null) anzurufen, um wenn Sie es nicht mehr benötigen, um Speicherlecks in Ihrer App zu vermeiden.

Parameter

Tag	Wenn null, wird das Tag gelöscht.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setTitle (Titel des Strings)

Legt den Titel der Markierung fest.

Parameter

Titel	Wenn null, wird der Titel gelöscht.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setVisible (Boolescher Wert sichtbar)

Legt die Sichtbarkeit dieser Markierung fest. Mit der Einstellung false und einem Infofenster für diese Markierung angezeigt wird, wird das Infofenster ausgeblendet.

Parameter

sichtbar

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setZIndex (ZIndex als Gleitkommazahl)

Legt den zIndex der Markierung fest.

Parameter

zIndex

<ph type="x-smartling-placeholder"></ph> öffentlich voidm showInfoWindow ()

Zeigt das Infofenster dieser Markierung auf der Karte an, wenn diese Markierung isVisible() ist.

Löst aus

IllegalArgumentException	`marker` ist nicht auf dieser Karte