Endpoint heatmapTiles menyediakan peta panas terkait serbuk sari melalui overlay ubin. Overlay ubin adalah kumpulan ubin gambar yang dapat ditampilkan di atas Google Maps. Setiap kartu gambar berukuran 256x256 piksel.
Overlay ubin adalah petak yang disusun dari kumpulan ubin, yang masing-masing ditetapkan koordinat
(X
,Y
). Petak 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 tampilan konten peta dalam
tampilan peta. Ukuran petak ubin ditentukan dengan menskalakan koordinat X
dan Y
secara eksponensial berdasarkan tingkat zoom.
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
Misalnya, pada tingkat zoom 2, peta dunia direpresentasikan menggunakan matriks 4 x 4, dengan total 16 ubin.
Gambar berikut menampilkan peta panas TREE_UPI
seluruh dunia, yang dibagi
menjadi ubin yang dapat diakses pada tingkat zoom 2.
Lihat Koordinat Peta dan Kartu untuk mengetahui detail tambahan.
Anda dapat meminta ubin peta panas serbuk sari saat ini menggunakan endpoint heatmapTiles dengan mengirimkan permintaan HTTP GET 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 tujuan pengelolaan kuota. Pelajari cara mendapatkan kunci.TYPE
: Jenis peta panas yang akan ditampilkan. Lihat nilai yang diizinkan.Z
: Tingkat zoom yang menentukan seberapa besar atau kecil tampilan konten peta dalam tampilan peta. Nilai yang diizinkan adalah 0–16, dengan nilai 0 menampilkan seluruh dunia dalam satu kartu.X
,Y
: Koordinat ubin relatif ke sudut timur laut (0,0). NilaiX
meningkat dari barat ke timur dan nilaiY
meningkat dari utara ke selatan. Koordinat harus valid untuk tingkat zoom yang ditentukan. Misalnya, jika Anda menetapkan 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 endpoint
heatmapTiles
untuk meminta ubin pada koordinat (2,1):
https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY
Ubin muncul sebagai gambar yang dapat ditempatkan pada peta:
Untuk informasi selengkapnya tentang menempatkan ubin di atas peta default, lihat Jenis Peta Overlay.