Peta Panas

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

Tentang kartu peta panas

Overlay petak adalah petak yang disusun dari kumpulan petak, yang 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 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 petak:

Peta panas seluruh dunia dalam bentuk petak 4x4.

Lihat Koordinat Peta dan Ubin untuk mengetahui detail tambahan.

Tentang endpoint peta panas

Petak peta panas direpresentasikan oleh array byte yang berisi data petak sebagai gambar PNG. Anda meminta petak peta panas kualitas udara saat ini menggunakan endpoint heatmapTiles dengan mengirim permintaan HTTP GET 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 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 petak.

  • X,Y - Koordinat petak yang akan diambil, relatif terhadap sudut barat laut (0,0). Nilai X meningkat dari barat ke timur dan nilai Y meningkat dari utara ke selatan.

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

  • YOUR_API_KEY - Kunci API aplikasi Anda. Kunci ini mengidentifikasi aplikasi Anda untuk tujuan pengelolaan kuota. Untuk mengetahui 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 petak di 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:

Petak peta panas pada koordinat 0,1.

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