GroundOverlay

class final publik GroundOverlay memperluas Objek

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

Posisi
Ada dua cara untuk menentukan posisi overlay bumi:
  • Menggunakan lokasi: Anda harus memberikan gambar overlay bumi, LatLng tempat angkur akan dipasang dan lebar overlay (dalam meter). Tujuan anchor secara default berada 50% dari bagian atas gambar dan 50% dari bagian kiri gambar. Hal ini dapat diubah. Anda juga dapat memberikan tinggi overlay (di meter). Jika Anda tidak memberikan tinggi overlay, tinggi overlay 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 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 menjadi disesuaikan dengan posisi yang diberikan. Anda harus menentukan gambar sebelum menambahkan tanah terhampar di peta; jika tidak, IllegalArgumentException akan ditampilkan saat ditambahkan ke peta.
Bearing
Jumlah gambar yang harus diputar searah jarum jam. Pusat akan menjadi anchor gambar. Ini bersifat opsional dan bearing defaultnya adalah 0, yaitu, gambar sejajar sehingga mengarah ke utara.
zIndex
Urutan penggambaran overlay bumi ini sehubungan dengan overlay lainnya (termasuk Polyline dan TileOverlay, tetapi tidak Marker). Overlay dengan zIndex yang lebih besar akan digambar di atas overlay dengan zIndex yang lebih kecil. Urutan overlay dengan nilai zIndex yang sama bersifat arbitrer. Ini bersifat opsional dan zIndex default-nya adalah 0.
Transparansi
Transparansi overlay bumi dalam rentang [0..1] dengan 0 berarti overlay buram dan 1 berarti overlay sepenuhnya transparan. Jika yang ditentukan bitmap sudah transparan sebagian, transparansi setiap piksel akan diskalakan sesuai (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 atas peta. Overlay bumi yang tidak terlihat tidak digambar, tetapi mempertahankan semua properti lainnya. Hal ini bersifat opsional dan visibilitas default-nya adalah true, yaitu dapat dilihat.
Kemampuan diklik
Jika Anda ingin menangani peristiwa yang diaktifkan saat pengguna mengklik overlay bumi, tetapkan parameter ini menjadi 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 didaftarkan melalui setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).
Tag
Object yang terkait dengan overlay bumi. Misalnya, Object dapat berisi data tentang apa yang diwakili oleh overlay bumi. 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 juga 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 tanah 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 diklik dari overlay bumi.
boolean
isVisible()
Mendapatkan visibilitas overlay bumi ini.
void
remove()
Menghapus overlay bumi ini dari peta.
void
setBearing(bearing mengambang)
Menetapkan bearing overlay bumi (arah sumbu vertikal tanah titik overlay) dalam derajat searah jarum jam dari utara.
void
setClickable(boolean dapat diklik)
Mengatur kemampuan diklik overlay bumi.
void
setDimensions(lebar float, tinggi float)
Menyetel dimensi overlay bumi.
void
setDimensions(lebar mengambang)
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 ditentukan.
void
setTag(Tag objek)
Mengatur tag untuk overlay bumi.
void
setTransparency(transparansi mengambang)
Menyetel transparansi overlay bumi ini.
void
setVisible(boolean visible)
Mengatur visibilitas overlay bumi ini.
void
setZIndex(float zIndex)
Menetapkan zIndex overlay bumi ini.

Ringkasan Metode Turunan

Metode Publik

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

publik mengambang getBearing ()

Mendapatkan bearing overlay tanah dalam derajat searah jarum jam dari utara.

Hasil
  • bearing dari overlay bumi.

publik LatLngBounds getBounds ()

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

Hasil
  • LatLngBounds yang berisi overlay bumi, yang mengabaikan rotasi.

publik mengambang getHeight ()

Mendapatkan tinggi overlay bumi.

Hasil
  • tinggi lapisan tanah dalam meter.

publik {i>String<i} getId ()

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

Hasil
  • ID overlay bumi ini.

publik LatLng getPosition ()

Mendapatkan lokasi titik link.

Hasil

publik Objek getTag ()

Mendapatkan tag untuk lingkaran.

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

publik mengambang getTransparency ()

Mendapatkan transparansi overlay bumi ini.

Hasil
  • transparansi overlay bumi ini.

publik mengambang getWidth ()

Mendapatkan lebar overlay bumi.

Hasil
  • selebar tanah dilapisi dalam meter.

publik mengambang getZIndex ()

Mendapatkan zIndex overlay bumi ini.

Hasil
  • zIndex overlay bumi.

publik Int hashCode ()

publik boolean isClickable ()

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

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

publik boolean isVisible ()

Mendapatkan visibilitas overlay bumi ini. Perhatikan bahwa ini tidak menampilkan apakah tanah overlay sebenarnya ada di layar, namun apakah itu akan digambar jika dimuat dalam area pandang.

Hasil
  • visibilitas overlay bumi ini.

publik kosong hapus ()

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

publik kosong setBearing (bearing mengambang)

Menetapkan bearing overlay bumi (arah sumbu vertikal tanah titik overlay) dalam derajat searah jarum jam dari utara. Rotasi dilakukan terhadap anchor poin.

Parameter
bearing bearing dalam derajat searah jarum jam dari utara

publik kosong setClickable (boolean dapat diklik)

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

Parameter
dapat diklik Setelan kemampuan diklik yang baru untuk overlay bumi.

publik kosong setDimensions (lebar mengambang, tinggi mengambang)

Menyetel dimensi overlay bumi. Gambar akan direntangkan agar sesuai dengan dimensi.

Parameter
lebar lebar dalam meter
tinggi tinggi dalam meter

publik kosong setDimensions (lebar mengambang)

Menetapkan lebar overlay bumi. Tinggi overlay bumi akan disesuaikan untuk mempertahankan rasio aspek.

Parameter
lebar lebar dalam meter

publik kosong setImage (BitmapDescriptor imageDescriptor)

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

Parameter
imageDescriptor BitmapDescriptor yang akan digunakan untuk overlay bumi ini.

publik kosong setPosition (LatLng latLng)

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

Parameter
latLng LatLng yang merupakan lokasi baru untuk menempatkan titik link.

publik kosong setPositionFromBounds (LatLngBounds)

Menetapkan posisi overlay bumi dengan menyesuaikannya ke LatLngBounds yang ditentukan. Ini akan mengabaikan rotasi (bearing) overlay bumi saat memosisikannya, tetapi Bearing masih akan digunakan saat menggambarnya.

Parameter
batas LatLngBounds untuk menempatkan overlay bumi

publik kosong setTag (Tag objek)

Mengatur 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. Ini lebih mudah daripada menyimpan Map<GroundOverlay, Object> terpisah. Sebagai contoh lain, Anda dapat mengaitkan ID String yang sesuai dengan ID dari set data. Google Maps SDK untuk Android tidak membaca atau menulis properti ini. Anda bertanggung jawab memanggil setTag(null) untuk menghapus tag saat tidak lagi diperlukan guna mencegah kebocoran memori di aplikasi.

Parameter
tag jika null, tag akan dihapus.

publik kosong setTransparency (transparansi mengambang)

Menyetel transparansi overlay bumi ini. Lihat dokumentasi di bagian atas kelas ini untuk informasi selengkapnya.

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

publik kosong setVisible (boolean terlihat)

Mengatur visibilitas overlay bumi ini. Jika tidak terlihat, overlay bumi tidak akan digambar, tapi itu mempertahankan semua properti lainnya.

Parameter
terlihat jika true, overlay bumi terlihat; jika false, berarti bukan

publik kosong setZIndex (zIndex mengambang)

Menetapkan zIndex overlay bumi ini. Lihat dokumentasi di bagian atas kelas ini untuk informasi selengkapnya tidak akurat atau tidak sesuai.

Parameter
zIndex zIndex overlay bumi ini