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 sekwencjaPatternItem
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.) iDot
(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
iPolygon
, ale nieMarker
). 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ładObject
może zawierać co odpowiada okręgowi. To łatwiejsze niż przechowywanie oddzielnego elementuMap<Circle, Object>
. Możesz też powiązać identyfikatorString
. 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 | |
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 | |
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 | |
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 ()
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)
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.)
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.)
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. |
---|