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 tekrarlanacakPatternItem
nesne dizisi. KullanılabilirPatternItem
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) veDot
(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
vePolygon
dahil ancakMarker
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ı birMap<Circle, Object>
depolamaktan daha kolaydır. Başka bir örnek olarak, veri kümesindeki kimliğe karşılık gelen birString
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 | |
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 | |
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 | |
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 ()
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ışsanull
.
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ğilsefalse
.
herkese açık boole isVisible ()
Çevrenin görünür olup olmadığını kontrol eder.
İlerlemeler
- Daire görünürse
true
; görünmezsefalse
.
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)
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)
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)
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. |
---|