熱視圖

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 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 金鑰。此金鑰可識別 以便管理配額詳情請參閱 get 索引鍵。

熱視圖要求範例

上圖顯示縮放等級為 2 的 US_AQI 熱視圖， 以及每個圖塊的座標以下範例使用 heatmapTiles 端點，要求位於座標為 0,1 的圖塊 熱視圖：

https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY

圖塊看起來如下：

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

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