熱視圖

heatmapTiles 端點透過圖塊疊加層提供花粉相關的熱視圖。圖塊疊加層 是可在「Google 地圖」上方顯示的圖片圖塊集。每項 圖片圖塊就是 256 x 256 像素

圖塊疊加層是透過一組圖塊組合而成的格狀檢視畫面，每個圖塊都被指派 (X,Y) 座標。座標為 (0,0) 的圖塊一律位於 地圖的西北角。X 值由西到東遞增， Y 值由北到南遞增。

zoom level 可決定地圖內容在 地圖檢視。圖塊格線大小取決於縮放 X 和 Y 依據縮放等級，以指數方式進行座標。

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

例如，縮放等級為 2 時，世界地圖是以 4 x 4 來表示 矩陣，總共 16 個圖塊。

下圖顯示了全世界各個時段的 TREE_UPI 熱視圖， 轉換為可以在縮放等級 2 存取的圖塊。

以 4 x 4 方格呈現整個世界的熱視圖。

請參閱地圖和圖塊 座標 來瞭解詳情。

您可以使用 要求目前花粉的熱視圖圖塊 heatmapTiles 方法是傳送 HTTP GET 要求到：

https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

關於熱視圖端點

成功請求時，需要下列所有參數：

  • KEY：應用程式的 API 金鑰。這組金鑰會找出 方便您管理配額瞭解如何取得 鍵。
  • TYPE：要傳回的熱視圖類型。查看允許 值。
  • Z：決定地圖內容大小的縮放等級 出現在地圖檢視中有效值為 0 到 16，值為 0 會顯示 全世界。
  • X、Y：相對於東北角 (0,0) 的圖塊座標。X 值從西到東增加，Y值則從北到增加 南。座標必須能對指定的縮放等級有效。例如： 如果您將縮放等級設為 2，並在座標 (10,10) 要求地圖方塊， API 會傳回錯誤

熱視圖要求範例

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

https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY

這個方塊會以可覆蓋在地圖上的圖片形式顯示：

使用 TREE_UPI 地圖的熱視圖圖塊範例。

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