Dünya yüzeyindeki bir çokgen. Bir poligon dışbükey veya içbükey olabilir, 180 meridyeni kapsayabilir ve içi doldurulmamış delikleri olabilir. Aşağıdaki özelliklere sahiptir:
- Dış Çizgi
- Dış çizgi, saat yönünde veya saat yönünün tersine sıralanmış köşe noktaları listesiyle belirtilir. Başlangıç ve bitiş noktalarının birbiriyle çakışmasına gerek yoktur; örtüşmedikleri takdirde poligon otomatik olarak kapatılır. Çizgi segmentleri, iki yönün kısasındaki (doğu veya batı) ardışık noktalar arasında çizilir.
- Delikler
- Delik, çokgenin içindeki içi doldurulmamış bir bölgedir. Delik, dış çizgiyle tam olarak aynı şekilde belirtilir. Dış çizginin içinde bir delik olmalı. Birden fazla delik belirtilebilir ancak çakışan delikler desteklenmez.
- Fırça Genişliği
- Ekran pikseli cinsinden çizgi segmenti 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
- ARGB biçiminde çizgi segmenti rengi (
Color
tarafından kullanılan biçim). Varsayılan değer siyahtır (0xff000000
). - İnme Eklem Tipi
- Birleştirme türü, poligonun dış çizgisinin tüm köşelerindeki komşu çizgi segmentleri birleştirilirken kullanılacak şekli tanımlar. Desteklenen bağlantı türleri için
JointType
politikasına bakın.DEFAULT
varsayılan değerdir. - Çizgi deseni
- Düz (varsayılan,
null
ile temsil edilir) veya poligonun 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, poligonun dış çizgisine göre ortalanmış, çapı çizgi genişliğiyle piksel cinsinden tanımlanır). - Dolgu Rengi
- Rengi
Color
tarafından kullanılan aynı biçimle ARGB biçiminde doldurun. Varsayılan değer şeffaftır (0x00000000
). Poligon geometrisi doğru bir şekilde belirtilmediyse (yukarıdaki Dış Çizgi ve Delikler için bkz.) dolgu çizilmez. - Z-Endeksi
- Bu poligonun
Polyline
,Circle
,GroundOverlay
veTileOverlay
dahil olmak üzere diğer bindirmelere göre çizilme sırası (Marker
değil). Daha büyük Z-endeksine sahip bir bindirme, daha küçük z endekslerine sahip bindirmelerin üzerinde çizilir. Aynı Z-endeksi değerine sahip yer paylaşımlarının sıralaması rastgeledir. Varsayılan değer 0'dır. - Görünürlük
- Poligonun görünür veya görünmez olup olmadığını, yani haritada çizilip çizilmediğini belirtir. Görünmez bir poligon çizilmez ancak diğer tüm özellikleri korunur. Varsayılan değer,
true
(yani görünür) değeridir. - Jeodezik durum
- Poligonun segmentlerinin, Merkatör projeksiyonunda düz çizgiler yerine jeodezik olarak çizilip çizilmeyeceğini belirtir. Jeodezik, Dünya yüzeyindeki iki nokta arasındaki en kısa yoldur. Jeodezik eğri, Dünya'nın küre olduğu varsayılarak oluşturulur
- Tıklanabilirlik
- Kullanıcı poligonu tıkladığında tetiklenen etkinlikleri işlemek istiyorsanız bu özelliği
true
olarak ayarlayın. Bu değeri istediğiniz zaman değiştirebilirsiniz. Varsayılan değer:false
. Bu özelliktrue
olarak ayarlanırsa uygulamanız,setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
üzerinden kaydedilenGoogleMap.OnPolygonClickListener
için bildirim alır. - Etiket
- Poligonla ilişkili bir
Object
. ÖrneğinObject
, poligonun neyi temsil ettiğine dair veriler içerebilir. Bu, ayrı birMap<Polygon, 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 triangle in the Gulf of Guinea
Polygon polygon = map.addPolygon(new PolygonOptions()
.add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
.strokeColor(Color.RED)
.fillColor(Color.BLUE));
Geliştirici Kılavuzu
Daha fazla bilgi için Şekiller geliştirici kılavuzunu okuyun.
Herkese Açık Yöntem Özeti
boolean | |
int |
getFillColor()
Bu poligonun dolgu rengini alır.
|
List<List<LatLng>> |
getHoles()
Bu poligondaki deliklerin anlık görüntüsünü döndürür .
|
Dize |
getId()
Bu poligonun kimliğini alır.
|
List<LatLng> |
getPoints()
Bu poligonun şu anki köşelerinin anlık görüntüsünü döndürür .
|
int |
getStrokeColor()
Bu poligonun çizgi rengini alır.
|
int |
getStrokeJointType()
Poligonun dış çizgisinin tüm köşelerinde kullanılan fırça birleşimi türünü alır.
|
List<PatternItem> |
getStrokePattern()
Bu poligonun dış çizgisinin çizgi kalıbını elde eder.
|
float |
getStrokeWidth()
Bu poligonun çizgi genişliğini alır.
|
Nesne |
getTag()
Çokgen etiketini alır.
|
float |
getZIndex()
Bu poligonun z Endeksi'ni alır.
|
int |
hashCode()
|
boolean |
isClickable()
Çokgenin tıklanabilirliğini sağlar.
|
boolean |
isGeodesic()
Çizginin her bir parçasının jeodezik olarak çizilip çizilmediğini alır.
|
boolean |
isVisible()
Bu poligonun görünürlüğünü sağlar.
|
void |
remove()
Poligonu haritadan kaldırır.
|
void |
setClickable(tıklanabilir boole)
Çokgenin tıklanabilirliğini ayarlar.
|
void |
setFillColor(int rengi)
Bu poligonun dolgu rengini ayarlar.
|
void |
setGeodesic(boole jeodezik)
Çizginin her bir parçasının jeodezik olarak çizilip çizilmeyeceğini belirler.
|
void | |
void | |
void |
setStrokeColor(int rengi)
Bu poligonun çizgi rengini ayarlar.
|
void |
setStrokeJointType(intjointType)
Çokgenin dış çizgisinin tüm köşeleri için birleşim türünü ayarlar.
|
void | |
void |
setStrokeWidth(kayan genişliği)
Bu poligonun çizgi genişliğini ayarlar.
|
void |
setTag(Nesne etiketi)
Çokgen etiketini ayarlar.
|
void |
setVisible(boole görülebilir)
Bu poligonun görünürlüğünü ayarlar.
|
void |
setZIndex(kayan zIndex)
Bu poligonun z Endeksi'ni ayarlar.
|
Devralınan Yöntem Özeti
Herkese Açık Yöntemler
genel boole eşittir (Nesne diğer)
genel int getFillColor ()
Bu poligonun dolgu rengini alır.
İlerlemeler
- rengi ARGB biçiminde girin.
herkese açık Liste<Liste<LatLng>> getHoles ()
Bu poligondaki deliklerin anlık görüntüsünü döndürür . Döndürülen liste delikler listesinin bir kopyasıdır; dolayısıyla poligonun deliklerinde yapılan değişiklikler bu liste tarafından yansıtılmaz ya da bu listede yapılan değişiklikler poligona yansımaz.
herkese açık Dize getId ()
Bu poligonun kimliğini alır. Kimlik, haritadaki tüm Poligonlar arasında benzersiz olacaktır.
genel Liste<LatLng> getPoints ()
Bu poligonun şu anki köşelerinin anlık görüntüsünü döndürür . Döndürülen liste köşe listesinin bir kopyasıdır ve dolayısıyla poligonun köşelerinde yapılan değişiklikler bu liste tarafından veya bu listede yapılan değişiklikler poligon tarafından yansıtılmaz. Poligonun köşelerini değiştirmek için setPoints(List)
çağrısı yapın.
genel int getStrokeColor ()
Bu poligonun çizgi rengini alır.
İlerlemeler
- rengi ARGB biçiminde girin.
genel int getStrokeJointType ()
Poligonun dış çizgisinin tüm köşelerinde kullanılan fırça birleşimi türünü alır. Olası değerler için JointType
politikasına bakın.
İlerlemeler
- inme eklemi türü.
genel Liste<PatternItem> getStrokePattern ()
Bu poligonun dış çizgisinin çizgi kalıbını elde eder.
İlerlemeler
- çizgisidir.
herkese açık float getStrokeWidth ()
Bu poligonun çizgi genişliğini alır.
İlerlemeler
- ekran pikseli cinsinden genişliği
herkese açık Nesne getTag ()
Çokgen etiketini alır.
İlerlemeler
- bir etiket
setTag
ile ayarlandıysa etiket; hiçbir etiket ayarlanmamışsanull
.
herkese açık float getZIndex ()
Bu poligonun z Endeksi'ni alır.
İlerlemeler
- çokgenin z Endeksi.
genel int hashCode ()
herkese açık boole isClickable ()
Çokgenin tıklanabilirliğini sağlar. Poligon tıklanabilir durumdaysa kullanıcı poligonu tıkladığında uygulamanız GoogleMap.OnPolygonClickListener
içinde bildirim alır.
Etkinlik işleyici setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
aracılığıyla kaydedildi.
İlerlemeler
- Poligon tıklanabilirse
true
; aksi takdirdefalse
değerini döndürür.
herkese açık boole isGeodesic ()
Çizginin her bir parçasının jeodezik olarak çizilip çizilmediğini alır.
İlerlemeler
- her bir segment jeodezik olarak çizilmişse
true
; her bir segment Merkatör projeksiyonu üzerinde düz bir çizgi olarak çizilmişsefalse
.
herkese açık boole isVisible ()
Bu poligonun görünürlüğünü sağlar.
İlerlemeler
- görünürlük sağlıyor.
herkese açık void kaldır ()
Poligonu haritadan kaldırır. Bir poligon kaldırıldıktan sonra tüm yöntemlerinin davranışı tanımlanamaz.
herkese açık void setClickable (boole tıklanabilir)
Çokgenin tıklanabilirliğini ayarlar. Poligon tıklanabilir durumdaysa kullanıcı poligonu tıkladığında uygulamanız GoogleMap.OnPolygonClickListener
içinde bildirim alır.
Etkinlik işleyici setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
aracılığıyla kaydedildi.
Parametreler
tıklanabilir | Çokgen için yeni tıklanabilirlik ayarı. |
---|
herkese açık void setFillColor (int color)
Bu poligonun dolgu rengini ayarlar.
Parametreler
renk | ARGB biçiminde renk |
---|
herkese açık geçersiz setGeodesic (boolean geodesic)
Çizginin her bir parçasının jeodezik olarak çizilip çizilmeyeceğini belirler.
Parametreler
jeodezik | true ise her segment jeodezik olarak çizilir. false ise, her bir segment Merkatör projeksiyonu üzerinde düz bir çizgi olarak çizilir.
|
---|
herkese açık void setHoles (List<? extends List<LatLng>> delikler)
Bu poligonun deliklerini ayarlar. Bu yöntemle deliklerin kopyası alınır. Bu nedenle, holes
üzerinde yapılacak başka mutasyonların bu poligon üzerinde bir etkisi olmaz.
Parametreler
delikler | delikler listesidir. Delikler, LatLng işaretlerinin listesidir.
|
---|
herkese açık void setPoints (List<LatLng> puan)
Bu çokgenin noktalarını ayarlar. Bu yöntemde noktaların kopyası alınır.
Dolayısıyla, points
üzerinde yapılacak başka mutasyonların bu poligon üzerinde bir etkisi olmaz.
Parametreler
puan | poligonun köşe noktaları olan LatLng listesi.
|
---|
herkese açık geçersiz setStrokeColor (int color)
Bu poligonun çizgi rengini ayarlar.
Parametreler
renk | ARGB biçiminde renk |
---|
herkese açık void setStrokeJointType (intjointType)
herkese açık void setStrokePattern (List<PatternItem> desen)
Çokgenin 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)
Bu poligonun çizgi genişliğini ayarlar.
Parametreler
genişlik | ekran pikseli cinsinden genişliği belirleyin. |
---|
herkese açık void setTag (Nesne etiketi)
Çokgen etiketini ayarlar.
İsteğe bağlı bir Object
öğesini bu poligonla ilişkilendirmek için bu özelliği kullanabilirsiniz. Örneğin
Object
, poligonun neyi temsil ettiğine dair veriler içerebilir. Bu, ayrı bir Map<Polygon, 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)
Bu poligonun görünürlüğünü ayarlar. Görünür olmadığında, bir poligon çizilmez, ancak diğer tüm özelliklerini korur.
Parametreler
görünür | true ise poligon görünür durumdadır; false ise görünmez.
|
---|
herkese açık void setZIndex (float zIndex)
Bu poligonun z Endeksi'ni ayarlar. Daha yüksek zendeksi olan poligonlar, daha düşük dizinleri olanların üzerine çizilir.
Parametreler
zIndex | bu poligonun z-endeksi. |
---|