Linia łamana

publiczne zajęcia końcowe Polyline rozszerza obiekt

Linia łamana to lista punktów, gdzie między kolejnymi punktami rysowane są odcinki linii. O linia łamana ma następujące właściwości:

Punkty
W wierzchołki linii. Odcinki linii są rysowane pomiędzy kolejnymi punktami. Linia łamana to domyślnie nie jest zamknięta; w celu utworzenia zamkniętej linii łamanej, punkty początkowy i końcowy muszą być tak samo.
Szerokość
Szerokość segmentu linii w pikselach ekranu. Szerokość jest stała i niezależna od poziom powiększenia. Wartością domyślną jest 10.
Kolor
Kolor segmentu w formacie ARGB, taki sam jak w przypadku elementu Color. Wartością domyślną jest czarny (0xff000000).
.
Czas rozpoczęcia/zakończenia
Określa kształt, który ma być użyty na początku lub na końcu linii łamanej. Obsługiwane typy wielkich liter: ButtCap, SquareCap, RoundCap (dotyczy ciągów znaków jednolitych) i CustomCap (dotyczy każdego wzorca kreski). Domyślne ustawienie zarówno początku, jak i końca: ButtCap
Typ połączenia
Typ połączenia określa kształt, którego należy użyć przy łączeniu sąsiednich fragmentów linii wierzchołków linii łamanej z wyjątkiem wierzchołków początkowych i końcowych. Zobacz JointType: obsługiwanych typów stawów. Wartością domyślną jest DEFAULT.
Styl kreski
Jednolity (domyślnie, reprezentowany przez null) lub sekwencja PatternItem obiektów który ma zostać powtórzony na linii. Dostępne typy typu PatternItem: Gap (zdefiniowane przez długość przerwy w pikselach), Dash (określana za pomocą szerokości linii i długości przerwy w pikselach) oraz Dot (okrągły, wyśrodkowany na linii, średnica określony za pomocą szerokości linii w pikselach).
Kolejność nakładania elementów
Kolejność, w jakiej rysowana jest nakładka z kafelkami względem innych nakładek (w tym GroundOverlay, TileOverlay, Circle i Polygon, ale nie Marker). Nakładka o większej wartości z-index jest rysowana nad nakładkami o mniejszych indeksy z. Kolejność nakładek z tym samym ustawieniem kolejności nakładania elementów jest dowolna. Domyślna wartość zIndex to 0.
Widoczność
Wskazuje, czy linia łamana jest widoczna czy niewidoczna (czyli czy została narysowana na mapie). An niewidoczna linia łamana nie jest rysowana, ale zachowuje wszystkie jej pozostałe właściwości. Wartość domyślna to true, czyli widoczna.
Stan geodezyjny
Wskazuje, czy segmenty linii łamanej powinny zostać narysowane jako geodezyjna, a nie jako na odwzorowaniu Merkatora. Geodezja to najkrótsza ścieżka między dwiema powierzchniami punkty na powierzchni Ziemi. Krzywa geodezyjna powstaje przy założeniu, że Ziemia jest kula
.
Klikalność
Jeśli chcesz obsługiwać zdarzenia wywoływane po kliknięciu linii łamanej przez użytkownika, ustaw tę właściwość na true W każdej chwili możesz zmienić tę wartość. Wartość domyślna to false. Jeśli jest ustawiona na true, aplikacja będzie otrzymywać powiadomienia do konsoli GoogleMap.OnPolylineClickListener zarejestrowanego do setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).
Tag
Element Object powiązany z linią łamaną. Na przykład Object może zawierać o tym, co reprezentuje linia łamana. To łatwiejsze niż przechowywanie oddzielnego elementu Map<Polyline, Object>. Możesz też powiązać identyfikator String. odpowiadający identyfikatorowi ze zbioru danych. Google Maps SDK na Androida nie odczytuje ani nie odczytuje zapisuje tę właściwość.
Spany
Definiuje rozpiętości przy użyciu różnych stylów używanych do renderowania tej linii łamanej. Możesz użyć tej do tworzenia linii łamanej o różnych parametrach StrokeStyle w różnych segmentach na linii łamanej.

Metody z tej klasy muszą być wywoływane w wątku interfejsu Androida. W przeciwnym razie w czasie działania zostanie zgłoszone żądanie 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 na stronie dewelopera Kształtów. Google.

Podsumowanie metody publicznej

wartość logiczna
równa się(obiekt inny)
Sprawdza, czy ta wartość Polyline jest równa innej.
int,
getColor()
Pobiera kolor tej linii łamanej.
Ograniczenie
getEndCap()
Pobiera ograniczenie na końcowym wierzchołku tej łamanej.
Ciąg znaków
getId()
Pobiera identyfikator tej linii łamanej.
int,
getJointType()
Pobiera typ złączenia używany we wszystkich wierzchołkach linii łamanej z wyjątkiem wierzchołków początkowych i końcowych.
List<PatternItem>
getPattern()
Pobiera wzór kreski tej linii łamanej.
Lista<LatLng>
getPoints()
Zwraca obecnie zrzut wierzchołków tej linii łamanej .
Ograniczenie
getStartCap()
Pobiera limit na wierzchołku początkowym tej łamanej.
Obiekt
getTag()
Pobiera tag linii łamanej.
liczba zmiennoprzecinkowa
getWidth()
Pobiera szerokość tej linii łamanej.
liczba zmiennoprzecinkowa
getZIndex()
Pobiera wartość zIndex tej linii łamanej.
int,
hashCode()
wartość logiczna
isClickable()
Pobiera klikalność linii łamanej.
wartość logiczna
isGeodesic()
Sprawdza, czy każdy odcinek linii jest narysowany jako geodezja.
wartość logiczna
isVisible()
Pobiera widoczność tej linii łamanej.
nieważne
remove()
Usuwa tę linię łamaną z mapy.
nieważne
setClickable(klikalna wartość logiczna)
Określa klikalność linii łamanej.
nieważne
setColor(kolor int.)
Ustawia kolor tej linii łamanej.
nieważne
setEndCap(Cap endCap)
Ustawia limit na końcowym wierzchołku tej linii łamanej.
nieważne
setGeodesic(boolean geodesic)
Określa, czy każdy odcinek linii ma być rysowany jako geodezja.
nieważne
setJointType(int JoinType)
Ustawia typ połączenia dla wszystkich wierzchołków linii łamanej z wyjątkiem wierzchołków początkowych i końcowych.
nieważne
setPattern(wzorzec List<PatternItem>)
Ustawia wzór linii łamanej.
nieważne
setPoints(List<LatLng> pkt)
Ustawia punkty tej linii łamanej.
nieważne
setSpans(Lista spanów o <StyleSpan>)
Ustawia rozpiętości linii łamanej.
nieważne
setStartCap(Cap startCap)
Ustawia limit na wierzchołku początkowym tej łamanej.
nieważne
setTag(tag obiektu)
Ustawia tag dla linii łamanej.
nieważne
setVisible(boolean visible)
Ustawia widoczność tej linii łamanej.
nieważne
setWidth(szerokość zmiennoprzecinkowa)
Ustawia szerokość tej linii łamanej.
nieważne
setZIndex(liczba zmiennoprzecinkowa zIndex)
Ustawia wartość zIndex tej linii łamanej.

Podsumowanie metody dziedziczonej

Metody publiczne

publiczne Wartość logiczna . równa się (inny obiekt)

Sprawdza, czy ta wartość Polyline jest równa innej.

Parametry
inne Object.
Zwroty
  • true (prawda), jeśli oba obiekty są tym samym obiektem, czyli to == inny.

publiczne int, . getColor ()

Pobiera kolor tej linii łamanej.

Zwroty
  • podaliśmy kolor w formacie ARGB.

publiczne Cap getEndCap ()

Pobiera ograniczenie na końcowym wierzchołku tej łamanej.

Zwroty
  • typu reklamy końcowej.

publiczne Ciąg znaków . getId ()

Pobiera identyfikator tej linii łamanej. Identyfikator będzie unikalny wśród wszystkich linii łamanych na mapie.

Zwroty
  • identyfikator tej linii łamanej.

publiczne int, . getJointType ()

Pobiera typ złączenia używany we wszystkich wierzchołkach linii łamanej z wyjątkiem wierzchołków początkowych i końcowych. Zobacz JointType, aby poznać możliwe wartości.

Zwroty
  • i typu stawu.

publiczne List<PatternItem> getPattern ()

Pobiera wzór kreski tej linii łamanej.

Zwroty
  • w zależności od wzoru.

publiczne Lista<LatLng> getPoints ()

Zwraca obecnie zrzut wierzchołków tej linii łamanej . Zwrócona lista jest kopią na liście wierzchołków, dlatego zmiany wierzchołków linii łamanej nie będą przez to odzwierciedlane , a zmiany na tej liście nie będą odzwierciedlane przez linię łamaną. Aby zmienić wierzchołki linia łamana, wywołaj setPoints(List).

publiczne Cap getStartCap ()

Pobiera limit na wierzchołku początkowym tej łamanej.

Zwroty
  • ustaw limit początkowy.

publiczne Obiekt . getTag ()

Pobiera tag linii łamanej.

Zwroty
  • tag, jeśli został on skonfigurowany za pomocą atrybutu setTag; null, jeśli nie ustawiono żadnego tagu.

publiczne liczba zmiennoprzecinkowa . getWidth ()

Pobiera szerokość tej linii łamanej.

Zwroty
  • szerokość w pikselach ekranu.

publiczne liczba zmiennoprzecinkowa . getZIndex ()

Pobiera wartość zIndex tej linii łamanej.

Zwroty
  • wartość zIndex linii łamanej.

publiczne int, . hashCode ()

publiczne Wartość logiczna . isClickable ()

Pobiera klikalność linii łamanej. Jeśli linia łamana jest klikalna, aplikacja otrzyma powiadomienia wysyłane do GoogleMap.OnPolylineClickListener, gdy użytkownik kliknie linia łamana. Detektor zdarzeń jest zarejestrowany przez setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Zwroty
  • true, jeśli linia łamana jest klikalna; w przeciwnym razie zwraca false.

publiczne Wartość logiczna . isGeodesic ()

Sprawdza, czy każdy odcinek linii jest narysowany jako geodezja.

Zwroty
  • true, jeśli każdy segment jest narysowany jako geodezja; false, jeśli każdy segment to narysowanej jako linia prosta na odwzorowaniu Merkatora.

publiczne Wartość logiczna . isVisible ()

Pobiera widoczność tej linii łamanej.

Zwroty
  • widoczność tej linii łamanej.

publiczne nieważne . usuń ()

Usuwa tę linię łamaną z mapy. Po usunięciu linii łamanej zachowanie wszystkich jej łamanych jest niezdefiniowana.

publiczne nieważne . setClickable (klikalna wartość logiczna)

Określa klikalność linii łamanej. Jeśli linia łamana jest klikalna, aplikacja otrzyma powiadomienia wysyłane do GoogleMap.OnPolylineClickListener, gdy użytkownik kliknie linia łamana. Detektor zdarzeń jest zarejestrowany przez setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Parametry
klikalny Nowe ustawienie klikalności dla linii łamanej.

publiczne nieważne . setColor (kolor int.)

Ustawia kolor tej linii łamanej.

Parametry
kolor kolor w formacie ARGB

publiczne nieważne . setEndCap (Limit: po zakończeniu)

Ustawia limit na końcowym wierzchołku tej linii łamanej. Domyślna reklama po zakończeniu filmu to ButtCap.

Parametry
endCap reklamę po zakończeniu filmu. Nie może wynosić null.

publiczne nieważne . setGeodesic (wartość logiczna)

Określa, czy każdy odcinek linii ma być rysowany jako geodezja.

Parametry
geodezyjna jeśli true, każdy odcinek jest narysowany jako geodezja; jeśli false, każdy odcinek jest rysowany jako linia prosta na odwzorowaniu Merkatora.

publiczne nieważne . setJointType (int JoinType)

Ustawia typ połączenia dla wszystkich wierzchołków linii łamanej z wyjątkiem wierzchołków początkowych i końcowych.

Dozwolone wartości znajdziesz tutaj: JointType. Domyślną wartością parametru DEFAULT należy używać, jeśli typ złącza jest niezdefiniowany lub nie należy do dozwolonych wartości.

Parametry
jointType i typu stawu.

publiczne nieważne . setPattern (wzorzec List<PatternItem>)

Ustawia wzór linii łamanej. Domyślny wzór kreski jest pełny. null

Parametry
wzór w zależności od wzoru.

publiczne nieważne . setPoints (ListaLatLng> pkt)

Ustawia punkty tej linii łamanej. Ta metoda spowoduje pobranie kopii punktów, więc dalej mutacje funkcji points nie będą miały wpływu na tę linię łamaną.

Parametry
pkt listę elementów LatLng, które są wierzchołkami linii łamanej.

publiczne nieważne . setSpans (Lista<StyleSpan> spanów)

Ustawia rozpiętości linii łamanej.

Parametry
spany

publiczne nieważne . setStartCap (Limit startowy)

Ustawia limit na wierzchołku początkowym tej łamanej. Domyślna wartość początkowa to ButtCap.

Parametry
startCap ustaw limit początkowy. Nie może wynosić null.

publiczne nieważne . setTag (tag obiektu)

Ustawia tag dla linii łamanej.

Za pomocą tej właściwości możesz powiązać dowolny obiekt Object z tą linią łamaną. Dla: na przykład obiekt Object może zawierać dane o tym, co przedstawia linia łamana. To łatwiejsze niż przechowywanie osobnego pliku Map<Polyline, Object>. Innym przykładem może być powiązanie Identyfikator String odpowiadający identyfikatorowi ze zbioru danych. Google Maps SDK for Android: brak odczytuje ani zapisuje tę właściwość. Musisz zadzwonić pod numer setTag(null), aby rozwiązać ten problem tagu, gdy już go nie potrzebujesz, aby zapobiec wyciekom pamięci w aplikacji.

Parametry
tag Jeśli wartość to null, tag zostanie wyczyszczony.

publiczne nieważne . setVisible (wartość logiczna widoczna)

Ustawia widoczność tej linii łamanej. Jeśli nie jest widoczna, linia łamana nie jest rysowana, ale zachowuje ją wszystkich pozostałych właściwości.

Parametry
widoczna jeśli true, linia łamana jest widoczna; jeśli false, to nie jest.

publiczne nieważne . setWidth (szerokość zmiennoprzecinkowa)

Ustawia szerokość tej linii łamanej.

Parametry
szerokość szerokość w pikselach ekranu

publiczne nieważne . setZIndex (liczba zmiennoprzecinkowa zIndex)

Ustawia wartość zIndex tej linii łamanej. Linie łamane o wyższych wartościach zIndii są rysowane powyżej tych z wartościami niższych indeksów.

Parametry
zIndex wartości zIndex tej linii łamanej.