热图

heatmapTiles 端点通过功能块叠加层提供与花粉相关的热图。图块叠加层是可在 Google 地图上显示的一组图块图片。每个图片图块的大小为 256 x 256 像素。

功能块叠加层是由一组功能块组成的网格,每个功能块都分配了 (X,Y) 坐标。坐标为 (0,0) 的图块始终位于地图的西北角。X 值从西向东增加,Y 值从北向南增加。

zoom level 用于确定地图内容在地图视图中的显示大小。图块网格大小取决于按缩放级别对 XY 坐标进行指数缩放。

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 表示整个世界使用单个图块渲染。
  • XY:相对于东北角 (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 地图的热图图块示例。

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