Poligon di permukaan bumi. Poligon bisa berbentuk cembung atau cekung, dapat meliputi meridian 180 dan dapat memiliki lubang yang tidak terisi. Class tersebut memiliki properti berikut:
- Garis keliling
- Garis luar ditentukan oleh daftar verteks dalam urutan searah jarum jam atau berlawanan arah jarum jam. Titik awal dan titik akhir tidak perlu bertepatan; jika tidak bertepatan, poligon akan ditutup secara otomatis. Segmen garis digambar di antara titik berurutan di bagian yang lebih pendek dari dua arah (timur atau barat).
- Lubang
- Lubang adalah wilayah di dalam poligon yang tidak diisi. Lubang ditetapkan dengan cara yang persis sama seperti garis batas. Lubang harus sepenuhnya berada di dalam garis batas. Beberapa lubang dapat ditentukan, tetapi lubang yang tumpang tindih tidak didukung.
- Lebar Goresan
- Lebar segmen garis dalam piksel layar. Lebarnya konstan dan tidak bergantung pada tingkat zoom kamera. Nilai defaultnya adalah 10.
- Warna Goresan
- Warna segmen garis dalam format ARGB, format yang sama dengan yang digunakan oleh
Color
. Nilai defaultnya adalah hitam (0xff000000
). - Jenis Sambungan Goresan
- Jenis sambungan menentukan bentuk yang akan digunakan saat menggabungkan segmen garis yang berdekatan di semua verteks dari garis luar poligon. Lihat
JointType
untuk mengetahui jenis sambungan yang didukung. Nilai defaultnya adalahDEFAULT
. - Pola guratan
- Solid (default, diwakili oleh
null
) atau urutan objekPatternItem
yang akan diulang di sepanjang garis luar poligon. JenisPatternItem
yang tersedia:Gap
(ditentukan oleh panjang celah dalam piksel),Dash
(ditentukan oleh lebar goresan dan panjang garis dalam piksel), danDot
(melingkar, yang berpusat pada garis batas poligon, diameter yang ditentukan oleh lebar goresan dalam piksel). - Warna Pengisi
- Isi warna dalam format ARGB, format yang sama dengan yang digunakan oleh
Color
. Nilai defaultnya adalah transparan (0x00000000
). Jika geometri poligon tidak ditentukan dengan benar (lihat di atas untuk Outline dan Lubang), maka tidak ada isian yang akan digambar. - Indeks Z
- Urutan penggambaran poligon ini sehubungan dengan overlay lain, termasuk
Polyline
,Circle
,GroundOverlay
, danTileOverlay
, tetapi bukanMarker
. Overlay dengan indeks z yang lebih besar digambar di atas overlay dengan indeks z yang lebih kecil. Urutan overlay dengan nilai indeks z yang sama bersifat tidak tentu. Nilai defaultnya adalah 0. - Visibilitas
- Menunjukkan apakah poligon terlihat atau tidak terlihat, yaitu apakah poligon itu digambar di peta. Poligon
yang tidak terlihat tidak digambar, tetapi mempertahankan semua propertinya yang lain. Defaultnya adalah
true
, yaitu terlihat. - Status geodesi
- Menunjukkan apakah segmen poligon harus digambar sebagai geodesi, bukan garis lurus pada proyeksi Mercator. Geodesi adalah jalur terpendek antara dua titik di permukaan bumi. Kurva geodesi dibuat dengan asumsi Bumi adalah bola dunia
- Kemampuan diklik
- Jika Anda ingin menangani peristiwa yang diaktifkan saat pengguna mengklik poligon, tetapkan properti ini ke
true
. Anda dapat mengubah nilai ini kapan saja. Defaultnya adalahfalse
. Jika properti ini disetel ketrue
, aplikasi Anda akan menerima notifikasi diGoogleMap.OnPolygonClickListener
yang terdaftar melaluisetOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
. - Tag
Object
yang terkait dengan poligon. Misalnya,Object
dapat berisi data tentang hal yang diwakili oleh poligon. Hal ini lebih mudah daripada menyimpanMap<Polygon, Object>
terpisah. Sebagai contoh lainnya, Anda dapat mengaitkan IDString
yang sesuai dengan ID dari set data. Google Maps SDK for Android tidak membaca atau menulis properti ini.
Metode di class ini harus dipanggil di UI thread Android. Jika tidak, IllegalStateException
akan ditampilkan saat runtime.
Contoh
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));
Panduan Developer
Untuk informasi selengkapnya, baca panduan developer Bentuk.
Ringkasan Metode Publik
boolean |
sama dengan(Objek lainnya)
Menguji apakah
Polygon ini sama dengan yang lain. |
int |
getFillColor()
Mendapatkan warna isian poligon ini.
|
List<List<LatLng>> |
getHoles()
Menampilkan cuplikan lubang poligon ini sekarang .
|
String |
getId()
Mendapatkan ID poligon ini.
|
List<LatLng> |
getPoints()
Menampilkan verteks dari poligon ini sekarang .
|
int |
getStrokeColor()
Mendapatkan warna goresan poligon ini.
|
int |
getStrokeJointType()
Mendapatkan jenis sambungan goresan yang digunakan di semua verteks dari garis luar poligon.
|
List<PatternItem> |
getStrokePattern()
Mendapatkan pola goresan garis luar poligon ini.
|
float |
getStrokeWidth()
Mendapatkan lebar goresan poligon ini.
|
Object |
getTag()
Mendapatkan tag untuk poligon.
|
float |
getZIndex()
Mendapatkan zIndex dari poligon ini.
|
int |
hashCode()
|
boolean |
isClickable()
Mendapatkan kemampuan diklik poligon.
|
boolean |
isGeodesic()
Mendapatkan apakah setiap segmen garis digambar sebagai geodesi atau tidak.
|
boolean |
isVisible()
Mendapatkan visibilitas poligon ini.
|
void |
remove()
Menghapus poligon dari peta.
|
void |
setClickable(boolean dapat diklik)
Menetapkan kemampuan klik poligon.
|
void |
setFillColor(int color)
Menetapkan warna isian poligon ini.
|
void |
setGeodesic(boolean geodesi)
Menetapkan apakah akan menggambar setiap segmen garis sebagai geodesi atau tidak.
|
void | |
void | |
void |
setStrokeColor(int color)
Menetapkan warna goresan poligon ini.
|
void |
setStrokeJointType(int joinType)
Menetapkan jenis sambungan untuk semua verteks dari garis luar poligon.
|
void | |
void |
setStrokeWidth(lebar float)
Menetapkan lebar goresan poligon ini.
|
void |
setTag(Tag objek)
Menetapkan tag untuk poligon.
|
void |
setVisible(boolean terlihat)
Menetapkan visibilitas poligon ini.
|
void |
setZIndex(float zIndex)
Menetapkan zIndex untuk poligon ini.
|
Ringkasan Metode Turunan
Metode Publik
boolean publik sama dengan (Objek lainnya)
public int getFillColor ()
Mendapatkan warna isian poligon ini.
Hasil
- warna dalam format ARGB.
public List<List<LatLng>> getHoles ()
Menampilkan cuplikan lubang poligon ini sekarang . Daftar yang ditampilkan adalah salinan daftar lubang sehingga perubahan lubang poligon tidak akan ditunjukkan oleh daftar ini, dan perubahan daftar ini juga tidak akan dicerminkan oleh poligon.
public String getId ()
Mendapatkan ID poligon ini. ID ini akan unik di antara semua Poligon pada peta.
publik Daftar<LatLng> getPoints ()
Menampilkan verteks dari poligon ini sekarang . Daftar yang ditampilkan adalah salinan
daftar verteks sehingga perubahan verteks poligon tidak akan ditunjukkan oleh
daftar ini, dan perubahan daftar ini juga tidak akan ditunjukkan oleh poligon. Untuk mengubah verteks poligon, panggil setPoints(List)
.
public int getStrokeColor ()
Mendapatkan warna goresan poligon ini.
Hasil
- warna dalam format ARGB.
public int getStrokeJointType ()
Mendapatkan jenis sambungan goresan yang digunakan di semua verteks dari garis luar poligon. Lihat JointType
untuk nilai yang memungkinkan.
Hasil
- jenis sambungan goresan.
public List<PatternItem> getStrokePattern ()
Mendapatkan pola goresan garis luar poligon ini.
Hasil
- pola goresan.
float publik getStrokeWidth ()
Mendapatkan lebar goresan poligon ini.
Hasil
- lebar dalam {i>pixel<i} layar.
publik Objek getTag ()
Mendapatkan tag untuk poligon.
Hasil
- tag jika tag ditetapkan dengan
setTag
;null
jika tidak ada tag yang ditetapkan.
float publik getZIndex ()
Mendapatkan zIndex dari poligon ini.
Hasil
- zIndex dari poligon.
public int hashCode ()
boolean publik isClickable ()
Mendapatkan kemampuan diklik poligon. Jika poligon dapat diklik, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnPolygonClickListener
saat pengguna mengklik poligon.
Pemroses peristiwa didaftarkan melalui setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
.
Hasil
true
jika poligon dapat diklik; jika tidak, menampilkanfalse
.
boolean publik isGeodesic ()
Mendapatkan apakah setiap segmen garis digambar sebagai geodesi atau tidak.
Hasil
true
jika setiap segmen digambar sebagai geodesi;false
jika setiap segmen digambar sebagai garis lurus pada proyeksi Mercator.
boolean publik isVisible ()
Mendapatkan visibilitas poligon ini.
Hasil
- visibilitas poligon ini.
public void remove ()
Menghapus poligon dari peta. Setelah poligon dihapus, perilaku semua metodenya tidak ditentukan.
publik void setClickable (boolean dapat diklik)
Menetapkan kemampuan klik poligon. Jika poligon dapat diklik, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnPolygonClickListener
saat pengguna mengklik poligon.
Pemroses peristiwa didaftarkan melalui setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
.
Parameter
dapat diklik | Setelan kemampuan diklik baru untuk poligon. |
---|
public void setFillColor (int color)
Menetapkan warna isian poligon ini.
Parameter
warna | warna dalam format ARGB |
---|
publik void setGeodesic (boolean geodesic)
Menetapkan apakah akan menggambar setiap segmen garis sebagai geodesi atau tidak.
Parameter
geodesi | jika true , setiap segmen akan digambar sebagai geodesi; jika false , setiap segmen akan digambar sebagai garis lurus pada proyeksi Mercator.
|
---|
publik void setHoles (List<? memperluas lubang List<LatLng>>)
Menetapkan lubang poligon ini. Metode ini akan mengambil salinan lubang, sehingga mutasi lebih lanjut ke holes
tidak akan berpengaruh pada poligon ini.
Parameter
lubang | daftar lubang, dengan lubang berupa daftar LatLng .
|
---|
public void setPoints (List<LatLng> poin)
Menetapkan titik poligon ini. Metode ini akan mengambil salinan titik, sehingga mutasi lebih lanjut ke points
tidak akan berpengaruh pada poligon ini.
Parameter
poin | daftar LatLng yang merupakan verteks poligon.
|
---|
public void setStrokeColor (int color)
Menetapkan warna goresan poligon ini.
Parameter
warna | warna dalam format ARGB |
---|
public void setStrokeJointType (int joinType)
public void setStrokePattern (List<PatternItem> pattern)
Menetapkan pola goresan garis luar poligon. Pola goresan default adalah solid, diwakili oleh null
.
Parameter
pola | pola goresan. |
---|
public void setStrokeWidth (lebar float)
Menetapkan lebar goresan poligon ini.
Parameter
lebar | lebar dalam piksel tampilan. |
---|
public void setTag (Tag objek)
Menetapkan tag untuk poligon.
Anda dapat menggunakan properti ini untuk mengaitkan Object
arbitrer dengan poligon ini. Misalnya, Object
dapat berisi data tentang hal yang diwakili oleh poligon. Hal ini lebih mudah daripada menyimpan Map<Polygon, Object>
terpisah. Sebagai contoh lainnya, Anda dapat mengaitkan ID String
yang sesuai dengan ID dari set data. Google Maps SDK for Android tidak membaca atau menulis properti ini. Anda bertanggung jawab memanggil setTag(null)
untuk menghapus
tag saat tidak diperlukan lagi, guna mencegah kebocoran memori dalam aplikasi.
Parameter
tag | jika null, tag akan dihapus. |
---|
publik void setVisible (boolean visible)
Menetapkan visibilitas poligon ini. Jika tidak terlihat, poligon tidak akan digambar, tetapi mempertahankan semua properti lainnya.
Parameter
terlihat | jika true , maka poligon akan terlihat; jika false , poligon tidak terlihat.
|
---|
public void setZIndex (float zIndex)
Menetapkan zIndex untuk poligon ini. Poligon dengan zIndice yang lebih tinggi digambar di atas yang memiliki indeks lebih rendah.
Parameter
zIndex | zIndex dari poligon ini. |
---|