Daire

herkese açık son sınıf Circle Nesneyi genişletir

Dünyanın yüzeyindeki bir daire (küresel başlık).

Bir daire aşağıdaki özelliklere sahiptir.

Orta alan oyuncusu
Dairenin merkezi LatLng olarak belirtilir.
Yarıçap
Dairenin metre cinsinden belirtilen yarıçapı. Sıfır veya daha büyük olmalıdır.
Fırça Genişliği
Dairenin dış çizgisinin ekran pikseli cinsinden genişliği. Genişlik sabittir ve kameranın yakınlaştırma düzeyinden bağımsızdır. Varsayılan değer 10'dur.
Fırça Rengi
Daire dış çizgisinin ARGB biçimindeki rengi (Color tarafından kullanılan biçim). Varsayılan değer siyahtır (0xff000000).
Çizgi deseni
Düz (varsayılan, null ile temsil edilir) veya dairenin dış çizgisi boyunca tekrarlanacak PatternItem nesne dizisi. Kullanılabilir PatternItem türleri: Gap (piksel cinsinden boşluk uzunluğuyla tanımlanır), Dash (piksel cinsinden çizgi genişliği ve çizgi uzunluğuyla tanımlanır) ve Dot (dairesel, dairenin dış çizgisine ortalanmış, çapı piksel cinsinden çizgi genişliğiyle tanımlanır).
Dolgu Rengi
Dairenin rengi ARGB biçimindedir, Color tarafından kullanılan biçimdir. Varsayılan değer şeffaftır (0x00000000).
Z-Endeksi
Bu karo yer paylaşımının diğer yer paylaşımlarına göre çizilme sırası (GroundOverlay, TileOverlay, Polyline ve Polygon dahil ancak Marker değil). Daha büyük Z-endeksine sahip bir bindirme, daha küçük z endekslerine sahip bindirmelerin üzerinde çizilir. Aynı Z-endeksine sahip yer paylaşımlarının sıralaması rastgeledir. Varsayılan zEndeksi 0'dır.
Görünürlük
Dairenin görünür olup olmadığını (harita üzerinde çizilip çizilmediğini) belirtir. Görünmez bir daire çizilmez ancak diğer tüm özellikleri korunur. Varsayılan değer, true (yani görünür) değeridir.
Etiket
Çevreyle ilişkili bir Object. Örneğin, Object, dairenin neyi temsil ettiğine dair veriler içerebilir. Bu, ayrı bir Map<Circle, Object> depolamaktan daha kolaydır. Başka bir örnek olarak, veri kümesindeki kimliğe karşılık gelen bir String kimliğini ilişkilendirebilirsiniz. Android için Google Haritalar SDK'sı bu özelliği okumaz veya yazmaz.

Bu sınıftaki yöntemler Android kullanıcı arayüzü iş parçacığında çağrılmalıdır. Aksi takdirde, çalışma zamanında bir IllegalStateException atılır.

Örnek

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

Daire Kuzey veya Güney kutbunu içeriyorsa, geçerli harita oluşturucunun dairenin dolgusunu çizemeyeceğini unutmayın. Ancak dış çizgi yine de doğru çizilebilir.

Geliştirici Kılavuzu

Daha fazla bilgi için Şekiller geliştirici kılavuzunu okuyun.

Herkese Açık Yöntem Özeti

LatLng
getCenter()
Merkezi LatLng olarak döndürür.
int
getFillColor()
Bu Dairenin dolgu rengini döndürür.
Dize
getId()
Bu çevrenin kimliğini alır.
double
getRadius()
Dairenin yarıçapını metre cinsinden döndürür.
int
getStrokeColor()
Fırça rengini döndürür.
List<PatternItem>
getStrokePattern()
Bu dairenin dış çizgisinin çizgi kalıbını döndürür.
float
getStrokeWidth()
Fırça genişliğini döndürür.
Nesne
getTag()
Çevrenin etiketini alır.
float
getZIndex()
z Endeksini döndürür.
boolean
isClickable()
Dairenin tıklanabilirliğini sağlar.
boolean
isVisible()
Çevrenin görünür olup olmadığını kontrol eder.
void
remove()
Bu daireyi haritadan kaldırır.
void
setCenter(LatLng merkezi)
Merkezi bir LatLng kullanarak ayarlar.
void
setClickable(tıklanabilir boole)
Dairenin tıklanabilirliğini ayarlar.
void
setFillColor(int rengi)
Dolgu rengini ayarlar.
void
setRadius(çift yarıçap)
Yarıçapı metre cinsinden ayarlar.
void
setStrokeColor(int rengi)
Fırça rengini ayarlar.
void
setStrokePattern(Liste<PatternItem> desen)
Dairenin dış çizgisinin çizgi desenini ayarlar.
void
setStrokeWidth(kayan genişliği)
Fırça genişliğini ayarlar.
void
setTag(Nesne etiketi)
Çevre için etiketi ayarlar.
void
setVisible(boole görülebilir)
Çevrenin görünürlüğünü ayarlar.
void
setZIndex(kayan zIndex)
z Endeksini ayarlar.

Devralınan Yöntem Özeti

Herkese Açık Yöntemler

herkese açık LatLng getCenter ()

Merkezi LatLng olarak döndürür.

İlerlemeler
  • LatLng olarak coğrafi merkez.

genel int getFillColor ()

Bu Dairenin dolgu rengini döndürür.

İlerlemeler
  • Dairenin ARGB biçimindeki dolgu rengi.

herkese açık Dize getId ()

Bu çevrenin kimliğini alır. Kimlik, haritadaki tüm Çevreler arasında benzersiz olacaktır.

herkese açık double getRadius ()

Dairenin yarıçapını metre cinsinden döndürür.

İlerlemeler
  • Metre cinsinden yarıçap.

genel int getStrokeColor ()

Fırça rengini döndürür.

İlerlemeler
  • Dairenin ARGB biçimindeki rengi.

genel Liste<PatternItem> getStrokePattern ()

Bu dairenin dış çizgisinin çizgi kalıbını döndürür.

İlerlemeler
  • çizgisidir.

herkese açık float getStrokeWidth ()

Fırça genişliğini döndürür.

İlerlemeler
  • Ekran pikseli cinsinden genişlik.

herkese açık Nesne getTag ()

Çevrenin etiketini alır.

İlerlemeler
  • bir etiket setTag ile ayarlandıysa etiket; hiçbir etiket ayarlanmamışsa null.

herkese açık float getZIndex ()

z Endeksini döndürür.

İlerlemeler
  • Bu dairenin z Endeksi.

herkese açık boole isClickable ()

Dairenin tıklanabilirliğini sağlar. Daire tıklanabilir durumdaysa kullanıcı daireyi tıkladığında uygulamanız GoogleMap.OnCircleClickListener cihazına bildirim alır. Etkinlik işleyici setOnCircleClickListener(GoogleMap.OnCircleClickListener) aracılığıyla kaydedildi.

İlerlemeler
  • Daire tıklanabilirse true; tıklanabilir değilse false.

herkese açık boole isVisible ()

Çevrenin görünür olup olmadığını kontrol eder.

İlerlemeler
  • Daire görünürse true; görünmezse false.

herkese açık void kaldır ()

Bu daireyi haritadan kaldırır. Bir çevre kaldırıldıktan sonra, çevredeki tüm yöntemlerin davranışı tanımsız hale gelir.

herkese açık void setCenter (LatLng merkezi)

Merkezi bir LatLng kullanarak ayarlar.

Varsayılan değer olmadığı için merkez boş olmamalıdır.

Parametreler
orta Çemberin coğrafi merkezi, LatLng ile belirtilir.
Dekoratif yastıklar
NullPointerException merkez null ise

herkese açık void setClickable (boole tıklanabilir)

Dairenin tıklanabilirliğini ayarlar. Daire tıklanabilir durumdaysa kullanıcı daireyi tıkladığında uygulamanız GoogleMap.OnCircleClickListener cihazına bildirim alır. Etkinlik işleyici setOnCircleClickListener(GoogleMap.OnCircleClickListener) aracılığıyla kaydedildi.

Parametreler
tıklanabilir Çevre için yeni tıklanabilirlik ayarı.

herkese açık void setFillColor (int color)

Dolgu rengini ayarlar.

Dolgu rengi, Color ile belirtilen tam sayı biçiminde dairenin içindeki renktir. TRANSPARENT kullanılırsa dolgu çizilmez.

Parametreler
renk Color biçimindeki renk.

herkese açık void setRadius (çift yarıçap)

Yarıçapı metre cinsinden ayarlar.

Yarıçap sıfır veya daha büyük olmalıdır.

Parametreler
yarıçap Metre cinsinden yarıçap.
Dekoratif yastıklar
IllegalArgumentException yarıçap negatifse

herkese açık geçersiz setStrokeColor (int color)

Fırça rengini ayarlar.

Fırça rengi, bu dairenin dış çizgisinin rengidir ve Color ile belirtilen tam sayı biçimindedir. ŞEFFAFLIK kullanılırsa anahat çizilmez.

Parametreler
renk Color biçimindeki fırça rengi.

herkese açık void setStrokePattern (List<PatternItem> desen)

Dairenin dış çizgisinin çizgi desenini ayarlar. Varsayılan çizgi deseni düz ve null ile temsil ediliyor.

Parametreler
desen çizgisidir.

herkese açık void setStrokeWidth (kayan genişliği)

Fırça genişliğini ayarlar.

Fırça genişliği, dairenin dış çizgisinin genişliğidir (ekran pikseli cinsinden). Sıfır veya daha büyük olmalıdır. Sıfır ise anahat çizilmez. Varsayılan değer 10'dur.

Parametreler
genişlik Ekran pikseli cinsinden fırça genişliği.
Dekoratif yastıklar
IllegalArgumentException genişlik negatifse

herkese açık void setTag (Nesne etiketi)

Çevre için etiketi ayarlar.

Rastgele bir Object öğesini bu çevreyle ilişkilendirmek için bu özelliği kullanabilirsiniz. Örneğin, Object, dairenin neyi temsil ettiğine dair veriler içerebilir. Bu, ayrı bir Map<Circle, Object> depolamaktan daha kolaydır. Başka bir örnek olarak, veri kümesindeki kimliğe karşılık gelen bir String kimliğini ilişkilendirebilirsiniz. Android için Google Haritalar SDK'sı bu özelliği okumaz veya yazmaz. Uygulamanızdaki bellek sızıntılarını önlemek üzere artık ihtiyacınız kalmadığında etiketi temizlemek için setTag(null) öğesini çağırmak sizin sorumluluğunuzdadır.

Parametreler
etiket null ise etiket temizlenir.

herkese açık void setVisible (boolean visible)

Çevrenin görünürlüğünü ayarlar.

Bu daire görünür değilse çizilmez. Diğer tüm durumlar korunur. Çevreler varsayılan olarak görünür durumdadır.

Parametreler
görünür Bu çevreyi görünür yapmak için true; görünmez yapmak için false.

herkese açık void setZIndex (float zIndex)

z Endeksini ayarlar.

Daha yüksek ZEndeksleri olan bindirmeler (daireler gibi), düşük dizinleri olan bindirmelerin üzerine çizilir.

Parametreler
zIndex zIndex değeri.