Polygon

public final class Polygon erweitert Objekt

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 ist DEFAULT.
Strichmuster
Durchgängig (Standard, dargestellt durch null) oder eine Folge von PatternItem-Objekten , der entlang des Umrisses des Polygons wiederholt wird. Verfügbare PatternItem-Typen: Gap (definiert durch die Lückenlänge in Pixeln), Dash (definiert durch Strichbreite und Bindestrich) Länge in Pixeln) und Dot (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- und TileOverlay-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 ist false. Wenn diese auf true gesetzt ist, erhält deine App Benachrichtigungen an die GoogleMap.OnPolygonClickListener, die über setOnPolygonClickListener(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 separaten Map<Polygon, 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 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
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
setHoles(List<? extends List<LatLng>> Löcher)
Legt die Löcher des Polygons fest.
void
setPoints(List<LatLng> Punkte)
Legt die Punkte dieses Polygons fest.
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
setStrokePattern(List<PatternItem> Muster)
Legt das Strichmuster des Umrisses des Polygons fest.
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)

Prüft, ob dieser Polygon 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 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 wurde null, 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 wird false 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 LatLngs 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 LatLngs, 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).

Legt den Verbindungstyp für alle Eckpunkte des Polygonumrisses fest.

Zulässige Werte finden Sie unter JointType. Der Standardwert DEFAULT wird verwendet, wenn der Verbindungstyp nicht definiert ist oder nicht zu den zulässigen Werten gehört.

Parameter
jointType den Verstärkungsgelenktyp.

<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.