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 istDEFAULT
. - Strichmuster
- Durchgängig (Standardeinstellung, dargestellt durch
null
) oder eine Abfolge vonPatternItem
-Objekten, die entlang des Umrisses des Polygons wiederholt werden. VerfügbarePatternItem
-Typen:Gap
(definiert durch die Lückenlänge in Pixeln),Dash
(definiert durch die Strichbreite und die Strichlänge in Pixeln) undDot
(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
Polyline
s,Circle
s,GroundOverlay
s undTileOverlay
s, aber nichtMarker
s. 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 istfalse
. Wenn dieses Attribut auftrue
gesetzt ist, erhält deine App Benachrichtigungen an dieGoogleMap.OnPolygonClickListener
, die übersetOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
registriert sind. - Taggen
- Eine
Object
, die dem Polygon zugeordnet ist. Beispielsweise kannObject
Daten darüber enthalten, was das Polygon darstellt. Dies ist einfacher als das Speichern einer separatenMap<Polygon, Object>
. Als weiteres Beispiel können Sie eineString
-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 | |
void | |
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 | |
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
Public Methods
public boolesch ist gleich (Objekt anderes)
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 wirdfalse
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)
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. |
---|