Overlay bumi adalah gambar yang disematkan pada peta. Overlay bumi memiliki properti berikut:
- Posisi
- Ada dua cara untuk menentukan posisi overlay bumi:
- Menggunakan lokasi: Anda harus memberikan gambar overlay bumi,
LatLng
tempat anchor akan diperbaiki, dan lebar overlay (dalam meter). Secara default, anchor berada 50% dari bagian atas gambar dan 50% dari sisi kiri gambar. Setelan ini dapat diubah. Secara opsional, Anda dapat memberikan tinggi overlay (dalam meter). Jika tinggi overlay tidak diberikan, tinggi akan dihitung secara otomatis untuk mempertahankan proporsi gambar. - Menggunakan Batas: Anda harus memberikan
LatLngBounds
yang akan berisi gambar.
IllegalArgumentException
akan ditampilkan saat overlay bumi ditambahkan ke peta. Selain itu, Anda hanya boleh menentukan posisi menggunakan salah satu metode ini di objekGroundOverlayOptions
; jika tidak,IllegalStateException
akan ditampilkan saat menentukan menggunakan metode kedua. - Menggunakan lokasi: Anda harus memberikan gambar overlay bumi,
- Gambar
- Gambar (sebagai
BitmapDescriptor
) yang akan digunakan untuk overlay ini. Gambar akan diskalakan agar sesuai dengan posisi yang diberikan. Anda harus menetapkan gambar sebelum menambahkan overlay bumi ke peta; jika tidak,IllegalArgumentException
akan ditampilkan saat ditambahkan ke peta. - Bearing
- Jumlah gambar yang harus diputar searah jarum jam. Bagian tengah rotasi akan menjadi anchor gambar. Ini opsional dan bearing default-nya adalah 0, yaitu, gambar sejajar sehingga posisi atas adalah utara.
- zIndex
- Urutan penggambaran overlay bumi ini sehubungan dengan overlay lainnya (termasuk
Polyline
danTileOverlay
, tetapi tidakMarker
). Overlay dengan zIndex yang lebih besar digambar di atas overlay dengan zIndex yang lebih kecil. Urutan overlay dengan nilai zIndex yang sama bersifat tidak tentu. Hal ini opsional dan zIndex default adalah 0. - Transparansi
- Transparansi overlay bumi dalam rentang
[0..1]
dengan0
berarti overlay buram dan1
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 menetapkan transparansi overlay bumi sebagai 0,25, maka piksel akan dirender pada layar dengan nilai alfa 150). Spesifikasi properti ini bersifat opsional dan transparansi default adalah 0 (buram). - Visibilitas
- Menunjukkan apakah overlay bumi terlihat atau tidak terlihat, yaitu apakah overlay digambar di peta. Overlay bumi yang tidak terlihat tidak digambar, tetapi mempertahankan semua propertinya yang lain.
Hal ini opsional dan visibilitas default-nya adalah
true
, yaitu terlihat. - Kemampuan diklik
- Jika Anda ingin menangani peristiwa yang dipicu saat pengguna mengklik overlay bumi, tetapkan properti ini ke
true
. Anda dapat mengubah nilai ini kapan saja. Defaultnya adalahfalse
. Jika properti ini disetel ketrue
, aplikasi Anda akan menerima notifikasi diGoogleMap.OnGroundOverlayClickListener
yang terdaftar melaluisetOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
. - Tag
Object
yang terkait dengan overlay bumi. Misalnya,Object
dapat berisi data tentang hal yang diwakili oleh overlay bumi. Hal ini lebih mudah daripada menyimpanMap<GroundOverlay, Object>
terpisah. Sebagai contoh lainnya, Anda dapat mengaitkan IDString
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.
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 bearing 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.
|
Object |
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 diklik overlay bumi.
|
boolean |
isVisible()
Mendapatkan visibilitas overlay bumi ini.
|
void |
remove()
Menghapus overlay bumi ini dari peta.
|
void |
setBearing(bantalan float)
Menetapkan bearing 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 overlay bumi.
|
void |
setDimensions(lebar mengambang, tinggi mengambang)
Menyetel dimensi overlay bumi.
|
void |
setDimensions(lebar mengambang)
Menetapkan lebar overlay bumi.
|
void | |
void | |
void |
setPositionFromBounds(batas LatLngBounds)
Menetapkan posisi overlay bumi dengan menyesuaikannya ke
LatLngBounds yang ditentukan. |
void |
setTag(Tag objek)
Menyetel tag untuk overlay bumi.
|
void |
setTransparency(transparansi float)
Menyetel transparansi overlay bumi ini.
|
void |
setVisible(boolean terlihat)
Menyetel visibilitas overlay bumi ini.
|
void |
setZIndex(float zIndex)
Menetapkan zIndex overlay bumi ini.
|
Ringkasan Metode Turunan
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, ini == other.
float publik getBearing ()
Mendapatkan bearing overlay bumi dalam derajat searah jarum jam dari utara.
Hasil
- bearing overlay bumi.
publik LatLngBounds getBounds ()
Mendapatkan batas untuk overlay bumi. Ini mengabaikan rotasi overlay bumi.
Hasil
LatLngBounds
yang berisi overlay bumi, yang mengabaikan rotasi.
float publik getHeight ()
Mendapatkan tinggi overlay bumi.
Hasil
- tinggi overlay tanah dalam meter.
public String getId ()
Mendapatkan ID overlay bumi ini. ID akan unik di antara semua GroundOverlays pada peta.
Hasil
- ID overlay bumi ini.
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 tanah dalam meter.
float publik getZIndex ()
Mendapatkan zIndex overlay bumi ini.
Hasil
- zIndex overlay bumi.
public int hashCode ()
boolean publik isClickable ()
Mendapatkan kemampuan diklik overlay bumi. Jika overlay bumi dapat diklik, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnGroundOverlayClickListener
saat pengguna mengklik overlay bumi. Pemroses peristiwa didaftarkan melalui setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
.
Hasil
true
jika overlay bumi dapat diklik; jika tidak, menampilkanfalse
.
boolean publik isVisible ()
Mendapatkan visibilitas overlay bumi ini. Perhatikan bahwa ini tidak menampilkan apakah overlay bumi benar-benar ada di layar, tetapi apakah overlay akan digambar jika ditempatkan di area pandang kamera.
Hasil
- visibilitas overlay bumi ini.
public void remove ()
Menghapus overlay bumi ini dari peta. Setelah overlay bumi dihapus, perilaku semua metodenya tidak akan ditentukan.
publik void setBearing (float bearing)
Menetapkan bearing overlay bumi (arah yang ditunjuk oleh sumbu vertikal overlay bumi) dalam derajat searah jarum jam dari utara. Rotasi dilakukan di sekitar titik anchor.
Parameter
bearing | bearing dalam derajat searah jarum jam dari utara |
---|
publik void setClickable (boolean dapat diklik)
Menetapkan kemampuan klik overlay bumi. Jika overlay bumi dapat diklik, aplikasi Anda akan menerima notifikasi ke GoogleMap.OnGroundOverlayClickListener
saat pengguna mengklik overlay bumi. Pemroses peristiwa didaftarkan melalui setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
.
Parameter
dapat diklik | Setelan kemampuan diklik yang baru untuk overlay bumi. |
---|
public void setDimensions (lebar mengambang, tinggi float)
Menyetel dimensi overlay bumi. Gambar akan direntangkan agar sesuai dengan dimensinya.
Parameter
lebar | lebar dalam meter |
---|---|
tinggi | tinggi dalam meter |
public void setDimensions (lebar floating)
Menetapkan lebar overlay bumi. Tinggi overlay bumi akan disesuaikan untuk mempertahankan rasio aspek.
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
latLng | LatLng yang merupakan lokasi baru untuk menempatkan titik link.
|
---|
public void setPositionFromBounds (LatLngBounds batas)
Menetapkan posisi overlay bumi dengan menyesuaikannya ke LatLngBounds
yang ditentukan. Metode ini akan mengabaikan rotasi (bantalan) overlay bumi saat memosisikannya, tetapi bearing akan tetap digunakan saat menggambarnya.
Parameter
batas | LatLngBounds untuk menempatkan overlay bumi
|
---|
public void setTag (Tag objek)
Menyetel tag untuk overlay bumi.
Anda dapat menggunakan properti ini untuk mengaitkan Object
arbitrer dengan overlay bumi ini.
Misalnya, Object
dapat berisi data tentang hal yang diwakili oleh overlay bumi. Hal ini
lebih mudah daripada menyimpan Map<GroundOverlay, 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, untuk mencegah kebocoran memori di aplikasi.
Parameter
tag | jika null, tag akan dihapus. |
---|
void publik setTransparency (transparansi mengambang)
Menyetel transparansi overlay bumi ini. Lihat dokumentasi di bagian atas class ini untuk informasi selengkapnya.
Parameter
transparansi | float dalam rentang [0..1] dengan 0 berarti overlay bumi buram dan 1 berarti overlay bumi transparan.
|
---|
publik void setVisible (boolean visible)
Menyetel visibilitas overlay bumi ini. Jika tidak terlihat, overlay bumi tidak akan digambar, tetapi mempertahankan semua propertinya yang lain.
Parameter
terlihat | jika true , overlay bumi akan terlihat; jika false , overlay tidak
|
---|
public void setZIndex (float zIndex)
Menetapkan zIndex overlay bumi ini. Lihat dokumentasi di bagian atas class ini untuk informasi selengkapnya.
Parameter
zIndex | zIndex overlay bumi ini |
---|