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
圖塊會顯示為可疊加在地圖上的圖片:
如要進一步瞭解如何在預設地圖上方疊加圖塊,請參閱「疊加層地圖類型」一文。