Polyline

class final publik Polyline memperluas Objek

Polyline adalah daftar titik, di mana segmen garis digambar di antara titik-titik yang berurutan. J polyline memiliki properti berikut:

Poin
Titik-titik sudut garis. Segmen garis digambar di antara titik yang berurutan. Polyline adalah tidak ditutup secara default; untuk membentuk polyline tertutup, titik awal dan akhir harus hal yang sama.
Lebar
Lebar segmen garis dalam piksel layar. Lebarnya konstan dan tidak bergantung pada kamera tingkat zoom. 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 batas yang didukung: ButtCap, SquareCap, RoundCap (berlaku untuk pola goresan solid) dan CustomCap (berlaku untuk pola goresan apa pun). Default untuk awal dan akhir: ButtCap.
Jenis sambungan
Jenis sambungan menentukan bentuk yang akan digunakan saat menggabungkan semua segmen garis yang berdekatan titik sudut polyline kecuali titik sudut awal dan akhir. Lihat JointType untuk jenis sambungan yang didukung. Nilai defaultnya adalah DEFAULT.
Pola guratan
Solid (default, diwakili oleh null) atau urutan objek PatternItem untuk diulang di sepanjang garis. Jenis PatternItem yang tersedia: Gap (ditentukan oleh panjang celah dalam piksel), Dash (ditentukan oleh lebar garis dan panjang tanda hubung dalam piksel), dan Dot (melingkar, berpusat pada garis, diameter ditentukan oleh lebar garis dalam piksel).
Indeks Z
Urutan penggambaran overlay ubin ini sehubungan dengan overlay lainnya (termasuk GroundOverlay, TileOverlay, Circle, dan Polygon, tetapi tidak Marker). Overlay dengan indeks z yang lebih besar digambar di atas overlay dengan indeks z. Urutan hamparan dengan indeks-z yang sama tidak didukung. Default zIndex adalah 0.
Visibilitas
Menunjukkan apakah polyline terlihat atau tidak terlihat, yaitu apakah polyline digambar di peta. Channel polyline yang tidak terlihat tidak digambar, namun mempertahankan semua properti lainnya. Defaultnya adalah true, yaitu, terlihat.
Status geodesi
Menunjukkan apakah segmen polyline harus digambar sebagai geodesi, bukan sebagai 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 polyline, 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.OnPolylineClickListener yang didaftarkan melalui setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).
Tag
Object yang terkait dengan polyline. Misalnya, Object dapat berisi data tentang apa yang direpresentasikan oleh polyline. Ini lebih mudah daripada menyimpan Map<Polyline, 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.
Span
Menentukan span dengan berbagai gaya yang digunakan untuk merender polyline ini. Anda dapat menggunakan untuk membuat polyline dengan StrokeStyle yang berbeda di 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 developer Bentuk kami.

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 batas di verteks 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.
Daftar<PatternItem>
getPattern()
Mendapatkan pola goresan polyline ini.
Daftar<LatLng>
getPoints()
Menampilkan cuplikan verteks polyline ini sekarang .
Batas
getStartCap()
Mendapatkan batas pada verteks awal polyline ini.
Objek
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 diklik polyline.
void
setColor(int color)
Menetapkan warna polyline ini.
void
setEndCap(Cap endCap)
Menetapkan batas di verteks akhir polyline ini.
void
setGeodesic(boolean geodesic)
Menetapkan apakah akan menggambar setiap segmen garis sebagai geodesi atau bukan.
void
setJointType(int joinType)
Menetapkan jenis sambungan untuk semua verteks polyline kecuali verteks awal dan akhir.
void
setPattern(Pola daftar<PatternItem>)
Menetapkan pola goresan polyline.
void
setPoints(Daftar<LatLng> poin)
Menetapkan titik polyline ini.
void
setSpans(Daftar<StyleSpan> span)
Menetapkan span polyline.
void
setStartCap(Cap startCap)
Menetapkan batas pada verteks awal polyline ini.
void
setTag(Tag objek)
Menetapkan tag untuk polyline.
void
setVisible(boolean visible)
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

publik boolean sama dengan (Objek lainnya)

Menguji apakah Polyline ini sama dengan yang lain.

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

publik Int getColor ()

Mendapatkan warna polyline ini.

Hasil
  • warna dalam format ARGB.

publik Batas getEndCap ()

Mendapatkan batas di verteks akhir polyline ini.

Hasil
  • jenis {i>end cap<i}.

publik {i>String<i} getId ()

Mendapatkan ID polyline ini. ID akan bersifat unik di antara semua Polyline pada peta.

Hasil
  • ID polyline ini.

publik Int getJointType ()

Mendapatkan jenis sambungan yang digunakan di semua verteks polyline kecuali verteks awal dan akhir. Lihat JointType untuk nilai yang memungkinkan.

Hasil
  • jenis {i>joint<i}.

publik Daftar<PatternItem> getPattern ()

Mendapatkan pola goresan polyline ini.

Hasil
  • pola guratan.

publik Daftar<LatLng> getPoints ()

Menampilkan cuplikan verteks polyline ini sekarang . Daftar yang ditampilkan adalah salinan daftar verteks sehingga perubahan pada verteks polyline tidak akan terlihat daftar ini, perubahan pada daftar ini juga tidak akan ditunjukkan oleh polyline. Untuk mengubah verteks polyline, panggil setPoints(List).

publik Batas getStartCap ()

Mendapatkan batas pada verteks awal polyline ini.

Hasil
  • huruf besar/kecil.

publik Objek getTag ()

Mendapatkan tag untuk polyline.

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

publik mengambang getWidth ()

Mendapatkan lebar polyline ini.

Hasil
  • selebar piksel layar.

publik mengambang getZIndex ()

Mendapatkan zIndex dari polyline ini.

Hasil
  • zIndex dari polyline.

publik Int hashCode ()

publik boolean isClickable ()

Mendapatkan kemampuan diklik polyline. Jika polyline dapat diklik, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnPolylineClickListener saat pengguna mengklik polyline. Pemroses peristiwa terdaftar melalui setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Hasil
  • true jika polyline 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 polyline ini.

Hasil
  • visibilitas polyline ini.

publik kosong hapus ()

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

publik kosong setClickable (boolean dapat diklik)

Menetapkan kemampuan diklik polyline. Jika polyline bisa diklik, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnPolylineClickListener saat pengguna mengklik polyline. Pemroses peristiwa terdaftar melalui setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Parameter
dapat diklik Setelan kemampuan diklik baru untuk polyline.

publik kosong setColor (int color)

Menetapkan warna polyline ini.

Parameter
warna warna dalam format ARGB

publik kosong setEndCap (Batas endCap)

Menetapkan batas di verteks akhir polyline ini. Batas akhir default adalah ButtCap.

Parameter
endCap penutup di bagian akhir. Tidak boleh null.

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 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 gabungan tidak ditentukan atau bukan salah satu dari nilai yang diizinkan.

Parameter
jointType jenis {i>joint<i}.

publik kosong setPattern (Pola daftar<PatternItem>)

Menetapkan pola goresan polyline. Pola goresan {i>default<i} adalah solid, diwakili oleh null.

Parameter
pola pola guratan.

publik kosong setPoints (Daftar<LatLng> poin)

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

Parameter
poin daftar LatLng yang merupakan verteks polyline.

publik kosong setSpans (Daftar<StyleSpan> span)

Menetapkan span polyline.

Parameter
span

publik kosong setStartCap (Batas startCap)

Menetapkan batas pada verteks awal polyline ini. Batas awal default adalah ButtCap.

Parameter
startCap huruf besar/kecil. Tidak boleh null.

publik kosong setTag (Tag objek)

Menetapkan tag untuk polyline.

Anda dapat menggunakan properti ini untuk mengaitkan Object arbitrer dengan polyline ini. Sebagai misalnya, Object dapat berisi data tentang hal yang direpresentasikan oleh polyline. 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 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 polyline ini. Bila tidak terlihat, polyline tidak digambar, tetapi tetap semua properti lainnya.

Parameter
terlihat jika true, polyline akan terlihat; jika false, tidak.

publik kosong setWidth (lebar mengambang)

Menetapkan lebar polyline ini.

Parameter
lebar lebar dalam piksel layar

publik kosong setZIndex (zIndex mengambang)

Menetapkan zIndex dari polyline ini. Polyline dengan zIndice yang lebih tinggi akan digambar di atas polyline indeks yang lebih rendah.

Parameter
zIndex zIndex dari polyline ini.