Polylinie

Eine Polylinie ist eine Liste von Punkten, wobei Liniensegmente zwischen aufeinanderfolgenden Punkten gezeichnet werden. Polylinien haben folgende Eigenschaften:

Punkte

Die Eckpunkte der Linie. Liniensegmente werden zwischen aufeinanderfolgenden Punkten platziert. Eine Polylinie ist standardmäßig nicht geschlossen. Zum Erstellen einer geschlossenen Polylinie müssen die Start- und Endpunkte identisch sein.

Breite

Breite des Liniensegments in Bildschirmpixeln Die Breite ist konstant und unabhängig vom Zoomfaktor der Kamera. Der Standardwert ist 10.

Farbe

Liniensegmentfarbe im ARGB-Format, dasselbe Format wie bei Color. Der Standardwert ist Schwarz (0xff000000).

Anfangs-/Endbanner

Bestimmt die Form, die am Anfang oder am Ende einer Polylinie verwendet werden soll. Unterstützte Begrenzungstypen: ButtCap, SquareCap, RoundCap (für durchgehende Strichmuster) und CustomCap (für jedes Strichmuster). Standard für Start und Ende: ButtCap.

Verbindungstyp

Der Verbindungstyp definiert die Form, die beim Verbinden benachbarter Liniensegmente an allen Eckpunkten der Polylinie verwendet wird. Ausgenommen hiervon sind die Start- und Endeckpunkte. Informationen zu unterstützten Join-Typen finden Sie unter JointType. Der Standardwert ist DEFAULT.

Strichmuster

Durchgezogen (Standardwert, dargestellt durch null) oder eine Abfolge von PatternItem-Objekten, die entlang der Linie wiederholt werden sollen. Verfügbare PatternItem-Typen: Gap (definiert durch die Abstandslänge in Pixeln), Dash (definiert durch die Linienbreite und Strichlänge in Pixeln) und Dot (kreisförmig, in der Mitte der Linie, Durchmesser der Linienbreite in Pixeln).

Z-Index

Die Reihenfolge, in der dieses Kachel-Overlay bezogen auf andere Overlays gezeichnet wird (einschließlich GroundOverlays, TileOverlays, Circles und Polygons, aber nicht auf Markers). Ein Overlay mit einem größeren Z-Index wird über Overlays mit kleineren Z-Indexen gezeichnet. Die Reihenfolge von Überlagerungen mit identischen z-Indizes ist beliebig. Der Standard-ZIndex ist 0.

Sichtbarkeit

Gibt an, ob die Polylinie sichtbar oder unsichtbar ist, d.h., ob sie auf der Karte gezeichnet wird. Eine unsichtbare Polylinie 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 der Polylinie als Geodäte und nicht als gerade Linien auf der Mercator-Projektion gezeichnet werden sollen. Der Geodäte ist der kürzeste Weg zwischen zwei Punkten auf der Erdoberfläche. Die geodätische Kurve wird unter der Annahme erstellt, dass die Erde eine Kugel ist.

Anklickbarkeit

Wenn Ereignisse verarbeitet werden sollen, die ausgelöst werden, wenn der Nutzer auf die Polylinie klickt, setze diese Property auf true. Sie können diesen Wert jedoch jederzeit ändern. Der Standardwert ist false. Wenn diese Property auf true gesetzt ist, erhält deine App Benachrichtigungen an die GoogleMap.OnPolylineClickListener, die über setOnPolylineClickListener(GoogleMap.OnPolylineClickListener) registriert ist.

Tag

Eine Object, die der Polylinie zugeordnet ist. Beispielsweise kann Object Daten zur Darstellung der Polylinie enthalten. Dies ist einfacher als das Speichern einer separaten Map<Polyline, Object>. Ein weiteres Beispiel ist eine String-ID, die der ID aus einem Dataset entspricht. Das Google Maps SDK for Android liest oder schreibt diese Property weder.

Spans

Definiert die Spans mit verschiedenen Stilen, die zum Rendern dieser Polylinie verwendet werden. Sie können diese Property verwenden, um eine Polylinie mit unterschiedlichen StrokeStyle in verschiedenen Segmenten der Polylinie zu erstellen.

Methoden in dieser Klasse müssen im Android-UI-Thread aufgerufen werden. Wenn nicht, wird IllegalStateException zur Laufzeit geworfen.

Beispiel

GoogleMap map;
 // ... get a map.
 // Add a thin red line from London to New York.
 Polyline line = map.addPolyline(new PolylineOptions()
     .add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
     .width(5)
     .color(Color.RED));
 

Entwicklerleitfaden

Weitere Informationen finden Sie im Shapes-Entwicklerleitfaden.