热图

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 地图的热图图块示例。

如需详细了解如何在默认地图上叠加图块，请参阅叠加层地图类型。