Polygon

class final publik Poligon memperluas Objek

Poligon pada permukaan bumi. Poligon bisa berbentuk cembung atau cekung, bisa menjangkau sudut 180 meridian dan bisa memiliki lubang yang tidak terisi. Properti tersebut memiliki properti berikut:

Garis batas
Garis batas ditentukan oleh daftar verteks dalam urutan searah jarum jam atau berlawanan arah jarum jam. Ini tidak perlu titik awal dan akhir bertepatan; jika tidak, poligon akan akan ditutup secara otomatis. Segmen garis digambar di antara titik yang berurutan dalam dari dua arah (timur atau barat).
Lubang
Lubang adalah area di dalam poligon yang tidak diisi. Lubang ditentukan dengan cara sama seperti garis besarnya. Sebuah lubang harus sepenuhnya terkandung dalam garis batas. Beberapa lubang dapat ditentukan, namun lubang yang tumpang tindih tidak didukung.
Lebar Goresan
Lebar segmen garis dalam piksel layar. Lebarnya konstan dan tidak bergantung pada kamera tingkat zoom. 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 semua segmen garis yang berdekatan verteks garis luar poligon. Lihat JointType untuk mengetahui jenis sambungan yang didukung. Tujuan nilai defaultnya adalah DEFAULT.
Pola guratan
Solid (default, diwakili oleh null) atau urutan objek PatternItem untuk diulang di sepanjang garis batas poligon. Jenis PatternItem yang tersedia: Gap (ditentukan oleh panjang celah dalam piksel), Dash (ditentukan oleh lebar goresan dan tanda pisah panjang dalam piksel) dan Dot (melingkar, dipusatkan pada garis luar, diameter poligon didefinisikan oleh lebar goresan dalam piksel).
Warna Pengisi
Isi warna dalam format ARGB, format yang sama dengan yang digunakan oleh Color. Tujuan nilai defaultnya adalah transparan (0x00000000). Jika geometri poligon tidak ditentukan dengan benar (lihat di atas untuk Garis Besar dan Lubang), maka tidak ada isian yang akan digambar.
Indeks Z
Urutan menggambar poligon ini terkait dengan overlay lain, termasuk Polyline, Circle, GroundOverlay, dan TileOverlay, tetapi tidak Marker. Overlay dengan indeks z yang lebih besar digambar di atas overlay dengan indeks z. Urutan overlay dengan nilai indeks z yang sama tidak didukung. Defaultnya adalah 0.
Visibilitas
Menunjukkan apakah poligon terlihat atau tidak terlihat, yaitu apakah poligon digambar di peta. Channel poligon tak terlihat tidak digambar, namun mempertahankan semua properti lainnya. Defaultnya adalah true, yaitu, terlihat.
Status geodesi
Menunjukkan apakah segmen poligon harus digambar sebagai geodesi, atau bukan garis lurus pada proyeksi Mercator. Geodesi adalah jalur terpendek antara dua titik-titik di permukaan bumi. Kurva geodesi dibuat dengan asumsi Bumi adalah bola
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 adalah false. Jika ini disetel ke true, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnPolygonClickListener yang didaftarkan melalui setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).
Tag
Object yang terkait dengan poligon. Misalnya, Object dapat berisi data tentang apa yang direpresentasikan oleh poligon. Ini lebih mudah daripada menyimpan Map<Polygon, Object> terpisah. Sebagai contoh lainnya, Anda dapat mengaitkan ID String sesuai dengan ID dari set data. Google Maps SDK for Android tidak membaca atau yang 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 developer Bentuk kami.

Ringkasan Metode Publik

boolean
sama dengan(Objek lainnya)
Menguji apakah Polygon ini sama dengan yang lain.
int
getFillColor()
Mendapatkan warna pengisi poligon ini.
Daftar<List<LatLng>>
getHoles()
Menampilkan cuplikan lubang poligon ini sekarang .
String
getId()
Mendapatkan ID poligon ini.
Daftar<LatLng>
getPoints()
Menampilkan cuplikan verteks dari poligon ini sekarang .
int
getStrokeColor()
Mendapatkan warna goresan poligon ini.
int
getStrokeJointType()
Mendapatkan jenis sambungan goresan yang digunakan di semua verteks garis luar poligon.
Daftar<PatternItem>
getStrokePattern()
Mendapatkan pola goresan garis luar poligon ini.
float
getStrokeWidth()
Mendapatkan lebar goresan poligon ini.
Objek
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 diklik poligon.
void
setFillColor(int color)
Menetapkan warna isian poligon ini.
void
setGeodesic(boolean geodesic)
Menetapkan apakah akan menggambar setiap segmen garis sebagai geodesi atau bukan.
void
setHoles(Daftar<? memperluas lubang Daftar<LatLng>>)
Menetapkan lubang poligon ini.
void
setPoints(Daftar<LatLng> poin)
Menetapkan titik poligon ini.
void
setStrokeColor(int color)
Menetapkan warna goresan poligon ini.
void
setStrokeJointType(int joinType)
Menetapkan jenis sambungan untuk semua verteks garis luar poligon.
void
setStrokePattern(pola Daftar<PatternItem>)
Menetapkan pola goresan garis batas poligon.
void
setStrokeWidth(lebar mengambang)
Menetapkan lebar goresan poligon ini.
void
setTag(Tag objek)
Menetapkan tag untuk poligon.
void
setVisible(boolean visible)
Menetapkan visibilitas poligon ini.
void
setZIndex(float zIndex)
Menetapkan zIndex poligon ini.

Ringkasan Metode Turunan

Metode Publik

publik boolean sama dengan (Objek lainnya)

Menguji apakah Polygon ini sama dengan yang lain.

Parameter
lainnya Object.
Hasil
  • true jika kedua objek adalah objek yang sama, yaitu, ini == other.

publik Int getFillColor ()

Mendapatkan warna pengisi poligon ini.

Hasil
  • warna dalam format ARGB.

publik Daftar<List<LatLng>> getHoles ()

Menampilkan cuplikan lubang poligon ini sekarang . Daftar yang dikembalikan adalah salinan dari daftar lubang dan perubahan pada lubang poligon tidak akan ditunjukkan oleh daftar ini, ataupun akan perubahan pada daftar ini direfleksikan oleh poligon.

publik {i>String<i} getId ()

Mendapatkan ID poligon ini. ID akan bersifat unik di antara semua Poligon pada peta.

publik Daftar<LatLng> getPoints ()

Menampilkan cuplikan verteks dari poligon ini sekarang . Daftar yang ditampilkan adalah salinan daftar verteks sehingga perubahan pada verteks poligon tidak akan ditunjukkan oleh daftar, maupun perubahan pada daftar ini tidak akan direfleksikan oleh poligon. Untuk mengubah verteks poligon, panggil setPoints(List).

publik Int getStrokeColor ()

Mendapatkan warna goresan poligon ini.

Hasil
  • warna dalam format ARGB.

publik Int getStrokeJointType ()

Mendapatkan jenis sambungan goresan yang digunakan di semua verteks garis luar poligon. Lihat JointType untuk nilai yang mungkin.

Hasil
  • jenis sambungan goresan.

publik Daftar<PatternItem> getStrokePattern ()

Mendapatkan pola goresan garis luar poligon ini.

Hasil
  • pola guratan.

publik mengambang getStrokeWidth ()

Mendapatkan lebar goresan poligon ini.

Hasil
  • selebar piksel layar.

publik Objek getTag ()

Mendapatkan tag untuk poligon.

Hasil
  • tag jika tag ditetapkan dengan setTag; null jika tidak ada tag yang ditetapkan.

publik mengambang getZIndex ()

Mendapatkan zIndex dari poligon ini.

Hasil
  • zIndex poligon.

publik Int hashCode ()

publik boolean isClickable ()

Mendapatkan kemampuan diklik 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, akan menampilkan false.

publik boolean isGeodesic ()

Mendapatkan apakah setiap segmen garis digambar sebagai geodesi atau tidak.

Hasil
  • true jika setiap segmen digambar sebagai geodesi; false jika setiap segmen yang digambar sebagai garis lurus pada proyeksi Mercator.

publik boolean isVisible ()

Mendapatkan visibilitas poligon ini.

Hasil
  • visibilitas poligon ini.

publik kosong hapus ()

Menghapus poligon dari peta. Setelah poligon dihapus, perilaku semua poligon metode tidak terdefinisi.

publik kosong setClickable (boolean dapat diklik)

Menetapkan kemampuan diklik 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 klik baru untuk poligon.

publik kosong setFillColor (int color)

Menetapkan warna isian poligon ini.

Parameter
warna warna dalam format ARGB

publik kosong setGeodesic (geodesi boolean)

Menetapkan apakah akan menggambar setiap segmen garis sebagai geodesi atau bukan.

Parameter
geodesi jika true, maka setiap segmen digambar sebagai geodesi; jika false, setiap segmen digambar sebagai garis lurus pada proyeksi Mercator.

publik kosong setHoles (Daftar<? memperluas lubang<LatLng>>)

Menetapkan lubang poligon ini. Metode ini akan mengambil salinan lubang itu, jadi mutasi lebih lanjut ke holes tidak akan berpengaruh pada poligon ini.

Parameter
lubang daftar lubang, dengan lubang adalah daftar LatLng.

publik kosong setPoints (Daftar<LatLng> poin)

Menetapkan titik poligon ini. Metode ini akan mengambil salinan poin, jadi langkah selanjutnya mutasi ke points tidak akan berpengaruh pada poligon ini.

Parameter
poin daftar LatLng yang merupakan verteks poligon.

publik kosong setStrokeColor (int color)

Menetapkan warna goresan poligon ini.

Parameter
warna warna dalam format ARGB

publik kosong setStrokeJointType (int joinType)

Menetapkan jenis sambungan untuk semua verteks garis luar poligon.

Lihat JointType untuk mengetahui nilai yang diizinkan. Nilai default DEFAULT akan digunakan jika jenis gabungan tidak ditentukan atau bukan salah satu dari nilai yang diizinkan.

Parameter
jointType jenis sambungan goresan.

publik kosong setStrokePattern (Pola daftar<PatternItem>)

Menetapkan pola goresan garis batas poligon. Pola {i>stroke<i} {i>default<i} adalah solid, yang diwakili oleh null.

Parameter
pola pola guratan.

publik kosong setStrokeWidth (lebar mengambang)

Menetapkan lebar goresan poligon ini.

Parameter
lebar lebarnya dalam piksel tampilan.

publik kosong setTag (Tag objek)

Menetapkan tag untuk poligon.

Anda dapat menggunakan properti ini untuk mengaitkan Object arbitrer dengan poligon ini. Sebagai misalnya, Object dapat berisi data tentang apa yang diwakili poligon tersebut. 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 juga membaca atau menulis properti ini. Anda bertanggung jawab memanggil setTag(null) untuk menghapus tag saat Anda tidak lagi memerlukannya, untuk mencegah kebocoran memori di aplikasi.

Parameter
tag jika null, tag akan dihapus.

publik kosong setVisible (boolean terlihat)

Menetapkan visibilitas poligon ini. Jika tidak terlihat, poligon tidak digambar, tetapi menyimpan semuanya properti lainnya.

Parameter
terlihat jika true, maka poligon akan terlihat; jika false, tidak.

publik kosong setZIndex (zIndex mengambang)

Menetapkan zIndex poligon ini. Poligon dengan zIndice yang lebih tinggi akan digambar di atas poligon dengan indeks.

Parameter
zIndex zIndex dari poligon ini.