Gaya visual peta baru akan segera tersedia di Google Maps Platform. Perubahan pada gaya visual peta ini mencakup palet warna default baru dan peningkatan pada pengalaman dan kegunaan peta. Semua gaya peta akan otomatis diperbarui pada Maret 2025. Untuk mengetahui informasi selengkapnya tentang ketersediaan dan cara ikut menggunakan versi terbaru ini lebih awal, lihat artikel Gaya peta baru untuk Google Maps Platform.

Halaman ini diterjemahkan oleh Cloud Translation API.

TileOverlay

class final publik TileOverlay memperluas Objek

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

Penyedia Kartu: TileProvider menyediakan gambar yang digunakan di overlay petak peta. Anda harus menentukan penyedia petak sebelum ditambahkan ke peta. Penyedia kartu tidak boleh diubah setelah ditambahkan; Namun, Anda dapat mengubah perilaku penyedia kartu untuk mengembalikan gambar yang berbeda untuk koordinat tertentu. Jika kartu yang disediakan oleh kartu perubahan penyedia layanan, 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 tidak Marker). Overlay dengan indeks z yang lebih besar digambar di atas overlay dengan indeks z. Urutan hamparan dengan indeks-z yang sama tidak didukung. Default zIndex adalah 0.
Transparansi: Transparansi overlay ubin 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 menentukan 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 petak peta terlihat atau tidak terlihat, misalnya apakah overlay digambar di atas peta. Overlay ubin yang tidak terlihat tidak digambar, namun mempertahankan semua properti lainnya. Tujuan defaultnya adalah true, yaitu, dapat dilihat.

Anda hanya boleh memanggil metode di class ini pada thread utama. Kegagalan untuk melakukannya akan mengakibatkan IllegalStateException.

Koordinat Petak

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

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

Pada tingkat zoom 0, satu ubin mewakili seluruh dunia. Koordinat ubin itu adalah (x, y) = (0, 0).
Pada tingkat zoom 1, dunia dibagi menjadi 4 ubin yang disusun dalam grid 2 x 2.
...
Pada tingkat zoom N, dunia dibagi menjadi 4^N ubin yang disusun dalam 2^N petak 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. Di tingkat zoom N, nilai x koordinat ubin berkisar antara 0 hingga 2^N - 1 dan naik 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 petak overlay akan semakin jelas.
String	getId() Mendapatkan ID overlay ubin ini.
float	getTransparency() Mendapatkan transparansi overlay ubin ini.
float	getZIndex() Mendapatkan zIndex dari overlay petak peta ini.
int	hashCode()
boolean	isVisible() Mendapatkan visibilitas overlay ubin ini.
void	remove() Menghapus overlay ubin ini dari peta.
void	setFadeIn(boolean fadeIn) Menetapkan apakah petak overlay akan makin jelas.
void	setTransparency(transparansi mengambang) Mengatur transparansi overlay ubin ini.
void	setVisible(boolean visible) Mengatur visibilitas overlay ubin ini.
void	setZIndex(float zIndex) Menetapkan zIndex overlay petak peta ini.

Ringkasan Metode Turunan

Dari class java.lang.Object

boolean	equals(Object arg0)
final Kelas<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Metode Publik

publik kosong clearTileCache ()

Menghapus cache kartu sehingga semua ubin akan diminta lagi dari TileProvider. Ubin saat ini dari overlay ubin juga akan dihapus dari peta setelah memanggilnya . API ini mempertahankan cache kartu dalam memori yang kecil. Jika Anda ingin membuat {i>cache<i} ubin untuk lagi, Anda harus menerapkan {i>cache<i} pada {i>disk<i}.

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

publik boolean getFadeIn ()

Mendapatkan apakah petak overlay akan semakin jelas.

Hasil

true jika kartunya perlahan memudar; false jika tidak.

publik {i>String<i} getId ()

Mendapatkan ID overlay ubin ini.

publik mengambang getTransparency ()

Mendapatkan transparansi overlay ubin ini.

Hasil

transparansi overlay ubin ini.

publik mengambang getZIndex ()

Mendapatkan zIndex dari overlay petak peta ini.

Hasil

zIndex overlay petak peta.

publik Int hashCode ()

publik boolean isVisible ()

Mendapatkan visibilitas overlay ubin ini. Perhatikan bahwa ini tidak menampilkan apakah kartu overlay sebenarnya berada dalam area pandang layar, namun apakah akan digambar jika yang ada di area pandang layar.

Hasil

visibilitas overlay ubin ini.

publik kosong hapus ()

Menghapus overlay ubin ini dari peta.

publik kosong setFadeIn (boolean fadeIn)

Menetapkan apakah petak overlay akan makin jelas.

Parameter

fadeIn	`true` untuk membuat ubin memudar; `false` untuk merendernya secara instan.

publik kosong setTransparency (transparansi mengambang)

Mengatur transparansi overlay ubin ini. Lihat dokumentasi di bagian atas kelas ini untuk informasi selengkapnya.

Parameter

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

publik kosong setVisible (boolean terlihat)

Mengatur visibilitas overlay ubin ini. Jika tidak terlihat, overlay petak peta tidak akan digambar, namun mempertahankan semua properti lainnya. Overlay ubin terlihat secara default.

Parameter

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

publik kosong setZIndex (zIndex mengambang)

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

Parameter

zIndex	zIndex overlay petak peta ini.