Wielokąt

publiczne zajęcia końcowe Wielokąt rozszerza obiekt

Wielokąt na powierzchni Ziemi. Wielokąt może być wypukły lub wklęsły, może obejmować 180 południk 180° i mogą mieć niewypełnione otwory. Ma następujące właściwości:

Konspekt
Konspekt jest określony za pomocą listy wierzchołków w kolejności w kierunku ruchu wskazówek zegara lub przeciwnie do ruchu wskazówek zegara. it nie jest konieczne, aby punkt początkowy i końcowy zbiegły się w czasie; w przeciwnym razie wielokąt zostanie automatycznie zamknięta. Odcinki linii są rysowane między kolejnymi punktami w krótszym z dwóch kierunków (wschód lub zachód).
Przerwy
Dziura to niewypełniony obszar wewnątrz wielokąta. Otwór jest podawany dokładnie w tak samo jak kontur. Otwór musi być w pełni ograniczony do obrysu. Wiele można określić otwory, jednak nakładające się otwory nie są obsługiwane.
Szerokość kreski
Szerokość segmentu linii w pikselach ekranu. Szerokość jest stała i niezależna od poziom powiększenia. Wartością domyślną jest 10.
Kolor konturu
Kolor segmentu w formacie ARGB, taki sam jak w przypadku elementu Color. Wartością domyślną jest czarny (0xff000000).
.
Rodzaj złącza udaru
Typ połączenia określa kształt, którego należy użyć przy łączeniu sąsiednich fragmentów linii wierzchołków obrysu wielokąta. Obsługiwane typy złączy znajdziesz tutaj: JointType. wartość domyślna to DEFAULT.
Styl kreski
Jednolity (domyślnie, reprezentowany przez null) lub sekwencja PatternItem obiektów ma być powtórzona wzdłuż konturów wielokąta. Dostępne typy PatternItem: Gap (określone przez długość przerwy w pikselach), Dash (określone za pomocą szerokości kreski i kreski) długość w pikselach) i Dot (kołowy, wyśrodkowany na obrysie wielokąta, średnica definiowane przez szerokość kreski w pikselach).
Kolor wypełnienia
Kolor wypełnienia w formacie ARGB – ten sam format jak w przypadku aplikacji Color. Wartość domyślna to przezroczysta (0x00000000). Jeśli nie określono geometrii wielokąta (zobacz powyżej w sekcji Kontury i Otwory), nie zostanie narysowane żadne wypełnienie.
Kolejność nakładania elementów
Kolejność rysowania wielokąta względem innych nakładek, takich jak Polyline, Circle, GroundOverlay i TileOverlay, ale nie Marker. Nakładka o większej wartości z-index jest rysowana nad nakładkami o mniejszych indeksy z. Kolejność nakładek o tej samej wartości z-index jest dowolna. Wartość domyślna to 0.
Widoczność
Wskazuje, czy wielokąt jest widoczny czy niewidoczny – czyli czy został narysowany na mapie. An niewidoczny wielokąt nie zostaje narysowany, ale zachowuje wszystkie jego pozostałe właściwości. Wartość domyślna to true, czyli widoczna.
Stan geodezyjny
Wskazuje, czy segmenty wielokąta powinny być narysowane jako geodezja, 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 wielokąta 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.OnPolygonClickListener zarejestrowanego do setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).
Tag
Element Object powiązany z wielokątem. Na przykład Object może zawierać o tym, co reprezentuje wielokąt. To łatwiejsze niż przechowywanie oddzielnego elementu Map<Polygon, 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ść.

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

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ść Polygon jest równa innej.
int,
getFillColor()
Pobiera kolor wypełnienia tego wielokąta.
Lista<List<LatLng>>
getHoles()
Zwraca obecnie zdjęcie otworów tego wielokąta .
Ciąg znaków
getId()
Pobiera identyfikator tego wielokąta.
Lista<LatLng>
getPoints()
Zwraca obecnie migawkę wierzchołków tego wielokąta .
int,
getStrokeColor()
Pobiera kolor kreski tego wielokąta.
int,
getStrokeJointType()
Pobiera typ połączenia kreskowego używany we wszystkich wierzchołkach obrysu wielokąta.
List<PatternItem>
getStrokePattern()
Pobiera wzorzec kreski tego wielokąta.
liczba zmiennoprzecinkowa
getStrokeWidth()
Pobiera szerokość kreski tego wielokąta.
Obiekt
getTag()
Pobiera tag wielokąta.
liczba zmiennoprzecinkowa
getZIndex()
Pobiera wartość zIndex tego wielokąta.
int,
hashCode()
wartość logiczna
isClickable()
Pobiera klikalność wielokąta.
wartość logiczna
isGeodesic()
Sprawdza, czy każdy odcinek linii jest narysowany jako geodezja.
wartość logiczna
isVisible()
Pobiera widoczność tego wielokąta.
nieważne
remove()
Usuwa wielokąt z mapy.
nieważne
setClickable(klikalna wartość logiczna)
Określa klikalność wielokąta.
nieważne
setFillColor(kolor int.)
Ustawia kolor wypełnienia wielokąta.
nieważne
setGeodesic(boolean geodesic)
Określa, czy każdy odcinek linii ma być rysowany jako geodezja.
nieważne
setHoles(List<? extends List<LatLng>> otwory)
Ustawia otwory w tym wielokątie.
nieważne
setPoints(List<LatLng> pkt)
Ustawia punkty tego wielokąta.
nieważne
setStrokeColor(kolor int.)
Ustawia kolor kreski tego wielokąta.
nieważne
setStrokeJointType(int JoinType)
Ustawia typ połączenia dla wszystkich wierzchołków obrysu wielokąta.
nieważne
setStrokePattern(wzorzec List<PatternItem>)
Ustawia wzór linii konturu wielokąta.
nieważne
setStrokeWidth(szerokość zmiennoprzecinkową)
Ustawia szerokość kreski tego wielokąta.
nieważne
setTag(tag obiektu)
Ustawia tag wielokąta.
nieważne
setVisible(boolean visible)
Ustawia widoczność tego wielokąta.
nieważne
setZIndex(liczba zmiennoprzecinkowa zIndex)
Ustawia wartość zIndex dla tego wielokąta.

Podsumowanie metody dziedziczonej

Metody publiczne

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

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

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

publiczne int, . getFillColor ()

Pobiera kolor wypełnienia tego wielokąta.

Zwroty
  • podaliśmy kolor w formacie ARGB.

publiczne Lista<List<LatLng>> getHoles ()

Zwraca obecnie zdjęcie otworów tego wielokąta . Zwrócona lista to kopia lista otworów, czyli wszystkie zmiany otworów wielokąta, nie będzie przez nią odzwierciedlana. zmiany na tej liście będą odzwierciedlane przez wielokąt.

publiczne Ciąg znaków . getId ()

Pobiera identyfikator tego wielokąta. Identyfikator będzie unikalny wśród wszystkich wielokątów na mapie.

publiczne Lista<LatLng> getPoints ()

Zwraca obecnie migawkę wierzchołków tego wielokąta . Zwrócona lista jest kopią na liście wierzchołków, przez co zmiany wierzchołków wielokąta nie będą przez nie odzwierciedlane , a zmiany na tej liście nie będą odzwierciedlane przez wielokąt. Aby zmienić wierzchołki wielokąt, wywołaj setPoints(List).

publiczne int, . getStrokeColor ()

Pobiera kolor kreski tego wielokąta.

Zwroty
  • podaliśmy kolor w formacie ARGB.

publiczne int, . getStrokeJointType ()

Pobiera typ połączenia kreskowego używany we wszystkich wierzchołkach obrysu wielokąta. Zobacz JointType pod kątem możliwych wartości.

Zwroty
  • rodzaj stawu udarowego.

publiczne List<PatternItem> getStrokePattern ()

Pobiera wzorzec kreski tego wielokąta.

Zwroty
  • w zależności od wzoru.

publiczne liczba zmiennoprzecinkowa . getStrokeWidth ()

Pobiera szerokość kreski tego wielokąta.

Zwroty
  • szerokość w pikselach ekranu.

publiczne Obiekt . getTag ()

Pobiera tag wielokąta.

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

publiczne liczba zmiennoprzecinkowa . getZIndex ()

Pobiera wartość zIndex tego wielokąta.

Zwroty
  • wartość zIndex wielokąta.

publiczne int, . hashCode ()

publiczne Wartość logiczna . isClickable ()

Pobiera klikalność wielokąta. Jeśli wielokąt można kliknąć, aplikacja otrzyma powiadomienia do GoogleMap.OnPolygonClickListener, gdy użytkownik kliknie wielokąt. Detektor zdarzeń jest zarejestrowany przez setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Zwroty
  • true, jeśli wielokąt jest klikalny; 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ść tego wielokąta.

Zwroty
  • widoczność tego wielokąta.

publiczne nieważne . usuń ()

Usuwa wielokąt z mapy. Po usunięciu wielokąta zachowanie wszystkich jego elementów jest niezdefiniowana.

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

Określa klikalność wielokąta. Jeśli wielokąt można kliknąć, aplikacja otrzyma powiadomienia do GoogleMap.OnPolygonClickListener, gdy użytkownik kliknie wielokąt. Detektor zdarzeń jest zarejestrowany przez setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Parametry
klikalny Nowe ustawienie klikalności wielokąta.

publiczne nieważne . setFillColor (kolor int.)

Ustawia kolor wypełnienia wielokąta.

Parametry
kolor kolor w formacie ARGB

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 . setHoles (Lista<? rozszerza otwory listy<LatLng>>)

Ustawia otwory w tym wielokątie. Ta metoda spowoduje pobranie kopii dziur, więc kolejne mutacje do holes nie będzie miało wpływu na ten wielokąt.

Parametry
dołki lista otworów, gdzie otwory to lista LatLng s.

publiczne nieważne . setPoints (ListaLatLng> pkt)

Ustawia punkty tego wielokąta. Ta metoda spowoduje pobranie kopii punktów, więc dalej mutacje funkcji points nie będą miały wpływu na ten wielokąt.

Parametry
pkt listę elementów LatLng będących wierzchołkami wielokąta.

publiczne nieważne . setStrokeColor (kolor int.)

Ustawia kolor kreski tego wielokąta.

Parametry
kolor kolor w formacie ARGB

publiczne nieważne . setStrokeJointType (int JoinType)

Ustawia typ połączenia dla wszystkich wierzchołków obrysu wielokąta.

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 rodzaj stawu udarowego.

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

Ustawia wzór linii konturu wielokąta. Domyślny wzór kreski jest pełny. reprezentowane przez: null.

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

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

Ustawia szerokość kreski tego wielokąta.

Parametry
szerokość szerokość w pikselach displayowych.

publiczne nieważne . setTag (tag obiektu)

Ustawia tag wielokąta.

Za pomocą tej właściwości możesz powiązać z tym wielokątem dowolne pole Object. Dla: Object może na przykład zawierać dane tego, co reprezentuje wielokąt. To łatwiejsze niż przechowywanie osobnego pliku Map<Polygon, 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ść tego wielokąta. Gdy wielokąt nie jest widoczny, nie jest rysowany, ale zachowuje wszystkie elementy jego pozostałych właściwości.

Parametry
widoczna jeśli true, wielokąt jest widoczny; jeśli false, to nie jest.

publiczne nieważne . setZIndex (liczba zmiennoprzecinkowa zIndex)

Ustawia wartość zIndex dla tego wielokąta. Wielokąty o wyższych wartościach zIndii są rysowane nad tymi o niższych indeksy.

Parametry
zIndex wartość zIndex tego wielokąta.