Polylinie

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

Punkte

Die Eckpunkte der Linie. Zwischen aufeinanderfolgenden Punkten werden Liniensegmente gezeichnet. Eine Polylinie ist nicht standardmäßig geschlossen. Um eine geschlossene Polylinie zu bilden, müssen die Start- und Endpunkte identisch sein.

Breite

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

Farbe

Farbe des Liniensegments im ARGB-Format, dasselbe Format, das auch von Color verwendet wird Der Standardwert ist Schwarz (0xff000000).

Start- und Endbanner

Definiert die Form, die am Anfang oder Ende einer Polylinie verwendet werden soll. Unterstützte Begrenzungstypen: ButtCap, SquareCap, RoundCap (gilt für durchgezogene Strichmuster) und CustomCap (gilt für alle Strichmuster). Standardwert für Start und Ende: ButtCap.

Verbindungstyp

Der Verbindungstyp definiert die Form, die beim Verbinden benachbarter Liniensegmente an allen Eckpunkten der Polylinie, mit Ausnahme der Eckpunkte von Anfang und Ende, verwendet werden soll. Informationen zu unterstützten Verbindungstypen finden Sie unter JointType. Der Standardwert ist DEFAULT.

Strichmuster

Durchgängig (Standard, 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 die Strichlänge in Pixeln) und Dot (kreisförmig, auf der Linie zentriert, Durchmesser durch Linienbreite in Pixeln definiert).

Z-Index

Die Reihenfolge, in der dieses Kachel-Overlay in Bezug auf andere Overlays gezeichnet wird (einschließlich GroundOverlays, TileOverlays, Circles und Polygons, aber nicht Markers). Ein Overlay mit einem größeren Z-Index wird über Overlays mit kleineren Z-Indizes gezogen. 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 eingezeichnet 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ä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 die Polylinie 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.OnPolylineClickListener, die über setOnPolylineClickListener(GoogleMap.OnPolylineClickListener) registriert sind.

Taggen

Ein Object, der mit der Polylinie verknüpft ist. Beispielsweise kann Object Daten darüber enthalten, was die Polylinie darstellt. Dies ist einfacher als das Speichern einer separaten Map<Polyline, 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.

Spans

Definiert die Spannen mit verschiedenen Stilen, die zum Rendern dieser Polylinie verwendet werden. Mit dieser Eigenschaft können Sie eine Polylinie mit unterschiedlichen StrokeStyle für verschiedene Segmente der Polylinie erstellen.

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 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 Entwicklerleitfaden für Formen.