Peta Panas

Endpoint heatmapTiles menyediakan peta panas terkait serbuk sari melalui overlay petak peta. Overlay ubin adalah kumpulan ubin gambar yang dapat ditampilkan di atas Google Maps. Setiap petak gambar berukuran 256 x 256 piksel.

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

Gambar berikut menunjukkan peta panas TREE_UPI seluruh dunia, yang dibagi menjadi ubin yang dapat diakses pada tingkat zoom 2.

Peta panas seluruh dunia sebagai petak 4 kali 4.

Lihat Koordinat Peta dan Ubin untuk mengetahui detail tambahan.

Anda dapat meminta petak peta panas serbuk sari saat ini menggunakan endpoint heatmapTiles dengan mengirim 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 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 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 peta relatif terhadap sudut timur laut (0,0). Nilai X bertambah dari barat ke timur dan nilai Y bertambah dari utara ke selatan. Koordinat 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.

Contoh permintaan peta panas

Gambar di atas menunjukkan peta panas TREE_UPI dengan tingkat zoom 2, beserta koordinat setiap ubin. Contoh berikut menggunakan endpoint heatmapTiles untuk meminta petak di 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 dihamparkan di peta:

Contoh ubin peta panas yang menggunakan peta TREE_UPI.

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