Ein Polygon auf der Erdoberfläche. Ein Polygon kann konvex oder konkav sein und kann sich über 180° erstrecken und kann Löcher haben, die nicht ausgefüllt sind. Sie hat die folgenden Eigenschaften:
- Umriss
- Der Umriss wird durch eine Liste von Scheitelpunkten im oder gegen den Uhrzeigersinn angegeben. Es ist nicht erforderlich, damit die Start- und Endpunkte übereinstimmen; Ist dies nicht der Fall, wird das Polygon automatisch geschlossen werden. Liniensegmente werden zwischen aufeinanderfolgenden Punkten im kürzeren der beiden Richtungen (Osten oder Westen) verbunden.
- Schwarze Stellen
- Ein Loch ist ein Bereich innerhalb des Polygons, der nicht ausgefüllt ist. Ein Loch wird genau in wie die Gliederung. Ein Loch muss vollständig im Umriss enthalten sein. Mehrere Es können Löcher angegeben werden, überlappende Löcher werden jedoch nicht unterstützt.
- Strichbreite
- Liniensegmentbreite in Bildschirmpixeln. Die Breite ist konstant und unabhängig von der Zoomstufe. Der Standardwert ist 10.
- Strichfarbe
- Farbe des Liniensegments im ARGB-Format, das auch von
Color
verwendet wird. Der Standardwert ist Schwarz (0xff000000
). - Schwimmgelenktyp
- Der Verbindungstyp bestimmt die Form, die verwendet werden soll, wenn benachbarte Liniensegmente verbunden werden
Eckpunkte des Umrisses des Polygons. Unterstützte Verbindungstypen findest du unter
JointType
. Die Der Standardwert istDEFAULT
. - Strichmuster
- Durchgängig (Standard, dargestellt durch
null
) oder eine Folge vonPatternItem
-Objekten , der entlang des Umrisses des Polygons wiederholt wird. VerfügbarePatternItem
-Typen:Gap
(definiert durch die Lückenlänge in Pixeln),Dash
(definiert durch Strichbreite und Bindestrich) Länge in Pixeln) undDot
(kreisförmig, zentriert am Umriss des Polygons, Durchmesser) definiert durch die Strichbreite in Pixeln). - Füllfarbe
- Füllfarbe im ARGB-Format, das auch von
Color
verwendet wird. Die Der Standardwert ist transparent (0x00000000
). Wenn die Polygongeometrie nicht angegeben ist korrekt ist (siehe oben für Umriss und Löcher), wird keine Füllung gezeichnet. - Z-Index
- Die Reihenfolge, in der dieses Polygon im Verhältnis zu anderen Overlays wie
Polyline
-,Circle
-,GroundOverlay
- undTileOverlay
-Elementen gezeichnet wird.Marker
. Ein Overlay mit einem größeren Z-Index wird über Overlays mit kleineren z-Indizes. Die Reihenfolge von Overlays mit demselben Z-Indexwert ist beliebig. Die Standardeinstellung ist 0. - Sichtbarkeit
- Gibt an, ob das Polygon sichtbar oder unsichtbar ist, also ob es auf der Karte gezeichnet wurde. Eine
unsichtbaren Polygons wird nicht gezeichnet, behält aber alle anderen Eigenschaften bei. Die Standardeinstellung ist
true
, also sichtbar. - Geodätischer Status
- Gibt an, ob die Segmente des Polygons geodätisch gezeichnet werden sollen gerade Linien auf der Mercator-Projektion an. Eine Geodäte ist der kürzeste Weg zwischen zwei auf der Erdoberfläche. Die geodätische Kurve wird unter der Annahme konstruiert, dass es sich bei der Erde um eine Kugel
- Anklickbarkeit
- Wenn Ereignisse verarbeitet werden sollen, die ausgelöst werden, wenn der Nutzer auf das Polygon klickt, legen Sie diese Eigenschaft auf
true
. Sie können diesen Wert jedoch jederzeit ändern. Der Standardwert istfalse
. Wenn diese auftrue
gesetzt ist, erhält deine App Benachrichtigungen an dieGoogleMap.OnPolygonClickListener
, die übersetOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
registriert sind. - Tag
- Eine
Object
, die dem Polygon zugeordnet ist.Object
kann beispielsweise Folgendes enthalten: was das Polygon darstellt. Das ist einfacher als das Speichern einer separatenMap<Polygon, Object>
. Ein weiteres Beispiel: Du kannst eineString
-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 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 auf der Website des Shapes-Entwicklers. .
Public Method Summary
boolean |
ist gleich(anderes Objekt)
Prüft, ob dieser
Polygon gleich einer anderen ist. |
int |
getFillColor()
Ruft die Füllfarbe dieses Polygons ab.
|
List<List<LatLng>> |
getHoles()
Gibt einen Snapshot der Löcher dieses Polygons zum aktuellen Zeitpunkt zurück .
|
String |
getId()
Ruft die ID dieses Polygons ab.
|
List<LatLng> |
getPoints()
Gibt einen Snapshot der Eckpunkte dieses Polygons zum aktuellen Zeitpunkt zurück .
|
int |
getStrokeColor()
Ruft die Strichfarbe dieses Polygons ab.
|
int |
getStrokeJointType()
Ruft den Verbindungstyp der Kontur 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 dieses Polygons ab.
|
Object |
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 jedes Segment der Linie geodätisch gezeichnet ist oder nicht.
|
boolean |
isVisible()
Ruft die Sichtbarkeit dieses Polygons ab.
|
void |
remove()
Entfernt das Polygon aus der Karte.
|
void |
setClickable(boolesch anklickbar)
Legt die Anklickbarkeit des Polygons fest.
|
void |
setFillColor(int color)
Legt die Füllfarbe dieses Polygons fest.
|
void |
setGeodesic(boolean geodesic)
Legt fest, ob jedes Segment der Linie geodätisch gezeichnet werden soll oder nicht.
|
void | |
void | |
void |
setStrokeColor(int-Farbe)
Legt die Strichfarbe dieses Polygons fest.
|
void |
setStrokeJointType(int joinType)
Legt den Verbindungstyp für alle Eckpunkte des Polygonumrisses fest.
|
void | |
void |
setStrokeWidth(Gleitkommabreite)
Legt die Strichbreite dieses Polygons fest.
|
void |
setTag(Objekt-Tag)
Legt das Tag für das Polygon fest.
|
void |
setVisible(boolean visible)
Legt die Sichtbarkeit dieses Polygons fest.
|
void |
setZIndex(Gleitkommazahl zIndex)
Legt den zIndex dieses Polygons fest.
|
Inherited Method Summary
Public Methods
<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert ist gleich (Anderes Objekt)
<ph type="x-smartling-placeholder"></ph> öffentlich Ganzzahl getFillColor ()
Ruft die Füllfarbe dieses Polygons ab.
Gibt Folgendes zurück:
- die Farbe im ARGB-Format.
<ph type="x-smartling-placeholder"></ph> öffentlich List<List<LatLng>> getHoles ()
Gibt einen Snapshot der Löcher dieses Polygons zum aktuellen Zeitpunkt zurück . Die zurückgegebene Liste ist eine Kopie von Daher werden Änderungen an den Löchern des Polygons weder in dieser Liste widergespiegelt werden Änderungen an dieser Liste für das Polygon übernommen.
<ph type="x-smartling-placeholder"></ph> öffentlich Zeichenfolge getId ()
Ruft die ID dieses Polygons ab. Die ID ist für alle Polygone auf einer Karte eindeutig.
<ph type="x-smartling-placeholder"></ph> öffentlich List<LatLng> getPoints ()
Gibt einen Snapshot der Eckpunkte dieses Polygons zum aktuellen Zeitpunkt zurück . Die zurückgegebene Liste ist eine Kopie
der Liste mit Scheitelpunkten. Daher werden Änderungen an den Scheitelpunkten des Polygons hier nicht berücksichtigt.
noch werden Änderungen an der Liste durch das Polygon wiedergegeben. Um die Scheitelpunkte des
Polygon enthält, rufen Sie setPoints(List)
auf.
<ph type="x-smartling-placeholder"></ph> öffentlich Ganzzahl getStrokeColor ()
Ruft die Strichfarbe dieses Polygons ab.
Gibt Folgendes zurück:
- die Farbe im ARGB-Format.
<ph type="x-smartling-placeholder"></ph> öffentlich Ganzzahl getStrokeJointType ()
Ruft den Verbindungstyp der Kontur ab, der für alle Eckpunkte des Polygonumrisses verwendet wird. Weitere Informationen: JointType
für mögliche Werte.
Gibt Folgendes zurück:
- den Verstärkungsgelenktyp.
<ph type="x-smartling-placeholder"></ph> öffentlich List<PatternItem> > getStrokePattern ()
Ruft das Strichmuster des Umrisses dieses Polygons ab.
Gibt Folgendes zurück:
- Strichmuster an.
<ph type="x-smartling-placeholder"></ph> öffentlich schweben getStrokeWidth ()
Ruft die Strichbreite dieses Polygons ab.
Gibt Folgendes zurück:
- die Breite in Bildschirmpixeln.
<ph type="x-smartling-placeholder"></ph> öffentlich Objekt getTag ()
Ruft das Tag für das Polygon ab.
Gibt Folgendes zurück:
- das Tag, wenn ein Tag mit
setTag
festgelegt wurdenull
, wenn kein Tag festgelegt wurde.
<ph type="x-smartling-placeholder"></ph> öffentlich schweben getZIndex ()
Ruft den zIndex dieses Polygons ab.
Gibt Folgendes zurück:
- zIndex des Polygons.
<ph type="x-smartling-placeholder"></ph> öffentlich Ganzzahl hashCode ()
<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert isClickable ()
Ruft die Anklickbarkeit des Polygons ab. Wenn das Polygon anklickbar ist, empfängt Ihre App
Benachrichtigungen an GoogleMap.OnPolygonClickListener
gesendet, wenn der Nutzer auf das Polygon klickt.
Der Event-Listener wird über setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
registriert.
Gibt Folgendes zurück:
true
, wenn das Polygon anklickbar ist Andernfalls wirdfalse
zurückgegeben.
<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert isGeodesic ()
Ruft ab, ob jedes Segment der Linie geodätisch gezeichnet ist oder nicht.
Gibt Folgendes zurück:
true
, wenn jedes Segment als Geodäte gezeichnet ist;false
, wenn jedes Segment auf der Mercator-Projektion als gerade Linie gezeichnet werden.
<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert isVisible ()
Ruft die Sichtbarkeit dieses Polygons ab.
Gibt Folgendes zurück:
- die Sichtbarkeit dieses Polygons.
<ph type="x-smartling-placeholder"></ph> öffentlich voidm entfernen ()
Entfernt das Polygon aus der Karte. Nachdem ein Polygon entfernt wurde, ist das Verhalten aller seiner sind nicht definiert.
<ph type="x-smartling-placeholder"></ph> öffentlich voidm setClickable (Boolescher Wert anklickbar)
Legt die Anklickbarkeit des Polygons fest. Wenn das Polygon anklickbar ist, empfängt Ihre App
Benachrichtigungen an GoogleMap.OnPolygonClickListener
gesendet, wenn der Nutzer auf das Polygon klickt.
Der Event-Listener wird über setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
registriert.
Parameter
Anklickbar | Neue Anklickbarkeitseinstellung für das Polygon. |
---|
<ph type="x-smartling-placeholder"></ph> öffentlich voidm setFillColor (int color)
Legt die Füllfarbe dieses Polygons fest.
Parameter
Farbe | die Farbe im ARGB-Format |
---|
<ph type="x-smartling-placeholder"></ph> öffentlich voidm setGeodesic (boolesch geodätisch)
Legt fest, ob jedes Segment der Linie geodätisch gezeichnet werden soll oder nicht.
Parameter
geodesic | bei true wird jedes Segment als Geodäte gezeichnet. wenn false ,
Jedes Segment wird auf der Mercator-Projektion als gerade Linie gezeichnet.
|
---|
<ph type="x-smartling-placeholder"></ph> öffentlich voidm setHoles (List<? extends List<LatLng>> Löcher)
Legt die Löcher des Polygons fest. Diese Methode verwendet eine Kopie der Löcher, sodass weitere Mutationen
nach holes
hat keine Auswirkungen auf dieses Polygon.
Parameter
Löcher | Eine Liste von Löchern, wobei ein Loch eine Liste von LatLng s ist.
|
---|
<ph type="x-smartling-placeholder"></ph> öffentlich voidm setPoints (List<LatLng>-Punkte)
Legt die Punkte dieses Polygons fest. Bei dieser Methode wird eine Kopie der Punkte verwendet.
Mutationen von points
haben keine Auswirkungen auf dieses Polygon.
Parameter
Punkte | Eine Liste von LatLng s, die die Eckpunkte des Polygons sind.
|
---|
<ph type="x-smartling-placeholder"></ph> öffentlich voidm setStrokeColor (int color)
Legt die Strichfarbe dieses Polygons fest.
Parameter
Farbe | die Farbe im ARGB-Format |
---|
<ph type="x-smartling-placeholder"></ph> öffentlich voidm setStrokeJointType (int joinType).
<ph type="x-smartling-placeholder"></ph> öffentlich voidm setStrokePattern (List<PatternItem> Muster)
Legt das Strichmuster des Umrisses des Polygons fest. Das Standardmuster der Striche ist „Durchgängig“,
dargestellt durch null
.
Parameter
Muster | Strichmuster an. |
---|
<ph type="x-smartling-placeholder"></ph> öffentlich voidm setStrokeWidth (Breite Gleitkommazahl)
Legt die Strichbreite dieses Polygons fest.
Parameter
Breite | die Breite in Displaypixeln. |
---|
<ph type="x-smartling-placeholder"></ph> öffentlich voidm setTag (Objekt-Tag)
Legt das Tag für das Polygon fest.
Mit dieser Eigenschaft können Sie eine beliebige Object
mit diesem Polygon verknüpfen. Für
Beispiel: Object
kann Daten über die Darstellung des Polygons enthalten. Das ist einfacher
als separate Map<Polygon, 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 setVisible (Boolescher Wert sichtbar)
Legt die Sichtbarkeit dieses Polygons fest. Ist dies nicht der Fall, wird ein Polygon nicht gezeichnet, es behält aber seine anderen Eigenschaften.
Parameter
sichtbar | Bei true ist das Polygon sichtbar. Wenn false , trifft dies nicht zu.
|
---|
<ph type="x-smartling-placeholder"></ph> öffentlich voidm setZIndex (ZIndex als Gleitkommazahl)
Legt den zIndex dieses Polygons fest. Polygone mit höheren zIndices werden über Polygonen mit niedrigeren zIndices gezeichnet. Indexe.
Parameter
zIndex | zIndex dieses Polygons. |
---|