Polygon

public final class Polygon memperluas Object

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 adalah DEFAULT.
Pola guratan
Solid (default, diwakili oleh null) atau urutan objek PatternItem yang akan diulang di sepanjang garis luar poligon. Jenis PatternItem yang tersedia: Gap (ditentukan oleh panjang celah dalam piksel), Dash (ditentukan oleh lebar goresan dan panjang garis dalam piksel), dan Dot (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, dan TileOverlay, tetapi bukan Marker. 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 adalah false. Jika properti ini disetel ke true, aplikasi Anda akan menerima notifikasi di GoogleMap.OnPolygonClickListener yang terdaftar melalui setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).
Tag
Object yang terkait dengan poligon. 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.

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
setHoles(Daftar<? memperluas lubang List<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 dari garis luar poligon.
void
setStrokePattern(Pola daftar<PatternItem>)
Menetapkan pola goresan garis luar poligon.
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)

Menguji apakah Polygon ini sama dengan yang lain.

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

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, menampilkan false.

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)

Menetapkan jenis sambungan untuk semua verteks dari garis luar poligon.

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

Parameter
jointType jenis sambungan goresan.

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.