Endpoint
heatmapTiles
menyediakan peta panas terkait kualitas udara melalui overlay kartu. Overlay ubin adalah kumpulan ubin gambar PNG yang dapat ditampilkan di atas Peta Google. Setiap ubin gambar berukuran (256 x 256 piksel).
Tentang kartu peta panas
Overlay ubin adalah petak yang disusun dari kumpulan ubin,
masing-masing diberi koordinat (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 yang muncul 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. Zoom juga menentukan nilai maksimum yang diizinkan untuk koordinat.
Gambar berikut menampilkan peta panas US_AQI
dengan tingkat zoom 2,
beserta koordinat setiap ubin:
Lihat Koordinat Peta dan Ubin untuk detail tambahan.
Tentang endpoint peta panas
Kartu peta panas direpresentasikan oleh array byte yang berisi data kartu sebagai gambar PNG. Anda meminta ubin peta panas kualitas udara saat ini menggunakan endpoint heatmapTiles
dengan mengirimkan permintaan GET HTTP ke:
https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY
Semua parameter permintaan diperlukan dalam permintaan:
TYPE
- Peta panas jenis yang akan ditampilkan. Lihat nilai yang diizinkan.Z
- Tingkat zoom yang menentukan seberapa besar atau kecil konten peta muncul dalam tampilan peta. Nilai yang diizinkan adalah 0-16, dengan nilai 0 menampilkan seluruh dunia dalam satu ubin.X
,Y
- Koordinat kartu yang akan diambil, relatif terhadap sudut barat utara (0,0). NilaiX
meningkat dari barat ke timur dan nilaiY
meningkat dari utara ke selatan.Koordinat ubin 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.
YOUR_API_KEY
- Kunci API aplikasi Anda. Kunci ini mengidentifikasi aplikasi Anda untuk keperluan manajemen kuota. Untuk informasi selengkapnya, lihat mendapatkan kunci.
Contoh permintaan peta panas
Gambar di atas menunjukkan peta panas US_AQI
dengan tingkat zoom 2,
beserta koordinat setiap ubin. Contoh berikut menggunakan
endpoint heatmapTiles
untuk meminta ubin pada koordinat 0,1 dari
peta panas:
https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY
Kartu akan muncul sebagai:
Untuk mengetahui informasi selengkapnya tentang menempatkan ubin di atas peta default, lihat Jenis Peta Overlay.