Tujuan heatmapTiles menyediakan peta panas terkait serbuk sari melalui overlay petak peta. Overlay ubin adalah kumpulan ubin gambar yang dapat ditampilkan di atas Google Maps. Masing-masing ubin gambar adalah 256 x 256 piksel.
Overlay ubin adalah kisi-kisi yang disusun dari sekumpulan ubin, masing-masing ditempatkan
(X
,Y
). Ubin dengan koordinat (0,0) selalu berada di
sudut barat laut peta. Nilai X
meningkat dari barat ke timur, sedangkan
nilai Y
meningkat dari utara ke selatan.
zoom level
menentukan seberapa besar atau kecil konten peta muncul di
tampilan peta. Ukuran petak ubin ditentukan dengan menskalakan X
dan Y
koordinat secara eksponensial sesuai tingkat zoom.
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
Misalnya, pada tingkat zoom 2, peta dunia ditampilkan menggunakan ukuran 4 x 4 , dengan total 16 ubin.
Gambar berikut menampilkan peta panas TREE_UPI
di seluruh dunia, yang dibagi-bagi
menjadi ubin yang bisa diakses pada tingkat zoom 2.
Lihat Peta dan Ubin koordinat untuk detail tambahan.
Anda dapat meminta ubin peta panas serbuk sari saat ini menggunakan heatmapTiles endpoint dengan mengirimkan permintaan GET HTTP ke:
https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY
Tentang endpoint peta panas
Semua parameter yang tercantum di bawah diperlukan agar permintaan berhasil:
KEY
: Kunci API aplikasi Anda. Kunci ini mengidentifikasi aplikasi Anda untuk untuk keperluan manajemen kuota. Pelajari cara mendapatkan .TYPE
: Jenis peta panas yang akan ditampilkan. Lihat diizinkan lainnya.Z
: Tingkat zoom yang menentukan seberapa besar atau kecil konten peta akan muncul di tampilan peta. Nilai yang diizinkan adalah 0-16, dengan nilai 0 ditampilkan seluruh dunia dalam satu ubin.X
,Y
: Koordinat ubin relatif terhadap sudut timur laut (0,0).X
nilai meningkat dari barat ke timur dan nilaiY
meningkat dari utara ke timur selatan. Koordinat harus valid untuk tingkat zoom yang ditentukan. Misalnya, jika Anda mengatur tingkat zoom ke 2 dan meminta ubin pada koordinat (10,10), API akan menampilkan error.
Contoh permintaan peta panas
Gambar di atas menampilkan peta panas TREE_UPI
dengan tingkat zoom 2, beserta
koordinat setiap ubin. Contoh berikut menggunakan heatmapTiles
untuk meminta ubin pada koordinat (2,1):
https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY
Petak muncul sebagai gambar yang dapat ditempatkan pada peta:
Untuk informasi selengkapnya tentang menghamparkan ubin di atas peta default, lihat Jenis Peta Overlay.