Okrąg

publiczna klasa końcowy Circle rozszerza obiekt

Okrąg na powierzchni Ziemi (czapka sferyczna).

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

Środkowy
Środek kręgu jest określony jako LatLng.
Promień
Promień okręgu określony w metrach. Wartość powinna wynosić zero lub więcej.
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 kreski
Kolor obramowania okręgu w formacie ARGB, taki sam jak format używany przez aplikację Color. Wartością domyślną jest czarny (0xff000000).
Styl kreski
Ciągła (domyślnie, reprezentowana przez null) lub sekwencja PatternItem obiektów do powtórzenia na obrysie okręgu. Dostępne typy PatternItem: Gap (zdefiniowane jako długość przerwy w pikselach), Dash (zdefiniowane jako szerokość kreski i długość kreski w pikselach) i Dot (okrągły, wyśrodkowany na obrysie okręgu, średnica określona przez szerokość kreski w pikselach).
Kolor wypełnienia
Kolor okręgu jest zgodny z formatem ARGB stosowanym w witrynie Color. Wartość domyślna to przezroczysty (0x00000000).
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, Polyline 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 okrąg jest widoczny czy niewidoczny, tj. czy jest narysowany na mapie. Niewidoczny okrąg nie jest rysowany, ale zachowuje wszystkie swoje pozostałe właściwości. Wartość domyślna to true, czyli widoczna.
Oznacz
Object powiązane z kręgiem. Na przykład obiekt Object może zawierać dane o tym, co reprezentuje okrąg. To łatwiejsze niż przechowywanie osobnego elementu Map<Circle, 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.

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 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 obecnie mechanizm renderowania mapy nie może narysować wypełnienia okręgu, jeśli okrąg obejmuje biegun północny lub południowy. Kontur zostanie jednak narysowany prawidłowo.

Przewodnik dla programistów

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

Podsumowanie metod publicznych

LatLng
getCenter()
Zwraca środek jako LatLng.
int
getFillColor()
Zwraca kolor wypełnienia tego okręgu.
Ciąg znaków
getId()
Pobiera identyfikator tego kręgu.
liczba zmiennoprzecinkowa
getRadius(),
Zwraca promień okręgu w metrach.
int
getStrokeColor()
Zwraca kolor kreski.
List<PatternItem>
getStrokePattern()
Zwraca wzór obramowania konturu tego okręgu.
float
getStrokeWidth(),
Zwraca szerokość kreski.
Obiekt
getTag()
Pobiera tag okręgu.
float
getZIndex(),
Zwraca wartość zIndex.
boolean
isClickable()
Pobiera klikalność kręgu.
boolean
isVisible(),
Sprawdza, czy okrąg jest widoczny.
void
remove()
Usuwa ten okrąg z mapy.
void
setCenter(w środku LatLng)
Wyśrodkowuje za pomocą LatLng.
void
setClickable(wartość logiczna)
Ustawia klikalność kręgu.
void
setFillColor(kolor wewnętrzny)
Ustawia kolor wypełnienia.
void
setRadius(podwójny promień)
Ustawia promień w metrach.
void
setStrokeColor(kolor wewnętrzny)
Ustawia kolor kreski.
void
setStrokePattern(wzorzec List<PatternItem>)
Ustawia wzór kreski konturu okręgu.
void
setStrokeWidth(szerokość zmiennoprzecinkowa)
Ustawia szerokość kreski.
void
setTag(tag obiektu)
Ustawia tag kręgu.
void
setVisible(widoczna wartość logiczna)
Ustawia widoczność kręgu.
void
setZIndex(zIndex z wykorzystaniem liczby zmiennoprzecinkowej)
Ustawia wartość zIndex.

Podsumowanie metod dziedziczonych

Metody publiczne

publiczna LatLng getCenter ()

Zwraca środek jako LatLng.

Akcje powrotne
  • Centrum geograficzne jako LatLng.

public int getFillColor ()

Zwraca kolor wypełnienia tego okręgu.

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

public String getId ()

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

public Double getRadius ()

Zwraca promień okręgu w metrach.

Akcje powrotne
  • Promień w metrach.

public int getStrokeColor ()

Zwraca kolor kreski.

Akcje powrotne
  • Kolor okręgu w formacie ARGB.

public List<PatternItem> getStrokePattern ()

Zwraca wzór obramowania konturu tego okręgu.

Akcje powrotne
  • na wzór kreski.

public float getStrokeWidth ()

Zwraca szerokość kreski.

Akcje powrotne
  • Szerokość w pikselach ekranu.

public Object getTag ()

Pobiera tag okręgu.

Akcje powrotne
  • jeśli tag został ustawiony o wartości setTag lub null, jeśli nie ustawiono żadnego tagu.

public float getZIndex ()

Zwraca wartość zIndex.

Akcje powrotne
  • Wartość zIndex tego kręgu.

public boolean isClickable ()

Pobiera klikalność kręgu. Jeśli okrąg będzie klikalny, aplikacja będzie otrzymywać powiadomienia do GoogleMap.OnCircleClickListener, gdy użytkownik go kliknie. Detektor zdarzeń jest zarejestrowany przez setOnCircleClickListener(GoogleMap.OnCircleClickListener).

Akcje powrotne
  • true, jeśli okrąg można kliknąć; false, jeśli nie jest klikalny.

public boolean isVisible ()

Sprawdza, czy okrąg jest widoczny.

Akcje powrotne
  • true, jeśli okrąg jest widoczny, lub false, jeśli jest niewidoczny.

public void remove ()

Usuwa ten okrąg z mapy. Po usunięciu kręgu działanie wszystkich jego metod staje się nieokreślone.

public void setCenter (LatLng środek)

Wyśrodkowuje za pomocą LatLng.

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

Parametry
pośrodku Geograficznie środek okręgu opisanego jako LatLng.
Rzuty
NullPointerException jeśli środek ma wartość null

public void setClickable (wartość logiczna)

Ustawia klikalność kręgu. Jeśli okrąg będzie klikalny, aplikacja będzie otrzymywać powiadomienia do GoogleMap.OnCircleClickListener, gdy użytkownik go kliknie. Detektor zdarzeń jest zarejestrowany przez setOnCircleClickListener(GoogleMap.OnCircleClickListener).

Parametry
możliwe kliknięcie Nowe ustawienie klikalności kręgu.

public void setFillColor (int color)

Ustawia kolor wypełnienia.

Kolor wypełnienia to kolor wewnątrz okręgu i podany jako liczba całkowita określona przez Color. Jeśli użyjesz filtra TRANSPARENT, nie rysuje się żadne wypełnienie.

Parametry
kolor Kolor w formacie Color.

public void setRadius (podwójny promień)

Ustawia promień w metrach.

Promień musi wynosić zero lub więcej.

Parametry
obszar o określonym promieniu Promień w metrach.
Rzuty
IllegalArgumentException jeśli promień jest ujemny

public void setStrokeColor (int color)

Ustawia kolor kreski.

Kolor kreski to kolor konturu tego okręgu i jest on podawany jako liczba całkowita określona przez Color. Jeśli użyjesz parametru TRANSPARENT, obrys nie zostanie narysowany.

Parametry
kolor Kolor kreski w formacie Color.

public void setStrokePattern (List<PatternItem> wzór)

Ustawia wzór kreski konturu okręgu. Domyślny wzór kreski jest ciągły i reprezentowany przez null.

Parametry
wzór na wzór kreski.

public void setStrokeWidth (szerokości zmiennoprzecinkowe)

Ustawia szerokość kreski.

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

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

public void setTag (tag obiektu)

Ustawia tag kręgu.

Za pomocą tej właściwości możesz powiązać dowolny Object z tym kręgiem. Na przykład obiekt Object może zawierać dane o tym, co reprezentuje okrąg. Jest to łatwiejsze niż przechowywanie osobnego elementu Map<Circle, Object>. Możesz też powiązać identyfikator String odpowiadający identyfikatorowi ze zbioru danych. Pakiet SDK Map Google na Androida nie odczytuje ani nie zapisuje tej właściwości. Twoim obowiązkiem jest wywołanie metody setTag(null) w celu usunięcia tagu, gdy nie będzie już potrzebny. Zapobiegnie to wyciekom pamięci w aplikacji.

Parametry
tag Jeśli wartość to null, tag jest usuwany.

public void setVisible (boolean visible)

Ustawia widoczność kręgu.

Jeśli okrąg nie jest widoczny, nie zostanie narysowany. Pozostały stan jest zachowywany. Kręgi są domyślnie widoczne.

Parametry
widoczna true, aby ten krąg był widoczny, lub false, aby go niewidoczny.

public void setZIndex (float zIndex)

Ustawia wartość zIndex.

Nakładki (np. okręgi) o wyższej wartości z indeksów są rysowane powyżej tych z niższymi indeksami.

Parametry
zIndex Wartość zIndex.