熱視圖

heatmapTiles 端點會透過圖塊疊加層提供空氣品質相關熱力圖。圖塊疊加層是可顯示在 Google 地圖上方的 PNG 圖塊集合。每個圖片資訊方塊的大小為 (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 熱力圖，以及每個圖塊的座標：

以 4 x 4 格格呈現的全球熱力地圖。

詳情請參閱「地圖與圖塊座標」。

關於熱圖端點

熱圖圖塊會以位元組陣列表示，其中包含圖塊資料做為 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

資訊方塊會顯示如下：

座標為 0,1 的熱圖圖塊。

如要進一步瞭解如何在預設地圖上疊加圖塊，請參閱「疊加地圖類型」。