热图

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

热图图块简介

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

zoom level 用于确定地图内容在地图视图中显示的大小。图块网格大小是通过按缩放级别以指数方式缩放 XY 坐标来确定的。

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 在单个图块中显示整个世界。

  • XY - 要检索的图块的坐标(相对于西北角 (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) 的热图图块。

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