Polyline

class final public Polyline memperluas Object

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) dan CustomCap (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 adalah DEFAULT.
Pola guratan
Solid (default, direpresentasikan oleh null) atau urutan objek PatternItem yang akan 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, 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, dan Polygon, tetapi tidak Marker). 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 adalah false. Jika properti ini disetel ke true, aplikasi Anda akan menerima notifikasi di GoogleMap.OnPolylineClickListener yang terdaftar melalui setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).
Tag
Object yang terkait dengan polyline. 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.
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
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
setEndCap(Cap endCap)
Menetapkan penutup di ujung akhir polyline ini.
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
setPattern(Pola daftar<PatternItem>)
Menetapkan pola goresan polyline.
void
setPoints(Daftar<LatLng> poin)
Menetapkan titik-titik polyline ini.
void
setSpans(Daftar<StyleSpan> span)
Menetapkan span polyline.
void
setStartCap(Cap startCap)
Menetapkan ujung di titik awal polyline ini.
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)

Menguji apakah Polyline ini sama dengan yang lain.

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

public int getColor ()

Mendapatkan warna polyline ini.

Hasil
  • warna dalam format ARGB.

publik Cap getEndCap ()

Mendapatkan ujung di ujung akhir polyline ini.

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

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.

public List<PatternItem> getPattern ()

Mendapatkan pola goresan polyline ini.

Hasil
  • pola goresan.

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 Cap getStartCap ()

Mendapatkan ujung di titik awal polyline ini.

Hasil
  • batas awal.

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, 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 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 setSpans (List<StyleSpan> spans)

Menetapkan span polyline.

Parameter
span

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.