heatmapTiles
端點會透過圖塊疊加層提供空氣品質相關的熱視圖。圖塊疊加層是一組 PNG 圖片圖塊,可以在 Google 地圖上方顯示。每個圖片圖塊都是 (256 x 256 像素)。
關於熱視圖圖塊
圖塊疊加層是從一組圖塊組合組成的格線,每個圖塊都指派了 (X
、Y
) 座標。座標為 (0,0) 的圖塊一律位於地圖的西北角。X
值會從西到東增加,Y
值則從北到南增加。
zoom level
用來決定地圖內容在地圖檢視畫面中顯示的大小。圖塊格線大小取決於縮放等級,縮放 X
和 Y
座標。
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
舉例來說,縮放等級為 2 時,世界地圖會以 4 x 4 矩陣表示,總共 16 個圖塊。縮放也會決定座標允許的最大值。
下圖顯示縮放等級為 2 的 US_AQI
熱視圖,以及每個圖塊的座標:
詳情請參閱「地圖和圖塊座標」。
關於熱視圖端點
熱視圖圖塊以位元組陣列表示,其中包含以 PNG 圖片表示的圖塊資料。您可以使用 heatmapTiles
端點,要求目前的空氣品質熱視圖圖塊,方法是傳送 HTTP GET 要求至:
https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY
要求中的所有要求參數都必須符合以下條件:
TYPE
- 要傳回的類型熱視圖。請參閱允許的值。Z
:用來決定地圖檢視中地圖內容大小的縮放等級。允許的值為 0 到 16,值為 0 會在單一資訊方塊中顯示整個世界。X
、Y
- 以西北角 (0,0) 為基準的要擷取圖塊的座標。X
值會從西到東遞增,Y
值則從北到南遞增。圖塊座標必須為指定的縮放等級的有效值。舉例來說,如果您將縮放等級設為 2,並以 10,10 座標要求資訊方塊,API 就會傳回錯誤。
YOUR_API_KEY
- 應用程式的 API 金鑰。為了管理配額,此金鑰會識別您的應用程式。詳情請參閱取得金鑰。
熱視圖要求範例
上圖顯示縮放等級為 2 的 US_AQI
熱視圖,以及每個圖塊的座標。以下範例使用 heatmapTiles
端點,從熱視圖要求座標為 0,1 的圖塊:
https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY
圖塊看起來如下:
如要進一步瞭解如何在預設地圖上方疊加圖塊,請參閱「疊加層地圖類型」一文。