熱視圖

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 熱視圖，以及每個圖塊的座標：

世界的熱視圖，以 4 乘 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 的熱視圖圖塊。

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