Polyline adalah daftar titik, dengan segmen garis yang digambar di antara titik-titik yang berurutan. Polyline memiliki properti berikut:
- Poin
- Titik sudut dari garis. Segmen garis digambar di antara titik yang berurutan. Polyline tidak ditutup secara default; untuk membentuk polyline tertutup, titik awal dan akhir harus sama.
- Lebar
- Lebar segmen garis dalam piksel layar. Lebarnya konstan dan tidak bergantung pada tingkat zoom kamera. Nilai defaultnya adalah 10.
- Warna
- Warna segmen garis dalam format ARGB, format yang sama dengan yang digunakan oleh
Color
. Nilai defaultnya adalah hitam (0xff000000
). - Batas awal/akhir
- Menentukan bentuk yang akan digunakan di awal atau akhir polyline. Jenis ujung yang didukung:
ButtCap
,SquareCap
,RoundCap
(berlaku untuk pola goresan solid) danCustomCap
(berlaku untuk pola goresan). Default untuk awal dan akhir:ButtCap
. - Jenis sambungan
- Jenis sambungan menentukan bentuk yang akan digunakan saat menggabungkan segmen garis yang berdekatan di semua verteks polyline kecuali verteks awal dan akhir. Lihat
JointType
untuk jenis gabungan yang didukung. Nilai defaultnya adalahDEFAULT
. - Pola guratan
- Solid (default, direpresentasikan oleh
null
) atau urutan objekPatternItem
yang akan diulang di sepanjang garis. JenisPatternItem
yang tersedia:Gap
(ditentukan oleh panjang celah dalam piksel),Dash
(ditentukan oleh lebar garis dan panjang tanda hubung dalam piksel), danDot
(melingkar, berada di tengah garis, diameter yang ditentukan oleh lebar garis dalam piksel). - Indeks Z
- Urutan penggambaran overlay ubin ini sehubungan dengan overlay lainnya (termasuk
GroundOverlay
,TileOverlay
,Circle
, danPolygon
, tetapi tidakMarker
). Overlay dengan indeks z yang lebih besar digambar di atas overlay dengan indeks z yang lebih kecil. Urutan hamparan dengan indeks-z yang sama tidak didukung. zIndex default-nya adalah 0. - Visibilitas
- Menunjukkan apakah polyline terlihat atau tidak terlihat, yaitu apakah polyline digambar di peta. Polyline yang tidak terlihat tidak digambar, tetapi mempertahankan semua propertinya yang lain. Defaultnya adalah
true
, yaitu terlihat. - Status geodesi
- Menunjukkan apakah segmen polyline 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 polyline, 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.OnPolylineClickListener
yang terdaftar melaluisetOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
. - Tag
Object
yang terkait dengan polyline. Misalnya,Object
dapat berisi data tentang apa yang diwakili oleh polyline. Hal ini lebih mudah daripada menyimpanMap<Polyline, 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.- Span
- Menentukan span dengan gaya lain yang digunakan untuk merender polyline ini. Anda dapat menggunakan properti ini untuk membuat polyline dengan
StrokeStyle
yang berbeda pada berbagai segmen polyline.
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 thin red line from London to New York.
Polyline line = map.addPolyline(new PolylineOptions()
.add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
.width(5)
.color(Color.RED));
Panduan Developer
Untuk informasi selengkapnya, baca panduan developer Bentuk.
Ringkasan Metode Publik
boolean |
sama dengan(Objek lainnya)
Menguji apakah
Polyline ini sama dengan yang lain. |
int |
getColor()
Mendapatkan warna polyline ini.
|
Batas |
getEndCap()
Mendapatkan ujung di ujung akhir polyline ini.
|
String |
getId()
Mendapatkan ID polyline ini.
|
int |
getJointType()
Mendapatkan jenis sambungan yang digunakan di semua verteks polyline kecuali verteks awal dan akhir.
|
List<PatternItem> |
getPattern()
Mendapatkan pola goresan polyline ini.
|
List<LatLng> |
getPoints()
Menampilkan snapshot verteks polyline ini pada saat ini .
|
Batas |
getStartCap()
Mendapatkan ujung di titik awal polyline ini.
|
Object |
getTag()
Mendapatkan tag untuk polyline.
|
float |
getWidth()
Mendapatkan lebar polyline ini.
|
float |
getZIndex()
Mendapatkan zIndex dari polyline ini.
|
int |
hashCode()
|
boolean |
isClickable()
Mendapatkan kemampuan diklik polyline.
|
boolean |
isGeodesic()
Mendapatkan apakah setiap segmen garis digambar sebagai geodesi atau tidak.
|
boolean |
isVisible()
Mendapatkan visibilitas polyline ini.
|
void |
remove()
Menghapus polyline ini dari peta.
|
void |
setClickable(boolean dapat diklik)
Menetapkan kemampuan klik polyline.
|
void |
setColor(int color)
Menetapkan warna polyline ini.
|
void | |
void |
setGeodesic(boolean geodesi)
Menetapkan apakah akan menggambar setiap segmen garis sebagai geodesi atau tidak.
|
void |
setJointType(int joinType)
Menetapkan jenis sambungan untuk semua verteks polyline kecuali verteks awal dan akhir.
|
void | |
void | |
void | |
void | |
void |
setTag(Tag objek)
Menetapkan tag untuk polyline.
|
void |
setVisible(boolean terlihat)
Menetapkan visibilitas polyline ini.
|
void |
setWidth(lebar mengambang)
Menetapkan lebar polyline ini.
|
void |
setZIndex(float zIndex)
Menetapkan zIndex dari polyline ini.
|
Ringkasan Metode Turunan
Metode Publik
boolean publik sama dengan (Objek lainnya)
public int getColor ()
Mendapatkan warna polyline ini.
Hasil
- warna dalam format ARGB.
public String getId ()
Mendapatkan ID polyline ini. ID akan bersifat unik di antara semua Polyline pada peta.
Hasil
- ID polyline ini.
public int getJointType ()
Mendapatkan jenis sambungan yang digunakan di semua verteks polyline kecuali verteks awal dan akhir. Lihat JointType
untuk nilai yang memungkinkan.
Hasil
- jenis gabungan.
publik Daftar<LatLng> getPoints ()
Menampilkan snapshot verteks polyline ini pada saat ini . Daftar yang ditampilkan adalah salinan
daftar verteks sehingga perubahan verteks polyline tidak akan tercermin oleh
daftar ini, dan perubahan pada daftar ini juga tidak akan direfleksikan oleh polyline. Untuk mengubah verteks polyline, panggil setPoints(List)
.
publik Objek getTag ()
Mendapatkan tag untuk polyline.
Hasil
- tag jika tag ditetapkan dengan
setTag
;null
jika tidak ada tag yang ditetapkan.
float publik getWidth ()
Mendapatkan lebar polyline ini.
Hasil
- lebar dalam {i>pixel<i} layar.
float publik getZIndex ()
Mendapatkan zIndex dari polyline ini.
Hasil
- zIndex polyline.
public int hashCode ()
boolean publik isClickable ()
Mendapatkan kemampuan diklik polyline. Jika polyline dapat diklik, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnPolylineClickListener
saat pengguna mengklik polyline. Pemroses peristiwa didaftarkan melalui setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
.
Hasil
true
jika polyline 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 polyline ini.
Hasil
- visibilitas polyline ini.
public void remove ()
Menghapus polyline ini dari peta. Setelah polyline dihapus, perilaku semua metodenya tidak ditentukan.
publik void setClickable (boolean dapat diklik)
Menetapkan kemampuan klik polyline. Jika polyline dapat diklik, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnPolylineClickListener
saat pengguna mengklik polyline. Pemroses peristiwa didaftarkan melalui setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
.
Parameter
dapat diklik | Setelan kemampuan diklik baru untuk polyline. |
---|
public void setColor (int color)
Menetapkan warna polyline ini.
Parameter
warna | warna dalam format ARGB |
---|
public void setEndCap (Cap endCap)
Menetapkan penutup di ujung akhir polyline ini. Batas akhir default adalah ButtCap
.
Parameter
endCap | batas akhir. Tidak boleh null .
|
---|
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.
|
---|
public void setJointType (int joinType)
Menetapkan jenis sambungan untuk semua verteks polyline kecuali verteks awal dan akhir.
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 gabungan. |
---|
public void setPattern (List<PatternItem> pattern)
Menetapkan pola goresan polyline. Pola goresan default adalah solid, diwakili oleh null
.
Parameter
pola | pola goresan. |
---|
public void setPoints (List<LatLng> poin)
Menetapkan titik-titik polyline ini. Metode ini akan mengambil salinan titik, sehingga mutasi lebih lanjut ke points
tidak akan berpengaruh pada polyline ini.
Parameter
poin | daftar LatLng yang merupakan verteks polyline.
|
---|
public void setStartCap (Cap startCap)
Menetapkan ujung di titik awal polyline ini. Batas awal default adalah ButtCap
.
Parameter
startCap | batas awal. Tidak boleh null .
|
---|
public void setTag (Tag objek)
Menetapkan tag untuk polyline.
Anda dapat menggunakan properti ini untuk mengaitkan Object
arbitrer dengan polyline ini. Misalnya, Object
dapat berisi data tentang apa yang diwakili oleh polyline. Hal ini lebih mudah daripada menyimpan Map<Polyline, 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 polyline ini. Jika tidak terlihat, polyline tidak digambar, tetapi akan menyimpan semua properti lainnya.
Parameter
terlihat | jika true , polyline akan terlihat; jika false , polyline tidak.
|
---|
public void setWidth (lebar mengambang)
Menetapkan lebar polyline ini.
Parameter
lebar | lebar dalam piksel layar |
---|
public void setZIndex (float zIndex)
Menetapkan zIndex dari polyline ini. Polyline dengan zIndice yang lebih tinggi digambar di atas zIndice yang memiliki indeks lebih rendah.
Parameter
zIndex | zIndex dari polyline ini. |
---|