Circle

class final publik Lingkaran memperluas Objek

Lingkaran di permukaan bumi (ujung bulat).

Sebuah lingkaran memiliki sifat-sifat berikut.

Tengah
Bagian tengah Lingkaran ditetapkan sebagai LatLng.
Radius
Radius lingkaran, ditentukan dalam meter. Nilainya harus nol atau lebih besar.
Lebar Goresan
Lebar garis batas lingkaran dalam piksel layar. Lebarnya konstan dan independen tingkat zoom kamera. Nilai defaultnya adalah 10.
Warna Goresan
Warna garis batas lingkaran dalam format ARGB, format yang sama dengan yang digunakan oleh Color. Nilai defaultnya adalah hitam (0xff000000).
Pola guratan
Solid (default, diwakili oleh null) atau urutan objek PatternItem untuk diulang di sepanjang garis batas lingkaran. Jenis PatternItem yang tersedia: Gap (ditentukan oleh panjang celah dalam piksel), Dash (ditentukan oleh lebar goresan dan panjang tanda hubung dalam piksel) dan Dot (melingkar, berpusat pada garis luar lingkaran, diameter yang ditentukan oleh lebar goresan dalam piksel).
Warna Pengisi
Warna lingkaran mengisi format ARGB, format yang sama dengan yang digunakan oleh Color. Nilai defaultnya adalah transparan (0x00000000).
Indeks Z
Urutan penggambaran overlay ubin ini sehubungan dengan overlay lainnya (termasuk GroundOverlay, TileOverlay, Polyline, dan Polygon, tetapi bukan 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 lingkaran dapat dilihat atau tidak terlihat, misalnya apakah lingkaran digambar di peta. Channel lingkaran yang tidak terlihat tidak digambar, tetapi mempertahankan semua properti lainnya. Defaultnya adalah true, yaitu, terlihat.
Tag
Object yang terkait dengan lingkaran. Misalnya, Object dapat berisi data tentang apa yang direpresentasikan oleh lingkaran itu. Ini lebih mudah daripada menyimpan Map<Circle, 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.

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 circle in Sydney
 Circle circle = map.addCircle(new CircleOptions()
     .center(new LatLng(-33.87365, 151.20689))
     .radius(10000)
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));

Perhatikan, perender peta saat ini tidak dapat menggambar isian lingkaran jika lingkaran mencakup kutub Utara atau Selatan. Namun, garis batasnya tetap akan digambar dengan benar.

Panduan Developer

Untuk informasi selengkapnya, baca developer Bentuk kami.

Ringkasan Metode Publik

LatLng
getCenter()
Menampilkan bagian tengah sebagai LatLng.
int
getFillColor()
Menampilkan warna pengisi Lingkaran ini.
String
getId()
Mendapatkan id lingkaran ini.
double
getRadius()
Menampilkan radius lingkaran, dalam meter.
int
getStrokeColor()
Menampilkan warna goresan.
Daftar<PatternItem>
getStrokePattern()
Menampilkan pola goresan garis luar lingkaran ini.
float
getStrokeWidth()
Menampilkan lebar goresan.
Objek
getTag()
Mendapatkan tag untuk lingkaran.
float
getZIndex()
Menampilkan zIndex.
boolean
isClickable()
Mendapatkan kemampuan klik pada lingkaran.
boolean
isVisible()
Memeriksa apakah lingkaran terlihat.
void
remove()
Menghapus lingkaran ini dari peta.
void
setCenter(tengah LatLng)
Menetapkan bagian tengah menggunakan LatLng.
void
setClickable(boolean dapat diklik)
Menetapkan kemampuan klik lingkaran.
void
setFillColor(int color)
Menetapkan warna isian.
void
setRadius(radius ganda)
Menetapkan radius dalam meter.
void
setStrokeColor(int color)
Menetapkan warna goresan.
void
setStrokePattern(pola Daftar<PatternItem>)
Menetapkan pola goresan garis batas lingkaran.
void
setStrokeWidth(lebar mengambang)
Menetapkan lebar goresan.
void
setTag(Tag objek)
Menetapkan tag untuk lingkaran.
void
setVisible(boolean visible)
Menetapkan visibilitas lingkaran.
void
setZIndex(float zIndex)
Menetapkan zIndex.

Ringkasan Metode Turunan

Metode Publik

publik LatLng getCenter ()

Menampilkan bagian tengah sebagai LatLng.

Hasil
  • Pusat geografis sebagai LatLng.

publik Int getFillColor ()

Menampilkan warna pengisi Lingkaran ini.

Hasil
  • Warna isian lingkaran dalam format ARGB.

publik {i>String<i} getId ()

Mendapatkan id lingkaran ini. ID akan bersifat unik di antara semua Lingkaran pada peta.

publik ganda getRadius ()

Menampilkan radius lingkaran, dalam meter.

Hasil
  • Radius dalam meter.

publik Int getStrokeColor ()

Menampilkan warna goresan.

Hasil
  • Warna lingkaran dalam format ARGB.

publik Daftar<PatternItem> getStrokePattern ()

Menampilkan pola goresan garis luar lingkaran ini.

Hasil
  • pola guratan.

publik mengambang getStrokeWidth ()

Menampilkan lebar goresan.

Hasil
  • Lebar dalam piksel layar.

publik Objek getTag ()

Mendapatkan tag untuk lingkaran.

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

publik mengambang getZIndex ()

Menampilkan zIndex.

Hasil
  • zIndex lingkaran ini.

publik boolean isClickable ()

Mendapatkan kemampuan klik pada lingkaran. Jika lingkaran tersebut dapat diklik, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnCircleClickListener saat pengguna mengklik lingkaran. Pemroses peristiwa terdaftar melalui setOnCircleClickListener(GoogleMap.OnCircleClickListener).

Hasil
  • true jika lingkaran dapat diklik; false jika tidak dapat diklik.

publik boolean isVisible ()

Memeriksa apakah lingkaran terlihat.

Hasil
  • true jika lingkaran terlihat; false jika tidak terlihat.

publik kosong hapus ()

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

publik kosong setCenter (LatLng)

Menetapkan bagian tengah menggunakan LatLng.

Bagian tengah tidak boleh null, karena tidak ada nilai default.

Parameter
tengah Pusat geografis lingkaran, ditetapkan sebagai LatLng.
Menampilkan
NullPointerException jika center-nya adalah null

publik kosong setClickable (boolean dapat diklik)

Menetapkan kemampuan klik lingkaran. Jika lingkaran tersebut dapat diklik, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnCircleClickListener saat pengguna mengklik lingkaran. Pemroses peristiwa terdaftar melalui setOnCircleClickListener(GoogleMap.OnCircleClickListener).

Parameter
dapat diklik Setelan kemampuan klik baru untuk lingkaran.

publik kosong setFillColor (int color)

Menetapkan warna isian.

Warna isian adalah warna di dalam lingkaran, dalam format bilangan bulat yang ditentukan oleh Color. Jika TRANSPARENT digunakan maka tidak ada isian yang digambar.

Parameter
warna Warna dalam format Color.

publik kosong setRadius (radius ganda)

Menetapkan radius dalam meter.

Radius harus nol atau lebih besar.

Parameter
radius Radius, dalam meter.
Menampilkan
IllegalArgumentException jika radius negatif

publik kosong setStrokeColor (int color)

Menetapkan warna goresan.

Warna goresan adalah warna garis luar lingkaran, dalam format bilangan bulat yang ditentukan oleh Color. Jika TRANSPARENT digunakan maka tidak ada garis luar yang digambar.

Parameter
warna Warna goresan dalam format Color.

publik kosong setStrokePattern (Pola daftar<PatternItem>)

Menetapkan pola goresan garis batas lingkaran. Pola {i>stroke<i} {i>default<i} adalah solid, yang diwakili oleh null.

Parameter
pola pola guratan.

publik kosong setStrokeWidth (lebar mengambang)

Menetapkan lebar goresan.

Lebar goresan adalah lebar (dalam piksel layar) garis luar lingkaran. Harus nol atau lebih besar. Jika nol maka tidak ada garis batas yang digambar. Nilai defaultnya adalah 10.

Parameter
lebar Lebar goresan, dalam piksel layar.
Menampilkan
IllegalArgumentException jika lebarnya negatif

publik kosong setTag (Tag objek)

Menetapkan tag untuk lingkaran.

Anda dapat menggunakan properti ini untuk mengaitkan Object arbitrer dengan lingkaran ini. Sebagai misalnya, Object dapat berisi data tentang apa yang diwakili oleh lingkaran tersebut. Ini lebih mudah daripada menyimpan Map<Circle, 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 lingkaran.

Jika lingkaran ini tidak terlihat, maka lingkaran ini tidak akan digambar. Semua status lain dipertahankan. Lingkaran dapat dilihat secara default.

Parameter
terlihat true untuk membuat lingkaran ini terlihat; false untuk membuatnya tidak terlihat.

publik kosong setZIndex (zIndex mengambang)

Menetapkan zIndex.

Overlay (misalnya lingkaran) dengan zIndice lebih tinggi akan digambar di atas overlay dengan indeks lebih rendah.

Parameter
zIndex Nilai zIndex.