热图

通过 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 热图， 以及每个图块的坐标：

以 4 x 4 网格表示的整个世界的热图。

请参阅地图和图块坐标 了解更多详情。

热图端点简介

热图图块由包含图块数据的字节数组表示（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，并在 则 API 会返回错误。

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

热图请求示例

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

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

该板块显示如下：

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

有关在默认地图上方叠加图块的更多信息，请参见 叠加层地图类型。