Polyline

class final publik Polyline memperluas Object

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

Poin
Verteks garis. Segmen garis digambar di antara titik 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 batas yang didukung: ButtCap, SquareCap, RoundCap (berlaku untuk pola guratan solid) dan CustomCap (berlaku untuk pola guratan apa pun). 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 sambungan yang didukung. Nilai defaultnya adalah DEFAULT.
Pola guratan
Padat (default, diwakili oleh null) atau urutan objek PatternItem yang akan diulang di sepanjang baris. Jenis PatternItem yang tersedia: Gap (ditentukan oleh panjang celah dalam piksel), Dash (ditentukan oleh lebar garis dan panjang tanda pisah dalam piksel) dan Dot (melingkar, berpusat di 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 bukan Marker). Overlay dengan indeks z yang lebih besar akan digambar pada 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, yaitu apakah polyline digambar pada peta. Polyline yang tidak terlihat tidak digambar, tetapi mempertahankan semua properti lainnya. 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
Kemudahan 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 ke 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> 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.
Span
Menentukan span dengan berbagai gaya yang digunakan untuk merender polyline ini. Anda dapat menggunakan properti ini untuk membuat polyline dengan StrokeStyle yang berbeda pada segmen polyline yang berbeda.

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 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 batas di vertex 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 guratan polyline ini.
Daftar<LatLng>
getPoints()
Menampilkan snapshot verteks polyline ini pada saat ini .
Batas
getStartCap()
Mendapatkan batas di vertex awal polyline ini.
Objek
getTag()
Mendapatkan tag untuk polyline.
float
getWidth()
Mendapatkan lebar polyline ini.
float
getZIndex()
Mendapatkan zIndex 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
setEndCap(Cap endCap)
Menetapkan batas di verteks akhir polyline ini.
void
setGeodesic(geodesi boolean)
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(List<PatternItem> pola)
Menetapkan pola guratan polyline.
void
setPoints(List<LatLng> poin)
Menetapkan titik polyline ini.
void
setSpans(List<StyleSpan> span)
Menetapkan span polyline.
void
setStartCap(Cap startCap)
Menetapkan batas di verteks awal polyline ini.
void
setTag(Tag objek)
Menetapkan tag untuk polyline.
void
setVisible(boolean terlihat)
Menetapkan visibilitas polyline ini.
void
setWidth(float lebar)
Menetapkan lebar polyline ini.
void
setZIndex(float zIndex)
Menetapkan zIndex 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 == other.

int publik getColor ()

Mendapatkan warna polyline ini.

Hasil
  • warnanya dalam format ARGB.

publik Cap getEndCap ()

Mendapatkan batas di vertex akhir polyline ini.

Hasil
  • jenis batas akhir.

publik String getId ()

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

Hasil
  • id polyline ini.

int publik getJointType ()

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

Hasil
  • jenis sambungan.

public List<PatternItem> getPattern ()

Mendapatkan pola guratan polyline ini.

Hasil
  • pola guratan.

public List<LatLng> getPoints ()

Menampilkan snapshot verteks polyline ini pada saat ini . Daftar yang ditampilkan adalah salinan daftar verteks sehingga perubahan pada verteks polyline tidak akan tercermin oleh daftar ini, dan perubahan pada daftar ini tidak akan tercermin oleh polyline. Untuk mengubah vertex polyline, panggil setPoints(List).

publik Cap getStartCap ()

Mendapatkan batas di vertex 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 piksel layar.

float publik getZIndex ()

Mendapatkan zIndex polyline ini.

Hasil
  • zIndex polyline.

int publik 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 terdaftar 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.

publik 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 terdaftar melalui setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Parameter
dapat diklik Setelan klik baru untuk polyline.

publik void setColor (int color)

Menetapkan warna polyline ini.

Parameter
warna warna dalam format ARGB

publik void setEndCap (Cap endCap)

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

Parameter
penutup batas akhir. Tidak boleh null.

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

publik void setPattern (List<PatternItem> pola)

Menetapkan pola guratan polyline. Pola guratan default solid, diwakili oleh null.

Parameter
pola pola guratan.

publik void setPoints (List<LatLng> poin)

Menetapkan titik polyline ini. Metode ini akan mengambil salinan titik, sehingga mutasi lebih lanjut pada points tidak akan berpengaruh pada polyline ini.

Parameter
poin daftar LatLng yang merupakan verteks polyline.

publik void setSpans (List<StyleSpan> spans)

Menetapkan span polyline.

Parameter
span

publik void setStartCap (Cap startCap)

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

Parameter
startCap batas awal. Tidak boleh null.

publik 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> 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 polyline ini. Jika tidak terlihat, polyline tidak akan digambar, tetapi mempertahankan semua properti lainnya.

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

publik void setWidth (lebar float)

Menetapkan lebar polyline ini.

Parameter
lebar lebar dalam piksel layar

publik void setZIndex (float zIndex)

Menetapkan zIndex polyline ini. Polyline dengan indeks z yang lebih tinggi digambar di atas polyline dengan indeks yang lebih rendah.

Parameter
Indeks zIndex polyline ini.