熱視圖

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 時存取。

詳情請參閱「地圖與圖塊座標」。

您可以將 HTTP GET 要求傳送至下列網址，使用 heatmapTiles 端點要求目前的 pollen 熱度圖圖塊：

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

圖塊會顯示為可疊加在地圖上的圖片：

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