Diese Seite wurde von der Cloud Translation API übersetzt.

Polygon

Öffentliche finale Klasse Polygon erweitert Objekt

Ein Polygon auf der Erdoberfläche. Ein Polygon kann konvex oder konkav sein, kann sich über den 180er-Meridian erstrecken und Lücken enthalten, die nicht ausgefüllt sind. Sie hat folgende Eigenschaften:

Umriss: Der Umriss wird durch eine Liste von Eckpunkten angegeben, die im oder gegen den Uhrzeigersinn angegeben werden. Die Start- und Endpunkte müssen nicht übereinstimmen. Andernfalls wird das Polygon automatisch geschlossen. Zwischen aufeinanderfolgenden Punkten werden in der kürzeren Richtung (Osten oder Westen) Liniensegmente gezeichnet.
Schwarze Stellen: Ein Loch ist ein Bereich innerhalb des Polygons, der nicht ausgefüllt ist. Ein Loch wird genau auf die gleiche Weise wie der Umriss angegeben. Ein Loch muss sich vollständig innerhalb des Umrisses befinden. Es können mehrere Löcher angegeben werden. Überlappende Löcher werden jedoch nicht unterstützt.
Strichbreite: Breite des Liniensegments in Bildschirmpixeln. Die Breite ist konstant und unabhängig von der Zoomstufe der Kamera. Der Standardwert ist 10.
Strichfarbe: Farbe des Liniensegments im ARGB-Format, dasselbe Format, das auch von Color verwendet wird Der Standardwert ist Schwarz (0xff000000).
Strichgelenktyp: Der Verbindungstyp definiert die Form, die beim Verbinden benachbarter Liniensegmente an allen Eckpunkten des Polygonumrisses verwendet werden soll. Informationen zu unterstützten Verbindungstypen finden Sie unter JointType. Der Standardwert ist DEFAULT.
Strichmuster: Durchgängig (Standardeinstellung, dargestellt durch null) oder eine Abfolge von PatternItem-Objekten, die entlang des Umrisses des Polygons wiederholt werden. Verfügbare PatternItem-Typen: Gap (definiert durch die Lückenlänge in Pixeln), Dash (definiert durch die Strichbreite und die Strichlänge in Pixeln) und Dot (kreisförmig, auf dem Umriss des Polygons zentriert, Durchmesser durch Strichbreite in Pixeln definiert).
Füllfarbe: Füllfarbe im ARGB-Format, wie auch von Color verwendet Der Standardwert ist "transparent" (0x00000000). Wenn die Geometrie des Polygons nicht richtig angegeben wurde (siehe oben zu Umrissen und Löchern), wird keine Füllung gezeichnet.
Z-Index: Die Reihenfolge, in der dieses Polygon in Bezug auf andere Overlays gezeichnet wird, einschließlich Polylines, Circles, GroundOverlays und TileOverlays, aber nicht Markers. Ein Overlay mit einem größeren Z-Index wird über Overlays mit kleineren Z-Indizes gezogen. Die Reihenfolge von Overlays mit demselben Z-Indexwert ist beliebig. Der Standardwert ist 0.
Sichtbarkeit: Gibt an, ob das Polygon sichtbar oder unsichtbar ist, d.h., ob es auf der Karte gezeichnet wird. Ein unsichtbares Polygon wird nicht gezeichnet, behält aber alle anderen Eigenschaften bei. Der Standardwert ist true, d.h. sichtbar.
Geodätischer Status: Gibt an, ob die Segmente des Polygons als geodätische Linien und nicht als gerade Linien in der Mercator-Projektion gezeichnet werden sollen. Eine Geodäte ist der kürzeste Weg zwischen zwei Punkten auf der Erdoberfläche. Die geodätische Kurve wird unter der Annahme, dass die Erde eine Kugel ist, konstruiert.
Anklickbarkeit: Wenn Ereignisse verarbeitet werden sollen, die ausgelöst werden, wenn der Nutzer auf das Polygon klickt, legen Sie dieses Attribut auf true fest. Sie können diesen Wert jedoch jederzeit ändern. Der Standardwert ist false. Wenn dieses Attribut auf true gesetzt ist, erhält deine App Benachrichtigungen an die GoogleMap.OnPolygonClickListener, die über setOnPolygonClickListener(GoogleMap.OnPolygonClickListener) registriert sind.
Taggen: Eine Object, die dem Polygon zugeordnet ist. Beispielsweise kann Object Daten darüber enthalten, was das Polygon darstellt. Dies ist einfacher als das Speichern einer separaten Map<Polygon, Object>. Als weiteres Beispiel können Sie eine String-ID verknüpfen, die der ID aus einem Dataset entspricht. Das Google Maps SDK for Android liest oder schreibt diese Property weder.

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

Beispiel

GoogleMap map;
 // ... get a map.
 // Add a triangle in the Gulf of Guinea
 Polygon polygon = map.addPolygon(new PolygonOptions()
     .add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));

Entwicklerleitfaden

Weitere Informationen finden Sie im Entwicklerleitfaden für Formen.

Public Method Summary

boolean	ist gleich(Sonstiges Objekt) Testet, ob diese `Polygon` einem anderen entspricht.
int	getFillColor() Ruft die Füllfarbe des Polygons ab.
List<List<LatLng>>	getHoles() Gibt eine Momentaufnahme der Löcher dieses Polygons zu diesem Zeitpunkt zurück .
String	getId() Ruft die ID dieses Polygons ab.
List<LatLng>	getPoints() Gibt eine Momentaufnahme der Scheitelpunkte dieses Polygons zu diesem Zeitpunkt zurück .
int	getStrokeColor() Ruft die Strichfarbe des Polygons ab.
int	getStrokeJointType() Ruft den Verbindungstyp des Strichs ab, der für alle Eckpunkte des Polygonumrisses verwendet wird.
List<PatternItem>	getStrokePattern() Ruft das Strichmuster des Umrisses dieses Polygons ab.
float	getStrokeWidth() Ruft die Strichbreite des Polygons ab.
Objekt	getTag() Ruft das Tag für das Polygon ab.
float	getZIndex() Ruft den zIndex dieses Polygons ab.
int	hashCode()
boolean	isClickable() Ruft die Anklickbarkeit des Polygons ab.
boolean	isGeodesic() Ruft ab, ob die einzelnen Segmente der Linie geodätisch gezeichnet wurden.
boolean	isVisible() Ruft die Sichtbarkeit dieses Polygons ab.
void	remove() Entfernt das Polygon aus der Karte.
void	setClickable(boolesch klickbar) Legt die Anklickbarkeit des Polygons fest.
void	setFillColor(int-Farbe) Legt die Füllfarbe des Polygons fest.
void	setGeodesic(boolesch geodätisch) Legt fest, ob die einzelnen Segmente der Linie geodätisch gezeichnet werden sollen.
void	setHoles(List<? erweitert List<LatLng>>-Löcher) Legt die Löcher dieses Polygons fest.
void	setPoints(List<LatLng>-Punkte) Legt die Punkte dieses Polygons fest.
void	setStrokeColor(int-Farbe) Legt die Strichfarbe des Polygons fest.
void	setStrokeJointType(int JoinType) Legt den Verbindungstyp für alle Eckpunkte des Umrisses des Polygons fest.
void	setStrokePattern(List<PatternItem>-Muster) Legt das Strichmuster des Umrisses des Polygons fest.
void	setStrokeWidth(Gleitkommazahl) Legt die Strichbreite des Polygons fest.
void	setTag(Objekt-Tag) Legt das Tag für das Polygon fest.
void	setVisible(boolesch sichtbar) Legt die Sichtbarkeit dieses Polygons fest.
void	setZIndex(Gleitkommazahl zIndex) Legt den zIndex dieses Polygons fest.

Inherited Method Summary

Aus Klasse java.lang.Object

boolean	equals(Objekt arg0)
finaler Kurs<?>	getClass()
int	hashCode()
endgültige Gültigkeit	notify()
endgültige Gültigkeit	notifyAll()
String	toString()
endgültige Gültigkeit	wait(long arg0, int arg1)
endgültige Gültigkeit	wait(long arg0)
endgültige Gültigkeit	wait()

Public Methods

public boolesch ist gleich (Objekt anderes)

Testet, ob diese Polygon einem anderen entspricht.

Parameter

Weitere	ein `Object`.

Rückgaben

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

public int getFillColor ()

Ruft die Füllfarbe des Polygons ab.

Rückgaben

die Farbe im ARGB-Format.

public List<List<LatLng>> getHoles ()

Gibt eine Momentaufnahme der Löcher dieses Polygons zu diesem Zeitpunkt zurück . Die zurückgegebene Liste ist eine Kopie der Liste der Löcher. Änderungen an den Löchern des Polygons spiegeln sich daher weder in dieser Liste wider, noch werden Änderungen an dieser Liste vom Polygon übernommen.

public String getId ()

Ruft die ID dieses Polygons ab. Die ID ist für alle Polygone auf einer Karte eindeutig.

public List<LatLng> getPoints ()

Gibt eine Momentaufnahme der Scheitelpunkte dieses Polygons zu diesem Zeitpunkt zurück . Die zurückgegebene Liste ist eine Kopie der Liste der Eckpunkte. Änderungen an den Eckpunkten des Polygons werden daher weder in dieser Liste wiedergegeben, noch werden Änderungen an dieser Liste vom Polygon übernommen. Um die Eckpunkte des Polygons zu ändern, rufen Sie setPoints(List) auf.

public int getStrokeColor ()

Ruft die Strichfarbe des Polygons ab.

Rückgaben

die Farbe im ARGB-Format.

public int getStrokeJointType ()

Ruft den Verbindungstyp des Strichs ab, der für alle Eckpunkte des Polygonumrisses verwendet wird. Mögliche Werte siehe JointType.

Rückgaben

den Verbindungstyp „Strich“.

public List<PatternItem> getStrokePattern ()

Ruft das Strichmuster des Umrisses dieses Polygons ab.

Rückgaben

des Strichmusters.

public float getStrokeWidth ()

Ruft die Strichbreite des Polygons ab.

Rückgaben

die Breite in Bildschirmpixeln.

public Objekt getTag ()

Ruft das Tag für das Polygon ab.

Rückgaben

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

public float getZIndex ()

Ruft den zIndex dieses Polygons ab.

Rückgaben

zIndex des Polygons.

public int hashCode ()

public boolesch isClickable ()

Ruft die Anklickbarkeit des Polygons ab. Wenn das Polygon anklickbar ist, erhält Ihre App Benachrichtigungen an GoogleMap.OnPolygonClickListener, wenn der Nutzer auf das Polygon klickt. Der Event-Listener wird über setOnPolygonClickListener(GoogleMap.OnPolygonClickListener) registriert.

Rückgaben

true, wenn das Polygon anklickbar ist. Andernfalls wird false zurückgegeben.

public boolean isGeodesic ()

Ruft ab, ob die einzelnen Segmente der Linie geodätisch gezeichnet wurden.

Rückgaben

true, wenn jedes Segment als Geodäte gezeichnet wird; false, wenn jedes Segment als gerade Linie in der Mercator-Projektion gezeichnet wird.

public boolesch isVisible ()

Ruft die Sichtbarkeit dieses Polygons ab.

Rückgaben

diese Polygonsichtbarkeit.

public void entfernen ()

Entfernt das Polygon aus der Karte. Nachdem ein Polygon entfernt wurde, ist das Verhalten aller seiner Methoden nicht mehr definiert.

public void setClickable (boolesch klickbar)

Legt die Anklickbarkeit des Polygons fest. Wenn das Polygon anklickbar ist, erhält Ihre App Benachrichtigungen an GoogleMap.OnPolygonClickListener, wenn der Nutzer auf das Polygon klickt. Der Event-Listener wird über setOnPolygonClickListener(GoogleMap.OnPolygonClickListener) registriert.

Parameter

Anklickbar	Neue Einstellung für die Anklickbarkeit für das Polygon.

public void setFillColor (int color)

Legt die Füllfarbe des Polygons fest.

Parameter

Farbe	die Farbe im ARGB-Format

public void setGeodesic (boolean geodesic)

Legt fest, ob die einzelnen Segmente der Linie geodätisch gezeichnet werden sollen.

Parameter

geodesic	Bei `true` wird jedes Segment als Geodäte gezeichnet. Bei `false` wird jedes Segment als gerade Linie in der Mercator-Projektion gezeichnet.

public void setHoles (List<? extends List<LatLng>> Lochs)

Legt die Löcher dieses Polygons fest. Diese Methode verwendet eine Kopie der Löcher, sodass weitere Mutationen an holes keine Auswirkungen auf das Polygon haben.

Parameter

Löcher	Eine Liste von Löchern, wobei ein Loch eine Liste von `LatLng`s ist

public void setPoints (List<LatLng>-Punkte)

Legt die Punkte dieses Polygons fest. Diese Methode verwendet eine Kopie der Punkte, sodass weitere Mutationen an points keine Auswirkungen auf das Polygon haben.

Parameter

Punkte	Eine Liste von `LatLng`s, die die Scheitelpunkte des Polygons sind.

public void setStrokeColor (int color)

Legt die Strichfarbe des Polygons fest.

Parameter

Farbe	die Farbe im ARGB-Format

public void setStrokeJointType (int JoinType)

Legt den Verbindungstyp für alle Eckpunkte des Umrisses des Polygons fest.

Zulässige Werte finden Sie unter JointType. Wenn der Verbindungstyp nicht definiert ist oder keiner der zulässigen Werte ist, wird der Standardwert DEFAULT verwendet.

Parameter

jointType	den Verbindungstyp „Strich“.

public void setStrokePattern (List<PatternItem> pattern)

Legt das Strichmuster des Umrisses des Polygons fest. Das Standardstrichmuster ist durchgehend, dargestellt durch null.

Parameter

Muster	des Strichmusters.

public void setStrokeWidth (Gleitkommabreite)

Legt die Strichbreite des Polygons fest.

Parameter

width	die Breite in Display-Pixeln.

public void setTag (Objekt-Tag)

Legt das Tag für das Polygon fest.

Du kannst dieses Attribut verwenden, um ein beliebiges Object mit diesem Polygon zu verknüpfen. Beispielsweise kann Object Daten darüber enthalten, was das Polygon darstellt. Dies ist einfacher als das Speichern einer separaten Map<Polygon, Object>. Als weiteres Beispiel kannst du eine String-ID verknüpfen, die der ID aus einem Dataset entspricht. Das Google Maps SDK for Android liest oder schreibt diese Property weder. Sie sind dafür verantwortlich, setTag(null) aufzurufen, um das Tag zu löschen, wenn Sie es nicht mehr benötigen, um Speicherlecks in Ihrer App zu vermeiden.

Parameter

Tag	Ist null, wird das Tag gelöscht.

public void setVisible (boolean visible)

Legt die Sichtbarkeit dieses Polygons fest. Wenn ein Polygon nicht sichtbar ist, wird es nicht gezeichnet. Alle anderen Eigenschaften werden beibehalten.

Parameter

sichtbar	Bei `true` ist das Polygon sichtbar, bei `false` nicht.

public void setZIndex (Gleitkomma zIndex)

Legt den zIndex dieses Polygons fest. Polygone mit höheren zIndizes werden über denen mit niedrigeren Indizes gezeichnet.

Parameter

zIndex	zIndex dieses Polygons.