Halaman ini diterjemahkan oleh Cloud Translation API.

Circle

public final class Circle memperluas Object

Lingkaran di permukaan bumi (tudung bulat).

Sebuah lingkaran memiliki properti berikut.

Center: Bagian tengah Lingkaran ditentukan 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 tidak bergantung pada 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, direpresentasikan oleh null) atau urutan objek PatternItem yang akan 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, yang berpusat pada garis batas lingkaran, diameter yang ditentukan oleh lebar goresan dalam piksel).
Warna Pengisi: Warna lingkaran menggunakan 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 yang lebih kecil. Urutan hamparan dengan indeks-z yang sama tidak didukung. zIndex default-nya adalah 0.
Visibilitas: Menunjukkan apakah lingkaran terlihat atau tidak terlihat, yaitu apakah lingkaran digambar di peta. Lingkaran tidak terlihat tidak digambar, tetapi mempertahankan semua propertinya yang lain. Defaultnya adalah true, yaitu terlihat.
Tag: Object yang terkait dengan lingkaran. Misalnya, Object dapat berisi data tentang hal yang diwakili oleh lingkaran tersebut. Hal 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 tidak membaca atau 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 bahwa perender peta saat ini tidak dapat menggambar isian lingkaran jika lingkaran mencakup kutub Utara atau Selatan. Namun, garis batas akan tetap digambar dengan benar.

Panduan Developer

Untuk informasi selengkapnya, baca panduan developer Bentuk.

Ringkasan Metode Publik

LatLng	getCenter() Menampilkan bagian tengah sebagai `LatLng`.
int	getFillColor() Menampilkan warna isian Lingkaran ini.
String	getId() Mendapatkan id lingkaran ini.
ganda	getRadius() Menampilkan radius lingkaran, dalam meter.
int	getStrokeColor() Menampilkan warna goresan.
List<PatternItem>	getStrokePattern() Menampilkan pola goresan garis luar lingkaran ini.
float	getStrokeWidth() Menampilkan lebar goresan.
Object	getTag() Mendapatkan tag untuk lingkaran.
float	getZIndex() Menampilkan zIndex.
boolean	isClickable() Mendapatkan kemampuan diklik lingkaran.
boolean	isVisible() Memeriksa apakah lingkaran terlihat.
void	remove() Menghapus lingkaran ini dari peta.
void	setCenter(LatLng tengah) 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>) Menyetel pola goresan garis luar lingkaran.
void	setStrokeWidth(lebar float) Menetapkan lebar goresan.
void	setTag(Tag objek) Menetapkan tag untuk lingkaran.
void	setVisible(boolean terlihat) Menetapkan visibilitas lingkaran.
void	setZIndex(float zIndex) Menetapkan zIndex.

Ringkasan Metode Turunan

Dari class java.lang.Object

boolean	equals(Object arg0)
kelas akhir<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(panjang arg0)
final void	wait()

Metode Publik

publik LatLng getCenter ()

Menampilkan bagian tengah sebagai LatLng.

Hasil

Pusat geografis sebagai LatLng.

public int getFillColor ()

Menampilkan warna isian Lingkaran ini.

Hasil

Warna isian lingkaran dalam format ARGB.

public String 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.

public int getStrokeColor ()

Menampilkan warna goresan.

Hasil

Warna lingkaran dalam format ARGB.

public List<PatternItem> getStrokePattern ()

Menampilkan pola goresan garis luar lingkaran ini.

Hasil

pola goresan.

float publik 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.

float publik getZIndex ()

Menampilkan zIndex.

Hasil

zIndex lingkaran ini.

boolean publik isClickable ()

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

Hasil

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

boolean publik isVisible ()

Memeriksa apakah lingkaran terlihat.

Hasil

true jika lingkaran terlihat; false jika tidak terlihat.

public void remove ()

Menghapus lingkaran ini dari peta. Setelah lingkaran dihapus, perilaku semua metodenya tidak akan ditentukan.

kekosongan publik setCenter (LatLng tengah)

Menetapkan bagian tengah menggunakan LatLng.

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

Parameter

center	Pusat geografis lingkaran, ditetapkan sebagai `LatLng`.

Menampilkan

NullPointerException	jika pusat null

publik void setClickable (boolean dapat diklik)

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

Parameter

dapat diklik	Setelan kemampuan diklik yang baru untuk lingkaran.

public void 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`.

void publik setRadius (radius ganda)

Menetapkan radius dalam meter.

Radius harus nol atau lebih besar.

Parameter

radius	Radius, dalam meter.

Menampilkan

IllegalArgumentException	jika radius negatif

public void setStrokeColor (int color)

Menetapkan warna goresan.

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

Parameter

warna	Warna goresan dalam format `Color`.

public void setStrokePattern (List<PatternItem> pattern)

Menyetel pola goresan garis luar lingkaran. Pola goresan default adalah solid, diwakili oleh null.

Parameter

pola	pola goresan.

public void setStrokeWidth (lebar float)

Menetapkan lebar goresan.

Lebar goresan adalah lebar (dalam piksel layar) dari garis luar lingkaran. Nilainya harus nol atau lebih besar. Jika nol, berarti tidak ada garis batas yang digambar. Nilai defaultnya adalah 10.

Parameter

lebar	Lebar goresan, dalam piksel layar.

Menampilkan

IllegalArgumentException	jika lebar negatif

public void setTag (Tag objek)

Menetapkan tag untuk lingkaran.

Anda dapat menggunakan properti ini untuk mengaitkan Object arbitrer dengan lingkaran ini. Misalnya, Object dapat berisi data tentang apa yang diwakili oleh lingkaran tersebut. Hal 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 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 lingkaran.

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

Parameter

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

public void setZIndex (float zIndex)

Menetapkan zIndex.

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

Parameter

zIndex	Nilai zIndex.