Poligon di permukaan bumi. Poligon dapat berupa cembung atau cekung, poligon dapat menjangkau 180 meridian, dan dapat memiliki lubang yang tidak diisi. Laporan ini memiliki properti berikut:
- Outline
- Garis batas ini ditentukan oleh daftar vertex dalam urutan searah jarum jam atau berlawanan arah jarum jam. Titik awal dan akhir tidak perlu bertepatan; jika tidak, poligon akan ditutup secara otomatis. Segmen garis digambar di antara titik berurutan pada bagian yang lebih pendek dari dua arah (timur atau barat).
- Lubang
- Lubang adalah region di dalam poligon yang tidak diisi. Lubang ditetapkan dengan cara yang sama persis seperti garis batas. Lubang harus sepenuhnya tersusun dalam struktur. Beberapa lubang dapat ditentukan, tetapi lubang yang tumpang tindih tidak didukung.
- Lebar Garis Luar
- Lebar segmen garis dalam piksel layar. Lebarnya konstan dan tidak bergantung pada tingkat zoom kamera. Nilai defaultnya adalah 10.
- Warna Garis Luar
- Warna segmen garis dalam format ARGB, format yang sama dengan yang digunakan oleh
Color
. Nilai defaultnya adalah hitam (0xff000000
). - Jenis Sambungan Stroke
- Jenis sambungan menentukan bentuk yang akan digunakan saat menggabungkan segmen garis yang berdekatan di semua verteks poligon. Lihat
JointType
untuk mengetahui jenis sambungan yang didukung. Nilai defaultnya adalahDEFAULT
. - Pola guratan
- Padat (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 guratan dan panjang garis putus-putus dalam piksel) danDot
(melingkar, berpusat pada garis luar poligon, diameter yang ditentukan oleh lebar guratan dalam piksel). - Warna Isian
- Isi warna dalam format ARGB, format yang sama dengan yang digunakan oleh
Color
. Nilai default-nya adalah transparan (0x00000000
). Jika geometri poligon tidak ditentukan dengan benar (lihat di atas untuk Outline dan Lubangan), tidak ada pengisian yang akan digambar. - Indeks Z
- Urutan penggambaran poligon ini berdasarkan overlay lainnya, termasuk
Polyline
,Circle
,GroundOverlay
, danTileOverlay
, tetapi bukanMarker
. Overlay dengan indeks z yang lebih besar akan digambar pada overlay dengan indeks z yang lebih kecil. Urutan overlay dengan nilai indeks z yang sama tidak didukung. Nilai defaultnya adalah 0. - Visibilitas
- Menunjukkan apakah poligon terlihat atau tidak, yaitu apakah poligon digambar pada peta. Poligon yang tidak terlihat tidak digambar, tetapi menyimpan semua properti lainnya. 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
- Kemudahan diklik
- Jika Anda ingin menangani peristiwa yang dipicu 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 keGoogleMap.OnPolygonClickListener
yang terdaftar melaluisetOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
. - Tag
Object
yang terkait dengan poligon. Misalnya,Object
dapat berisi data tentang arti poligon. Hal ini lebih mudah daripada menyimpanMap<Polygon, Object>
secara 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 pada 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 pengisi poligon ini.
|
List<List<LatLng>> |
getHoles()
Menampilkan cuplikan lubang poligon saat ini .
|
String |
getId()
Mendapatkan id poligon ini.
|
Daftar<LatLng> |
getPoints()
Menampilkan snapshot verteks poligon saat ini .
|
int |
getStrokeColor()
Mendapatkan warna guratan poligon ini.
|
int |
getStrokeJointType()
Mendapatkan jenis sambungan guratan yang digunakan pada semua verteks poligon.
|
List<PatternItem> |
getStrokePattern()
Mendapatkan pola guratan garis luar poligon ini.
|
float |
getStrokeWidth()
Mendapatkan lebar guratan poligon ini.
|
Objek |
getTag()
Mendapatkan tag untuk poligon.
|
float |
getZIndex()
Mendapatkan zIndex dari poligon ini.
|
int |
hashCode()
|
boolean |
isClickable()
Mendapatkan kemampuan klik pada 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 untuk poligon.
|
void |
setFillColor(int color)
Menetapkan warna pengisi poligon ini.
|
void |
setGeodesic(geodesi boolean)
Menetapkan apakah akan menggambar setiap segmen garis sebagai geodesi atau tidak.
|
void | |
void | |
void |
setStrokeColor(int color)
Menetapkan warna guratan poligon ini.
|
void |
setStrokeJointType(int joinType)
Menetapkan jenis sambungan untuk semua verteks garis luar poligon.
|
void | |
void |
setStrokeWidth(float lebar)
Menetapkan lebar guratan poligon ini.
|
void |
setTag(Tag objek)
Menetapkan tag untuk poligon.
|
void |
setVisible(boolean terlihat)
Menetapkan visibilitas poligon ini.
|
void |
setZIndex(float zIndex)
Menetapkan zIndex pada poligon ini.
|
Ringkasan Metode Turunan
Metode Publik
boolean publik sama dengan (Objek lainnya)
public int getFillColor ()
Mendapatkan warna pengisi poligon ini.
Hasil
- warnanya dalam format ARGB.
public List<List<LatLng>> getHoles ()
Menampilkan cuplikan lubang poligon saat ini . Daftar yang ditampilkan adalah salinan dari daftar lubang sehingga perubahan pada lubang poligon tidak akan ditunjukkan oleh daftar ini, dan perubahan pada daftar ini tidak akan dicerminkan oleh poligon.
publik String getId ()
Mendapatkan id poligon ini. ID akan bersifat unik di antara semua Poligon pada peta.
public List<LatLng> getPoints ()
Menampilkan snapshot verteks poligon saat ini . Daftar yang dikembalikan adalah salinan
daftar verteks sehingga perubahan pada verteks poligon tidak akan tercermin oleh
daftar ini, dan perubahan pada daftar ini juga tidak akan tercermin oleh poligon. Untuk mengubah verteks
poligon, panggil setPoints(List)
.
int publik getStrokeColor ()
Mendapatkan warna guratan poligon ini.
Hasil
- warnanya dalam format ARGB.
int publik getStrokeJointType ()
Mendapatkan jenis sambungan guratan yang digunakan pada semua verteks poligon. Lihat JointType
untuk mengetahui kemungkinan nilai.
Hasil
- jenis sambungan guratan.
public List<PatternItem> getStrokePattern ()
Mendapatkan pola guratan garis luar poligon ini.
Hasil
- pola guratan.
float publik getStrokeWidth ()
Mendapatkan lebar guratan poligon ini.
Hasil
- lebar dalam piksel 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 poligon.
int publik hashCode ()
boolean publik isClickable ()
Mendapatkan kemampuan klik pada poligon. Jika poligon dapat diklik, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnPolygonClickListener
saat pengguna mengklik poligon.
Pemroses peristiwa terdaftar 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.
publik void remove ()
Menghapus poligon dari peta. Setelah poligon telah dihapus, perilaku semua metodenya tidak ditentukan.
publik void setClickable (boolean dapat diklik)
Menetapkan kemampuan klik untuk poligon. Jika poligon dapat diklik, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnPolygonClickListener
saat pengguna mengklik poligon.
Pemroses peristiwa terdaftar melalui setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
.
Parameter
dapat diklik | Setelan kemampuan diklik baru untuk poligon. |
---|
publik void setFillColor (int color)
Menetapkan warna pengisi poligon ini.
Parameter
warna | warna dalam format ARGB |
---|
publik void setGeodesic (boolean geodesi)
Menetapkan apakah akan menggambar setiap segmen garis sebagai geodesi atau tidak.
Parameter
geodesi | jika true , maka setiap segmen digambar sebagai geodesi; jika false , setiap segmen akan digambar sebagai garis lurus pada proyeksi Mercator.
|
---|
publik void setHoles (List<? memperluas List<LatLng>> hole)
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 adalah daftar LatLng .
|
---|
publik void setPoints (List<LatLng> poin)
Menetapkan titik poligon ini. Metode ini akan mengambil salinan titik, sehingga mutasi lebih lanjut pada points
tidak akan berpengaruh pada poligon ini.
Parameter
poin | daftar LatLng yang merupakan verteks poligon.
|
---|
publik void setStrokeColor (int color)
Menetapkan warna guratan poligon ini.
Parameter
warna | warna dalam format ARGB |
---|
publik void setStrokeJointType (int joinType)
publik void setStrokePattern (List<PatternItem> pattern)
Menetapkan pola guratan garis luar poligon. Pola guratan default solid, diwakili oleh null
.
Parameter
pola | pola guratan. |
---|
publik void setStrokeWidth (lebar float)
Menetapkan lebar guratan poligon ini.
Parameter
lebar | lebar dalam piksel tampilan. |
---|
publik 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 apa yang diwakili oleh poligon. Hal ini lebih mudah daripada menyimpan Map<Polygon, Object>
yang 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 untuk memanggil setTag(null)
untuk menghapus tag saat tidak diperlukan lagi, guna mencegah kebocoran memori di aplikasi Anda.
Parameter
tag | jika null, tag akan dihapus. |
---|
publik void setVisible (booleanvisible)
Menetapkan visibilitas poligon ini. Jika tidak terlihat, poligon tidak digambar, tetapi semua properti lainnya akan disimpan.
Parameter
terlihat | jika true , maka poligon akan terlihat; jika false , tidak ada.
|
---|
publik void setZIndex (float zIndex)
Menetapkan zIndex pada poligon ini. Poligon dengan indeks z yang lebih tinggi akan digambar di atas poligon dengan indeks lebih rendah.
Parameter
Indeks | zIndex poligon ini. |
---|