Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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:
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:
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:
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-31 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eheatmapTiles\u003c/code\u003e endpoint delivers air quality heatmaps as a tile overlay, which is a collection of PNG images displayed on top of a Google Map.\u003c/p\u003e\n"],["\u003cp\u003eEach tile within the overlay has specific (X, Y) coordinates, with (0,0) at the northwest corner and increasing values eastward (X) and southward (Y), determined by the zoom level.\u003c/p\u003e\n"],["\u003cp\u003eThe zoom level (0-16) controls the map's scale and the tile grid size, with higher zoom levels showing more detailed areas.\u003c/p\u003e\n"],["\u003cp\u003eTo request a heatmap tile, you need to provide the heatmap type, zoom level (Z), tile coordinates (X, Y), and your API key in the request URL.\u003c/p\u003e\n"],["\u003cp\u003eYou can overlay these heatmap tiles on top of the default map using methods described in the provided documentation for a comprehensive air quality visualization.\u003c/p\u003e\n"]]],[],null,["The\n[`heatmapTiles`](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile)\nendpoint provides air quality related heatmaps through a tile overlay. A tile\noverlay is a collection of PNG image tiles that can be displayed on top of a\nGoogle Maps. Each image tile is (256 x 256 pixels).\n\nAbout heatmap tiles\n\nThe tile overlay is a grid assembled from a collection of tiles,\neach assigned (`X`,`Y`) coordinates.\nThe tile with coordinates (0,0) is always at the northwest corner\nof the map. The `X` values increase from west to east,\nwhile the `Y` values increase from north to south.\n\nThe `zoom level` determines how large or small the contents of a map appear in a\nmap view. The tile grid size is determined by scaling the `X` and `Y`\ncoordinates exponentially by the zoom level. \n\n```text\ngridSizeX = XzoomLevel\ngridSizeY = YzoomLevel\n```\n\nFor example, at a zoom level of 2, the world map is represented using a 4 x 4\nmatrix, for a total of 16 tiles. The zoom also determines what is the max value\nallowed for the coordinates.\n\nThe following image shows a `US_AQI` heatmap with a zoom level of 2,\nalong with the coordinates of each tile:\n\nSee [Map and Tile coordinates](/maps/documentation/javascript/coordinates)\nfor additional details.\n\nAbout the heatmap endpoint\n\nA heatmap tile is represented by a bytes array containing the tile data as a PNG\nimage. You request current air quality heatmap tiles using the\n[`heatmapTiles`](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile)\nendpoint by sending an HTTP GET request to: \n\n```html\nhttps://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY\n```\n\nAll request parameters are required in a request:\n\n- `TYPE` - The type heatmap to return. See [allowed\n values](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile#maptype).\n\n- `Z` - Zoom level that determines how large or small the contents of a map\n appear in a map view. Allowed values are 0-16, where a value of 0 displays\n the entire world in a single tile.\n\n- `X`,`Y` - The coordinates of the tile to retrieve, relative to the north\n west corner (0,0). `X` values are increasing from west to east and `Y`\n values are increasing from north to south.\n\n Tile coordinates have to be valid for the specified zoom level.\n For example, if you set the zoom level to 2, and request a tile at\n coordinates of 10,10, the API returns an error.\n- `YOUR_API_KEY` - Your application's API key. This key identifies your\n application for purposes of quota management. For more information, see [get\n a key](/maps/documentation/air-quality/get-api-key).\n\nExample heatmap request\n\nThe image above shows a `US_AQI` heatmap with a zoom level of 2,\nalong with the coordinates of each tile. The following example uses the\n`heatmapTiles` endpoint to request the tile at coordinates 0,1 from the\nheatmap: \n\n```html\nhttps://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY\n```\n\nThe tile appears as:\n\nFor more information on overlaying tiles on top of the default map, see\n[Overlay Map Types](/maps/documentation/javascript/examples/maptype-overlay)."]]
