Polygon

class final publik Polygon memperluas Objek

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 adalah DEFAULT.
Pola guratan
Padat (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 guratan dan panjang garis putus-putus dalam piksel) dan Dot (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, dan TileOverlay, tetapi bukan Marker. 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 adalah false. Jika properti ini disetel ke true, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnPolygonClickListener yang terdaftar melalui setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).
Tag
Object yang terkait dengan poligon. Misalnya, Object dapat berisi data tentang arti poligon. Hal ini lebih mudah daripada menyimpan Map<Polygon, Object> secara 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 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
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
setHoles(List<? memperluas List<LatLng>> hole)
Menetapkan lubang poligon ini.
void
setPoints(List<LatLng> poin)
Menetapkan titik poligon ini.
void
setStrokeColor(int color)
Menetapkan warna guratan poligon ini.
void
setStrokeJointType(int joinType)
Menetapkan jenis sambungan untuk semua verteks garis luar poligon.
void
setStrokePattern(List<PatternItem> pattern)
Menetapkan pola guratan garis luar poligon.
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)

Menguji apakah Polygon ini sama dengan yang lain.

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

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

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)

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
joinType jenis sambungan guratan.

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.