Linia łamana

Linia łamana to lista punktów, w których odcinki linii są rysowane między kolejnymi punktami. Linia łamana ma te właściwości:

Punkty

Wierki linii. Odcinki linii są rysowane między kolejnymi punktami. Linia łamana nie jest domyślnie zamknięta. Aby utworzyć zamkniętą linię łamaną, punkty początkowy i końcowy muszą być takie same.

Szerokość

Szerokość segmentu linii w pikselach ekranu. Szerokość jest stała i niezależna od poziomu powiększenia. Wartością domyślną jest 10.

Kolor

Kolor segmentu linii w formacie ARGB, taki sam jak format używany przez aplikację Color. Wartością domyślną jest czarny (0xff000000).

Limit początkowy/końcowy

Określa kształt, który zostanie użyty na początku lub na końcu linii łamanej. Obsługiwane typy ograniczeń: ButtCap, SquareCap, RoundCap (dotyczy we wzorach kresek jednolitych) i CustomCap (dotyczy każdego wzoru kreski). Domyślnie na początku i na końcu: ButtCap.

Typ złączenia

Typ połączenia określa kształt, który ma zostać użyty podczas łączenia przyległych fragmentów linii we wszystkich wierzchołkach linii łamanej z wyjątkiem wierzchołków początkowych i końcowych. Informacje o obsługiwanych typach złączy znajdziesz na stronie JointType. Wartością domyślną jest DEFAULT.

Styl kreski

Ciągła (domyślnie, reprezentowana przez null) lub sekwencja PatternItem obiektów do powtórzenia na linii. Dostępne typy PatternItem: Gap (zdefiniowane jako długość przerwy w pikselach), Dash (zdefiniowane jako szerokość linii i długość myślnika w pikselach) i Dot (okrągły, wyśrodkowany na linii, średnica zdefiniowana przez szerokość linii w pikselach).

Kolejność nakładania elementów

Kolejność, w jakiej jest rysowana ta nakładka z kafelkami w odniesieniu do innych nakładek (w tym GroundOverlay, TileOverlay, Circle i Polygon, ale nie Marker). Nakładka o większej kolejności nakładania elementów jest rysowana na nakładkach o mniejszych indeksach Z. Kolejność nakładek o tej samej kolejności nakładania elementów jest dowolna. Domyślna wartość zIndex to 0.

Widoczność

Wskazuje, czy linia łamana jest widoczna czy niewidoczna, tj. czy jest narysowana na mapie. Niewidoczna linia łamana nie jest rysowana, ale zachowuje wszystkie swoje pozostałe właściwości. Wartość domyślna to true, czyli widoczna.

Stan geodezyjny

Wskazuje, czy odcinki linii łamanej powinny być rysowane jako elementy geodezyjne, a nie proste na odwzorowaniu Merkatora. Geodezja to najkrótsza ścieżka między dwoma punktami na powierzchni Ziemi. Przy założeniu, że Ziemia jest sferą, można utworzyć krzywą geodezyjną.

Klikalność

Jeśli chcesz obsługiwać zdarzenia wywoływane, gdy użytkownik kliknie linię łamaną, ustaw tę właściwość na true. W każdej chwili możesz ją zmienić. Wartość domyślna to false. Jeśli ta właściwość ma wartość true, Twoja aplikacja będzie otrzymywać powiadomienia do GoogleMap.OnPolylineClickListener zarejestrowanego do setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Oznacz

Object powiązany z linią łamaną. Na przykład obiekt Object może zawierać dane o tym, co reprezentuje linia łamana. To łatwiejsze niż przechowywanie osobnego elementu Map<Polyline, Object>. Inny przykład możesz powiązać z identyfikatorem String odpowiadającym identyfikatorowi ze zbioru danych. Pakiet SDK Map Google na Androida nie odczytuje ani nie zapisuje tej właściwości.

Spany

Definiowanie rozpiętości przy użyciu różnych stylów używanych do renderowania tej linii łamanej. Możesz użyć tej właściwości do utworzenia linii łamanej o różnych parametrach StrokeStyle w różnych jej segmentach.

Metody w tej klasie muszą być wywoływane w wątku interfejsu Androida. Jeśli nie, w czasie działania wywoływany jest kod IllegalStateException.

Przykład

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));
 

Przewodnik dla programistów

Więcej informacji znajdziesz w przewodniku dla programistów dotyczącym kształtów.