Çokgen

herkese açık final sınıfı Polygon Nesneyi genişletir

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 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, 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 ve TileOverlay 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 özellik true olarak ayarlanırsa uygulamanız, setOnPolygonClickListener(GoogleMap.OnPolygonClickListener) üzerinden kaydedilen GoogleMap.OnPolygonClickListener için bildirim alır.
Etiket
Poligonla ilişkili bir Object. Ö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.

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
eşittir(Diğer nesne)
Bu Polygon öğesinin başka bir değere eşit olup olmadığını test eder.
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
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
setHoles(Liste<? extends List<LatLng>> delikleri)
Bu poligonun deliklerini ayarlar.
void
setPoints(Liste<LatLng> puanı)
Bu çokgenin noktalarını ayarlar.
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
setStrokePattern(Liste<PatternItem> desen)
Çokgenin dış çizgisinin çizgi desenini ayarlar.
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)

Bu Polygon öğesinin başka bir değere eşit olup olmadığını test eder.

Parametreler
diğer bir Object.
İlerlemeler
  • Her iki nesne de aynı nesneyse doğru değerini döndürür, yani bu == 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ışsa null.

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 takdirde false 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şse false.

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)

Çokgenin dış çizgisinin tüm köşeleri için birleşim türünü ayarlar.

İzin verilen değerler için JointType politikasına bakın. Ortak türü tanımlanmamışsa veya izin verilen değerlerden biri değilse DEFAULT varsayılan değeri kullanılır.

Parametreler
jointType inme eklemi türü.

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.