Halaman ini diterjemahkan oleh Cloud Translation API.

GroundOverlay

class final publik GroundOverlay memperluas Object

Overlay bumi adalah gambar yang disematkan pada peta. Overlay bumi memiliki properti berikut:

Posisi

Ada dua cara untuk menetapkan posisi overlay bumi:

Menggunakan lokasi: Anda harus memberikan gambar overlay bumi, LatLng yang akan digunakan untuk menempatkan anchor dan lebar overlay (dalam meter). Anchor secara default, 50% dari bagian atas gambar dan 50% dari kiri gambar. Ini dapat diubah. Anda juga dapat memberikan tinggi overlay (dalam meter). Jika tinggi overlay tidak diberikan, tingginya akan otomatis dihitung untuk mempertahankan proporsi gambar.
Menggunakan Batas: Anda harus memberikan LatLngBounds yang akan berisi gambar.

Anda harus menentukan posisi overlay bumi sebelum ditambahkan ke peta, jika tidak, IllegalArgumentException akan ditampilkan saat overlay bumi ditambahkan ke peta. Selain itu, Anda hanya boleh menentukan posisi menggunakan salah satu metode ini dalam objek GroundOverlayOptions; jika tidak, IllegalStateException akan ditampilkan saat menentukan menggunakan metode kedua.

Gambar

Gambar (sebagai BitmapDescriptor) yang akan digunakan untuk overlay ini. Gambar akan diskalakan agar sesuai dengan posisi yang diberikan. Anda harus menentukan gambar sebelum menambahkan overlay bumi ke peta; jika tidak, IllegalArgumentException akan ditampilkan saat ditambahkan ke peta.

Bantalan poros

Jumlah gambar yang harus diputar searah jarum jam. Posisi tengah rotasi adalah anchor gambar. Hal ini bersifat opsional dan bearing default adalah 0, yaitu gambar disejajarkan sehingga ke atas adalah utara.

Indeks

Urutan overlay bumi ini sehubungan dengan overlay lain (termasuk Polyline dan TileOverlay, tetapi tidak Marker). Overlay dengan zIndex yang lebih besar akan digambar pada overlay dengan zIndex yang lebih kecil. Urutan overlay dengan nilai zIndex yang sama tidak didukung. Nilai ini bersifat opsional dan zIndex default-nya adalah 0.

Transparansi

Transparansi overlay bumi dalam rentang [0..1] di mana 0 berarti overlay buram dan 1 berarti overlay sepenuhnya transparan. Jika bitmap yang ditentukan sudah transparan sebagian, transparansi setiap piksel akan diskalakan sebagaimana mestinya (misalnya, jika piksel dalam bitmap memiliki nilai alfa 200 dan Anda menentukan transparansi overlay bumi sebagai 0.25, maka piksel akan dirender di layar dengan nilai alfa 150). Spesifikasi properti ini bersifat opsional dan transparansi defaultnya adalah 0 (buram).

Visibilitas

Menunjukkan apakah overlay bumi terlihat atau tidak, yaitu digambar overlay pada peta. Overlay bumi yang tidak terlihat tidak digambar, tetapi mempertahankan semua properti lainnya. Area ini opsional dan visibilitas default-nya adalah true, yakni terlihat.

Kemudahan diklik

Jika Anda ingin menangani peristiwa yang diaktifkan saat pengguna mengklik overlay bumi, tetapkan properti ini ke true. Anda dapat mengubah nilai ini kapan saja. Defaultnya adalah false. Jika properti ini ditetapkan ke true, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnGroundOverlayClickListener yang terdaftar melalui setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Tag

Object yang terkait dengan overlay bumi. Misalnya, Object dapat berisi data tentang apa yang diwakili oleh overlay bumi. Hal ini lebih mudah daripada menyimpan Map<GroundOverlay, 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.

Metode di class ini harus dipanggil pada UI thread Android. Jika tidak, IllegalStateException akan ditampilkan saat runtime.

Contoh

GoogleMap map = ...; // get a map.
 BitmapDescriptor imageDescriptor = ...; // get an image.
 LatLngBounds bounds = ...; // get a bounds
 // Adds a ground overlay with 50% transparency.
 GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
     .image(imageDescriptor)
     .positionFromBounds(bounds)
     .transparency(0.5));

Ringkasan Metode Publik

boolean	sama dengan(Objek lainnya) Menguji apakah `GroundOverlay` ini sama dengan yang lain.
float	getBearing() Mendapatkan bantalan overlay bumi dalam derajat searah jarum jam dari utara.
LatLngBounds	getBounds() Mendapatkan batas untuk overlay bumi.
float	getHeight() Mendapatkan tinggi overlay bumi.
String	getId() Mendapatkan ID overlay bumi ini.
LatLng	getPosition() Mendapatkan lokasi titik link.
Objek	getTag() Mendapatkan tag untuk lingkaran.
float	getTransparency() Mendapatkan transparansi overlay bumi ini.
float	getWidth() Mendapatkan lebar overlay bumi.
float	getZIndex() Mendapatkan zIndex overlay bumi ini.
int	hashCode()
boolean	isClickable() Mendapatkan kemampuan klik overlay overlay.
boolean	isVisible() Mendapatkan visibilitas overlay bumi ini.
void	remove() Menghapus overlay bumi ini dari peta.
void	setBearing(bantalan mengambang) Menetapkan bantalan overlay bumi (arah yang ditunjuk oleh sumbu vertikal overlay bumi) dalam derajat searah jarum jam dari utara.
void	setClickable(boolean dapat diklik) Menetapkan kemampuan klik untuk overlay bumi.
void	setDimension(lebar float, tinggi float) Menetapkan dimensi overlay bumi.
void	setDimension(float lebar) Menetapkan lebar overlay bumi.
void	setImage(BitmapDescriptor imageDescriptor) Menetapkan gambar untuk Overlay Bumi.
void	setPosition(LatLng latLng) Menetapkan posisi overlay bumi dengan mengubah lokasi titik link.
void	setPositionFromBounds(batas LatLngBounds) Menetapkan posisi overlay bumi dengan menyesuaikannya ke `LatLngBounds` yang diberikan.
void	setTag(Tag objek) Menetapkan tag untuk overlay bumi.
void	setTransparency(transparansi mengambang) Menetapkan transparansi overlay bumi ini.
void	setVisible(boolean terlihat) Menetapkan visibilitas overlay bumi ini.
void	setZIndex(float zIndex) Menetapkan zIndex overlay bumi ini.

Ringkasan Metode Turunan

Dari class java.lang.Object

boolean	equals(Object arg0)
final Class< ?>gt;	getClass()
int	hashCode()
final void	beri tahu()
final void	notifyAll()
String	toString()
final void	wait(panjang arg0, int arg1)
final void	wait(panjang arg0)
final void	wait()

Metode Publik

boolean publik sama dengan (Objek lainnya)

Menguji apakah GroundOverlay ini sama dengan yang lain.

Parameter

lainnya	`Object`.

Hasil

true jika kedua objek adalah objek yang sama, yaitu == other.

float publik getBearing ()

Mendapatkan bantalan overlay bumi dalam derajat searah jarum jam dari utara.

Hasil

bantalan overlay bumi.

publik LatLngBounds getBounds ()

Mendapatkan batas untuk overlay bumi. Ini mengabaikan rotasi overlay bumi.

Hasil

LatLngBounds yang berisi overlay bumi, mengabaikan rotasi.

float publik getHeight ()

Mendapatkan tinggi overlay bumi.

Hasil

tinggi overlay bumi dalam meter.

publik String getId ()

Mendapatkan ID overlay bumi ini. ID akan unik di antara semua GroundOverlays pada peta.

Hasil

id overlay bumi ini.

publik LatLng getPosition ()

Mendapatkan lokasi titik link.

Hasil

posisi pada peta (LatLng).

publik Objek getTag ()

Mendapatkan tag untuk lingkaran.

Hasil

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

float publik getTransparency ()

Mendapatkan transparansi overlay bumi ini.

Hasil

transparansi overlay bumi ini.

float publik getWidth ()

Mendapatkan lebar overlay bumi.

Hasil

lebar overlay bumi dalam meter.

float publik getZIndex ()

Mendapatkan zIndex overlay bumi ini.

Hasil

zIndex overlay bumi.

int publik hashCode ()

boolean publik isClickable ()

Mendapatkan kemampuan klik overlay overlay. Jika overlay bumi dapat diklik, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnGroundOverlayClickListener saat pengguna mengklik overlay bumi. Pemroses peristiwa terdaftar melalui setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Hasil

true jika overlay bumi dapat diklik; jika tidak, menampilkan false.

boolean publik isVisible ()

Mendapatkan visibilitas overlay bumi ini. Perhatikan bahwa hal ini tidak akan menampilkan apakah overlay bumi benar-benar ada di layar, tetapi akan digambar jika ditampung di area pandang kamera.

Hasil

visibilitas overlay bumi ini.

publik void remove ()

Menghapus overlay bumi ini dari peta. Setelah overlay bumi dihapus, perilaku semua metodenya tidak ditentukan.

publik void setBearing (bantalan mengambang)

Menetapkan bantalan overlay bumi (arah yang ditunjuk oleh sumbu vertikal overlay bumi) dalam derajat searah jarum jam dari utara. Rotasi dilakukan pada titik anchor.

Parameter

bearing	bantalan dalam derajat searah jarum jam dari utara

publik void setClickable (boolean dapat diklik)

Menetapkan kemampuan klik untuk overlay bumi. Jika overlay bumi dapat diklik, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnGroundOverlayClickListener saat pengguna mengklik overlay bumi. Pemroses peristiwa terdaftar melalui setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Parameter

dapat diklik	Setelan kemampuan diklik baru untuk overlay bumi.

publik void setDimension (lebar float, tinggi float)

Menetapkan dimensi overlay bumi. Gambar akan direntangkan agar sesuai dengan dimensinya.

Parameter

lebar	lebar dalam meter
tinggi	tinggi dalam meter

publik void setDimension (width mengambang)

Menetapkan lebar overlay bumi. Ketinggian overlay bumi akan disesuaikan untuk mempertahankan rasio lebar tinggi.

Parameter

lebar	lebar dalam meter

publik void setImage (BitmapDescriptor imageDescriptor)

Menetapkan gambar untuk Overlay Bumi. Gambar baru akan menempati batas yang sama dengan gambar lama.

Parameter

imageDescriptor	`BitmapDescriptor` yang akan digunakan untuk overlay bumi ini.

publik void setPosition (LatLng latLng)

Menetapkan posisi overlay bumi dengan mengubah lokasi titik link. Mempertahankan semua properti lain dari gambar.

Parameter

linLng	`LatLng` yang merupakan lokasi baru untuk menempatkan titik link.

publik void setPositionFromBounds (batas LatLngBounds)

Menetapkan posisi overlay bumi dengan menyesuaikannya ke LatLngBounds yang diberikan. Metode ini akan mengabaikan rotasi (bearing) overlay bumi saat memosisikannya, tetapi bearing akan tetap digunakan saat menggambarnya.

Parameter

batas	`LatLngBounds` untuk menempatkan overlay bumi

publik void setTag (Tag objek)

Menetapkan tag untuk overlay bumi.

Anda dapat menggunakan properti ini untuk mengaitkan Object arbitrer dengan overlay bumi ini. Misalnya, Object dapat berisi data tentang apa yang diwakili oleh overlay bumi. Hal ini lebih mudah daripada menyimpan Map<GroundOverlay, 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. Anda bertanggung jawab untuk memanggil setTag(null) guna menghapus tag saat tidak lagi dibutuhkan, untuk mencegah kebocoran memori di aplikasi Anda.

Parameter

tag	jika null, tag akan dihapus.

publik void setTransparency (transparansi mengambang)

Menetapkan transparansi overlay bumi ini. Lihat dokumentasi di bagian atas class ini untuk mengetahui informasi selengkapnya.

Parameter

transparansi	float dalam rentang `[0..1]` dengan `0` berarti overlay bumi buram dan `1` berarti overlay bumi transparan.

publik void setVisible (booleanvisible)

Menetapkan visibilitas overlay bumi ini. Jika tidak terlihat, overlay bumi tidak digambar, tetapi mempertahankan semua properti lainnya.

Parameter

terlihat	jika `true`, maka overlay bumi terlihat; jika `false`, tidak

publik void setZIndex (float zIndex)

Menetapkan zIndex overlay bumi ini. Lihat dokumentasi di bagian atas class ini untuk mengetahui informasi selengkapnya.

Parameter

Indeks	zIndex overlay bumi ini