Peta Panas

Tujuan heatmapTiles menyediakan peta panas terkait kualitas udara melalui overlay petak peta. Ubin adalah kumpulan ubin gambar PNG yang dapat ditampilkan di atas di Google Maps. Setiap ubin gambar berukuran (256 x 256 piksel).

Tentang kartu peta panas

Overlay ubin adalah petak yang disusun dari sekumpulan ubin, setiap koordinat (X,Y) yang ditetapkan. Ubin dengan koordinat (0,0) selalu berada di sudut barat laut dalam peta. Nilai X meningkat dari barat ke timur, sedangkan nilai Y naik 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. Zoom juga menentukan nilai maksimum yang diizinkan untuk koordinat.

Gambar berikut menampilkan peta panas US_AQI dengan tingkat zoom 2, beserta koordinat setiap ubin:

Peta panas seluruh dunia dalam bentuk grid 4 x 4.

Lihat Koordinat Peta dan Ubin untuk detail tambahan.

Tentang endpoint peta panas

Kartu peta panas direpresentasikan oleh array byte yang berisi data ubin sebagai PNG gambar. Anda meminta ubin peta panas kualitas udara saat ini menggunakan heatmapTiles endpoint 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 - 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 yang akan diambil, relatif terhadap utara sudut barat (0,0). Nilai X meningkat dari barat ke timur dan Y nilai meningkat dari utara ke selatan.

    Koordinat ubin harus valid untuk tingkat zoom yang ditentukan. Misalnya, jika Anda menyetel tingkat zoom ke 2, dan meminta ubin di koordinat 10,10, maka API akan menampilkan error.

  • YOUR_API_KEY - Kunci API aplikasi Anda. Kunci ini mengidentifikasi aplikasi untuk keperluan manajemen kuota. Untuk informasi selengkapnya, lihat dapatkan kunci.

Contoh permintaan peta panas

Gambar di atas menampilkan peta panas US_AQI dengan tingkat zoom 2, bersama dengan koordinat setiap ubin. Contoh berikut menggunakan 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

Kotak akan muncul sebagai:

Ubin peta panas pada koordinat 0,1.

Untuk informasi selengkapnya tentang menghamparkan ubin di atas peta default, lihat Jenis Peta Overlay.