Halaman ini diterjemahkan oleh Cloud Translation API.

TileOverlay

class final publik TileOverlay memperluas Object

Overlay Ubin adalah serangkaian gambar yang ditampilkan di atas ubin peta dasar. Ubin ini mungkin transparan, sehingga Anda dapat menambahkan fitur ke peta yang ada. Overlay ubin memiliki properti berikut:

Penyedia Kartu: TileProvider menyediakan gambar yang digunakan dalam overlay ubin. Anda harus menentukan penyedia ubin sebelum ditambahkan ke peta. Penyedia ubin tidak dapat diubah setelah ditambahkan; namun, Anda dapat memodifikasi perilaku penyedia ubin agar menampilkan gambar yang berbeda untuk koordinat tertentu. Jika ubin yang disediakan oleh penyedia ubin berubah, Anda harus memanggil clearTileCache() setelahnya untuk memastikan bahwa ubin sebelumnya tidak lagi dirender.
Indeks Z: Urutan penggambaran overlay ubin ini sehubungan dengan overlay lainnya (termasuk GroundOverlay, Circle, Polyline, dan Polygon, tetapi bukan Marker). Overlay dengan indeks z yang lebih besar akan digambar pada 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] 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 ubin sebagai 0,25, maka piksel akan dirender pada layar dengan nilai alfa 150). Spesifikasi properti ini bersifat opsional dan transparansi defaultnya adalah 0 (buram).
Visibilitas: Menunjukkan apakah overlay ubin terlihat atau tidak terlihat, misalnya apakah gambar tersebut digambar di peta. Overlay ubin yang tidak terlihat tidak digambar, tetapi mempertahankan semua properti lainnya. Default-nya adalah true, yaitu terlihat.

Anda hanya boleh memanggil metode di class ini pada thread utama. Jika tidak dilakukan, IllegalStateException akan muncul.

Koordinat Petak

Perhatikan bahwa dunia diproyeksikan menggunakan proyeksi Mercator (lihat Wikipedia) dengan sisi kiri (barat) peta yang terkait dengan -180 derajat bujur dan sisi kanan (timur) peta sesuai 180 derajat bujur. Untuk membuat peta persegi, sisi atas (utara) peta sesuai dengan garis lintang 85,0511 derajat dan sisi bawah (selatan) peta setara dengan garis lintang -85,0511 derajat. Area di luar rentang lintang ini tidak dirender.

Pada setiap tingkat zoom, peta dibagi menjadi beberapa ubin dan hanya ubin yang tumpang tindih dengan layar yang akan didownload dan dirender. Setiap ubin berbentuk persegi dan peta dibagi menjadi ubin-ubin sebagai berikut:

Pada tingkat zoom 0, satu ubin merepresentasikan 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 4^N ubin yang disusun dalam petak 2^N x 2^N.

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 dari 0 hingga 2^N - 1 dan meningkat dari barat ke timur dan nilai y berkisar dari 0 hingga 2^N - 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 kartu 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 memudar.
void	setTransparency(transparansi mengambang) Menetapkan transparansi overlay ubin ini.
void	setVisible(boolean terlihat) Menetapkan visibilitas overlay ubin ini.
void	setZIndex(float zIndex) Menetapkan zIndex overlay ubin 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

publik void clearTileCache ()

Menghapus cache kartu 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 menyimpan cache kecil dalam memori ubin. Jika ingin meng-cache ubin lebih lama, Anda harus mengimplementasikan cache pada 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 == other.

boolean publik getFadeIn ()

Mendapatkan apakah ubin overlay akan memudar.

Hasil

true jika ubin akan memudar; false jika tidak.

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

int publik hashCode ()

boolean publik isVisible ()

Mendapatkan visibilitas overlay ubin ini. Perhatikan bahwa hal ini tidak akan menampilkan apakah overlay ubin sebenarnya berada dalam area pandang layar, tetapi akan digambar jika overlay di area pandang layar.

Hasil

visibilitas overlay ubin ini.

publik void remove ()

Menghapus overlay ubin ini dari peta.

publik void setFadeIn (boolean fadeIn)

Menetapkan apakah ubin overlay akan memudar.

Parameter

pudar	`true` untuk membuat kartu memudar; `false` untuk merendernya secara instan.

publik void setTransparency (transparansi mengambang)

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

Parameter

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

publik void setVisible (booleanvisible)

Menetapkan visibilitas overlay ubin ini. Jika tidak terlihat, overlay ubin tidak digambar, tetapi menyimpan semua properti lainnya. Overlay ubin terlihat secara default.

Parameter

terlihat	`true` untuk membuat overlay ini terlihat; `false` untuk membuatnya tidak terlihat.

publik void setZIndex (float zIndex)

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

Parameter

Indeks	zIndex overlay ubin ini.