热图

heatmapTiles 端点通过图块叠加层提供与空气质量相关的热图。图块叠加层是 PNG 图片图块的集合，可以显示在 Google 地图之上。每个图片图块均为 256 x 256 像素。

关于热图图块

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

zoom level决定了地图内容在 地图视图中的显示大小。图块网格大小取决于按缩放级别以指数方式缩放 X 和 Y 坐标。

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

例如，在缩放级别为 2 时，世界地图使用 4 x 4 矩阵表示，总共有 16 个图块。缩放级别还决定了坐标允许的最大值。

下图显示了缩放级别为 2 的 US_AQI 热图，以及每个图块的坐标：

以 4x4 网格形式显示的世界热图。

如需了解详情，请参阅地图和图块坐标 。

关于热图端点

热图图块由字节数组表示，该数组包含 PNG 图片形式的图块数据。您可以使用 heatmapTiles 端点请求当前空气质量热图图块，方法是向以下网址发送 HTTP GET 请求：

https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

请求中需要包含所有请求参数：

  • TYPE - 要返回的热图类型。请参阅允许的 值。

  • Z - 缩放级别，决定了地图内容在地图视图中的显示大小 。允许的值为 0-16，其中值 0 表示在单个图块中显示整个世界。

  • X、Y - 要检索的图块的坐标，相对于西北角 (0,0)。X 值从西向东增加，Y 值从北向南增加。

    图块坐标必须对指定的缩放级别有效。 例如，如果您将缩放级别设置为 2，并请求坐标为 10,10 的图块，则 API 会返回错误。

  • YOUR_API_KEY - 您的应用的 API 密钥。此密钥用于标识您的应用，以便进行配额管理。如需了解详情，请参阅获取密钥。

热图请求示例

上图显示了缩放级别为 2 的 US_AQI 热图，以及每个图块的坐标。以下示例使用 heatmapTiles 端点从热图中请求坐标为 0,1 的图块：

https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY

图块显示为：

坐标为 0,1 的热力图块。

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