Overlay Ubin adalah sekumpulan gambar yang ditampilkan di atas ubin peta dasar. Ubin ini mungkin transparan, yang memungkinkan Anda menambahkan fitur ke peta yang ada. Overlay ubin memiliki properti berikut:
- Penyedia Ubin
TileProvider
menyediakan gambar yang digunakan dalam overlay ubin. Anda harus menentukan penyedia ubin sebelum ditambahkan ke peta. Penyedia kartu tidak dapat diubah setelah ditambahkan; tetapi, Anda dapat mengubah perilaku penyedia kartu untuk menampilkan gambar yang berbeda untuk koordinat tertentu. Jika kartu yang disediakan oleh penyedia kartu berubah, Anda harus memanggilclearTileCache()
setelahnya untuk memastikan bahwa kartu sebelumnya tidak lagi dirender.- Indeks Z
- Urutan penggambaran overlay ubin ini sehubungan dengan overlay lainnya (termasuk
GroundOverlay
,Circle
,Polyline
, danPolygon
, tetapi tidakMarker
). 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. - Transparansi
- Transparansi overlay ubin 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 ubin 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 ubin terlihat atau tidak terlihat, yaitu apakah overlay digambar di peta. Overlay ubin yang tidak terlihat tidak digambar, tetapi mempertahankan semua propertinya yang lain. Defaultnya adalah
true
, yaitu terlihat.
Anda hanya boleh memanggil metode dalam class ini pada thread utama. Jika hal ini tidak dilakukan, IllegalStateException
akan ditampilkan.
Koordinat Petak
Perhatikan bahwa dunia diproyeksikan menggunakan proyeksi Mercator (lihat Wikipedia) dengan sisi kiri (barat) peta sesuai dengan bujur -180 derajat dan sisi kanan (timur) peta sesuai dengan 180 derajat bujur. Untuk membuat peta berbentuk persegi, sisi atas (utara) peta sesuai dengan 85,0511 derajat lintang dan sisi bawah (selatan) peta sesuai dengan -85,0511 derajat lintang. Area di luar rentang lintang ini tidak dirender.
Pada setiap tingkat zoom, peta dibagi menjadi ubin dan hanya ubin yang tumpang tindih dengan layar yang akan didownload dan dirender. Setiap ubin berbentuk persegi dan peta dibagi menjadi ubin sebagai berikut:
- Pada tingkat zoom 0, satu ubin mewakili seluruh dunia. Koordinat ubin tersebut adalah (x, y) = (0, 0).
- Pada tingkat zoom 1, dunia dibagi menjadi 4 ubin yang disusun dalam kisi 2 x 2.
- ...
- Pada tingkat zoom N, dunia dibagi menjadi 4N ubin yang disusun dalam petak 2N x 2N.
GoogleMap.getMinZoomLevel
dan tingkat zoom maksimum adalah GoogleMap.getMaxZoomLevel
.
Koordinat ubin diukur dari sudut kiri atas (barat laut) peta. Pada
tingkat zoom N, nilai x
koordinat ubin berkisar antara 0 hingga 2N - 1 dan
meningkat dari barat ke timur dan nilai y
berkisar dari 0 hingga 2N - 1 dan
meningkat dari utara ke selatan.
Contoh
GoogleMap map; // ... get a map.
TileProvider tileProvider; // ... create a tile provider.
TileOverlay tileOverlay = map.addTileOverlay(
new TileOverlayOptions().tileProvider(tileProvider));
Ringkasan Metode Publik
void |
clearTileCache()
Menghapus cache ubin sehingga semua ubin akan diminta lagi dari
TileProvider . |
boolean |
sama dengan(Objek lainnya)
Menguji apakah
TileOverlay ini sama dengan yang lain. |
boolean |
getFadeIn()
Mendapatkan apakah ubin overlay akan memudar.
|
String |
getId()
Mendapatkan ID overlay ubin ini.
|
float |
getTransparency()
Mendapatkan transparansi overlay ubin ini.
|
float |
getZIndex()
Mendapatkan zIndex overlay ubin ini.
|
int |
hashCode()
|
boolean |
isVisible()
Mendapatkan visibilitas overlay ubin ini.
|
void |
remove()
Menghapus overlay ubin ini dari peta.
|
void |
setFadeIn(boolean fadeIn)
Menetapkan apakah ubin overlay akan makin jelas terlihat.
|
void |
setTransparency(transparansi float)
Menyetel transparansi overlay ubin ini.
|
void |
setVisible(boolean terlihat)
Setel visibilitas overlay ubin ini.
|
void |
setZIndex(float zIndex)
Menetapkan zIndex overlay ubin ini.
|
Ringkasan Metode Turunan
Metode Publik
public void clearTileCache ()
Menghapus cache ubin sehingga semua ubin akan diminta lagi dari TileProvider
.
Ubin saat ini dari overlay ubin ini juga akan dihapus dari peta setelah memanggil metode ini. API mempertahankan cache kecil dalam memori untuk kartu. Jika ingin meng-cache ubin lebih lama, Anda harus mengimplementasikan cache di disk.
boolean publik sama dengan (Objek lainnya)
Menguji apakah TileOverlay
ini sama dengan yang lain.
Parameter
lainnya | Object . |
---|
Hasil
- true jika kedua objek adalah objek yang sama, yaitu, ini == other.
boolean publik getFadeIn ()
Mendapatkan apakah ubin overlay akan memudar.
Hasil
true
jika ubin akan terlihat jelas;false
jika tidak.
public String getId ()
Mendapatkan ID overlay ubin ini.
float publik getTransparency ()
Mendapatkan transparansi overlay ubin ini.
Hasil
- transparansi overlay ubin ini.
float publik getZIndex ()
Mendapatkan zIndex overlay ubin ini.
Hasil
- zIndex overlay ubin.
public int hashCode ()
boolean publik isVisible ()
Mendapatkan visibilitas overlay ubin ini. Perhatikan bahwa ini tidak menampilkan apakah overlay ubin benar-benar berada dalam area pandang layar, tetapi apakah overlay akan digambar jika terdapat dalam area pandang layar.
Hasil
- visibilitas overlay ubin ini.
public void remove ()
Menghapus overlay ubin ini dari peta.
public void setFadeIn (boolean fadeIn)
Menetapkan apakah ubin overlay akan makin jelas terlihat.
Parameter
fadeIn | true untuk membuat ubin terlihat jelas; false untuk merendernya secara instan.
|
---|
void publik setTransparency (transparansi mengambang)
Menyetel transparansi overlay ubin ini. Lihat dokumentasi di bagian atas class ini untuk mengetahui informasi selengkapnya.
Parameter
transparansi | float dalam rentang [0..1] dengan 0 berarti overlay ubin buram dan 1 berarti overlay ubin transparan.
|
---|
publik void setVisible (boolean visible)
Setel visibilitas overlay ubin ini. Jika tidak terlihat, overlay ubin tidak akan digambar, tetapi akan menyimpan semua properti lainnya. Overlay ubin terlihat secara default.
Parameter
terlihat | true untuk membuat overlay ini terlihat; false untuk membuatnya tidak terlihat.
|
---|
public void setZIndex (float zIndex)
Menetapkan zIndex overlay ubin ini. Lihat dokumentasi di bagian atas class ini untuk informasi selengkapnya.
Parameter
zIndex | zIndex overlay ubin ini. |
---|