Okrąg

publiczne zajęcia końcowe Krąg rozszerza obiekt

Okrąg na powierzchni Ziemi (kulka).

Okrąg ma następujące właściwości.

Wyśrodkuj
Środkowy krąg jest określony jako LatLng.
Promień
Promień okręgu określony w metrach. Wartość powinna być równa zero lub większa.
Szerokość kreski
Szerokość konturu okręgu w pikselach ekranu. Szerokość jest stała i niezależna od poziomu powiększenia. Wartością domyślną jest 10.
Kolor konturu
Kolor obrysu okręgu w formacie ARGB, taki sam jak w przypadku elementu Color. Wartością domyślną jest czarny (0xff000000).
.
Styl kreski
Jednolity (domyślnie, reprezentowany przez null) lub sekwencja PatternItem obiektów ma być powtórzona wzdłuż konturów okręgu. Dostępne typy (PatternItem): Gap (zdefiniowana przez długość przerwy w pikselach), Dash (określona przez szerokość kreski i długość kreski w pikselach) piks.) i Dot (okrągły, wyśrodkowany na obrysie okręgu, średnica definiowana przez szerokość kreski w pikselach).
Kolor wypełnienia
Kolor okręgu jest wypełniany w formacie ARGB, czyli w formacie Color. Wartością domyślną jest przezroczysta (0x00000000).
.
Kolejność nakładania elementów
Kolejność, w jakiej rysowana jest nakładka z kafelkami względem innych nakładek (w tym GroundOverlay, TileOverlay, Polyline 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 okrąg jest widoczny czy niewidoczny – czyli czy został narysowany na mapie. An niewidoczne koło nie jest narysowane, ale zachowuje wszystkie jego pozostałe właściwości. Wartość domyślna to true, czyli widoczna.
Tag
Object powiązane z kręgiem. Na przykład Object może zawierać co odpowiada okręgowi. To łatwiejsze niż przechowywanie oddzielnego elementu Map<Circle, 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 circle in Sydney
 Circle circle = map.addCircle(new CircleOptions()
     .center(new LatLng(-33.87365, 151.20689))
     .radius(10000)
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));
 

Pamiętaj, że bieżący mechanizm renderowania mapy nie może narysować okręgu wypełnionego, jeśli obejmuje biegun północny lub południowy. Konspekt zostanie nadal narysowany. .

Przewodnik dla programistów

Więcej informacji znajdziesz na stronie dewelopera Kształtów. Google.

Podsumowanie metody publicznej

LatLng
getCenter()
Zwraca środek jako obiekt LatLng.
int,
getFillColor()
Zwraca kolor wypełnienia tego okręgu.
Ciąg znaków
getId()
Pobiera identyfikator tego kręgu.
double,
getRadius()
Zwraca promień okręgu w metrach.
int,
getStrokeColor()
Zwraca kolor kreski.
List<PatternItem>
getStrokePattern()
Zwraca wzór kreski danego okręgu.
liczba zmiennoprzecinkowa
getStrokeWidth()
Zwraca szerokość kreski.
Obiekt
getTag()
Pobiera tag kręgu.
liczba zmiennoprzecinkowa
getZIndex()
Zwraca wartość zIndex.
wartość logiczna
isClickable()
Pobiera klikalność okręgu.
wartość logiczna
isVisible()
Sprawdza, czy okrąg jest widoczny.
nieważne
remove()
Usuwa ten okrąg z mapy.
nieważne
setCenter(LatLng)
Ustawia środek w środku za pomocą czujnika LatLng.
nieważne
setClickable(klikalna wartość logiczna)
Określa klikalność okręgu.
nieważne
setFillColor(kolor int.)
Określa kolor wypełnienia.
nieważne
setRadius(podwójny promień)
Ustawia promień w metrach.
nieważne
setStrokeColor(kolor int.)
Ustawia kolor kreski.
nieważne
setStrokePattern(wzorzec List<PatternItem>)
Ustawia wzór linii konturu okręgu.
nieważne
setStrokeWidth(szerokość zmiennoprzecinkową)
Ustawia szerokość kreski.
nieważne
setTag(tag obiektu)
Ustawia tag dla kręgu.
nieważne
setVisible(boolean visible)
Ustawia widoczność kręgu.
nieważne
setZIndex(liczba zmiennoprzecinkowa zIndex)
Ustawia wartość zIndex.

Podsumowanie metody dziedziczonej

Metody publiczne

publiczne LatLng getCenter ()

Zwraca środek jako obiekt LatLng.

Zwroty
  • Środek geograficzny jako LatLng.

publiczne int, . getFillColor ()

Zwraca kolor wypełnienia tego okręgu.

Zwroty
  • Kolor wypełnienia okręgu w formacie ARGB.

publiczne Ciąg znaków . getId ()

Pobiera identyfikator tego kręgu. Identyfikator będzie niepowtarzalny wśród wszystkich kręgów na mapie.

publiczne liczba zmiennoprzecinkowa . getRadius ()

Zwraca promień okręgu w metrach.

Zwroty
  • Promień w metrach.

publiczne int, . getStrokeColor ()

Zwraca kolor kreski.

Zwroty
  • Kolor okręgu w formacie ARGB.

publiczne List<PatternItem> getStrokePattern ()

Zwraca wzór kreski danego okręgu.

Zwroty
  • w zależności od wzoru.

publiczne liczba zmiennoprzecinkowa . getStrokeWidth ()

Zwraca szerokość kreski.

Zwroty
  • Szerokość w pikselach ekranu.

publiczne Obiekt . getTag ()

Pobiera tag kręgu.

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

publiczne liczba zmiennoprzecinkowa . getZIndex ()

Zwraca wartość zIndex.

Zwroty
  • Wartość zIndex tego okręgu.

publiczne Wartość logiczna . isClickable ()

Pobiera klikalność okręgu. Jeśli okrąg można kliknąć, aplikacja otrzyma powiadomienia wysyłane do GoogleMap.OnCircleClickListener, gdy użytkownik kliknie ten krąg. Detektor zdarzeń jest zarejestrowany przez setOnCircleClickListener(GoogleMap.OnCircleClickListener).

Zwroty
  • true, jeśli okrąg jest klikalny; false, jeśli nie jest klikalny.

publiczne Wartość logiczna . isVisible ()

Sprawdza, czy okrąg jest widoczny.

Zwroty
  • true, jeśli okrąg jest widoczny; false, jeśli jest niewidoczny.

publiczne nieważne . usuń ()

Usuwa ten okrąg z mapy. Po usunięciu kręgu zachowanie wszystkich jego kręgów jest niezdefiniowana.

publiczne nieważne . setCenter (LatLng)

Ustawia środek w środku za pomocą czujnika LatLng.

Środek nie może mieć wartości null, ponieważ nie ma wartości domyślnej.

Parametry
do środka Środek geograficzny okręgu określony jako LatLng.
Rzuty
NullPointerException jeśli środek ma wartość null

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

Określa klikalność okręgu. Jeśli okrąg można kliknąć, aplikacja otrzyma powiadomienia wysyłane do GoogleMap.OnCircleClickListener, gdy użytkownik kliknie ten krąg. Detektor zdarzeń jest zarejestrowany przez setOnCircleClickListener(GoogleMap.OnCircleClickListener).

Parametry
klikalny Nowe ustawienie klikalności kręgu.

publiczne nieważne . setFillColor (kolor int.)

Określa kolor wypełnienia.

Kolor wypełnienia to kolor wewnątrz okręgu, w formacie liczby całkowitej określonym przez Color. Jeśli używana jest opcja TRANSPARENT, nie będzie narysowane żadne wypełnienie.

Parametry
kolor Kolor w formacie Color.

publiczne nieważne . setRadius (podwójny promień)

Ustawia promień w metrach.

Promień musi wynosić zero lub więcej.

Parametry
promień Promień w metrach.
Rzuty
IllegalArgumentException jeśli promień jest ujemny

publiczne nieważne . setStrokeColor (kolor int.)

Ustawia kolor kreski.

Kolor kreski to kolor konturu okręgu w formacie liczby całkowitej określonym przez Color Jeśli użyjesz opcji TRANSPARENT, nie zostanie narysowany żaden kontur.

Parametry
kolor Kolor kreski w formacie Color.

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

Ustawia wzór linii konturu okręgu. 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.

Szerokość kreski to szerokość (w pikselach ekranu) obrysu okręgu. Wartość musi wynosić zero lub większa wartość. Jeśli ma wartość zero, kontur nie jest narysowany. Wartością domyślną jest 10.

Parametry
szerokość Szerokość kreski ekranu w pikselach ekranu.
Rzuty
IllegalArgumentException jeśli szerokość jest ujemna

publiczne nieważne . setTag (tag obiektu)

Ustawia tag dla kręgu.

Za pomocą tej usługi możesz powiązać dowolne pole Object z tym kręgiem. Dla: np. Object może zawierać dane o tym, co przedstawia okrąg. To łatwiejsze niż przechowywanie osobnego pliku Map<Circle, 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ść kręgu.

Jeśli okrąg nie jest widoczny, nie zostanie narysowany. Pozostałe stany są zachowywane. Kręgi są domyślnie widoczne.

Parametry
widoczna true, aby ten krąg był widoczny; false, aby ukryć go.

publiczne nieważne . setZIndex (liczba zmiennoprzecinkowa zIndex)

Ustawia wartość zIndex.

Nakładki (np. okręgi) z wyższymi wskaźnikami zIndii są rysowane powyżej tych o niższych indeksach.

Parametry
zIndex Wartość zIndex.