TileOverlay

public final class TileOverlay memperluas Object

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 memanggil clearTileCache() setelahnya untuk memastikan bahwa kartu sebelumnya tidak lagi dirender.
Indeks Z
Urutan penggambaran overlay ubin ini sehubungan dengan overlay lainnya (termasuk GroundOverlay, Circle, Polyline, dan Polygon, tetapi tidak 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.
Transparansi
Transparansi overlay ubin dalam rentang [0..1] dengan 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 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.
Perhatikan bahwa tingkat zoom minimum yang didukung kamera (yang dapat bergantung pada berbagai faktor) adalah 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
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.