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 存取的圖塊。
請參閱地圖和圖塊 座標 來瞭解詳情。
您可以使用 要求目前花粉的熱視圖圖塊 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
這個方塊會以可覆蓋在地圖上的圖片形式顯示:
如要進一步瞭解如何在預設地圖上方疊加圖塊,請查閱 疊加層地圖類型。