heatmapTiles
端点通过图块叠加层提供与空气质量相关的热图。图块叠加层是一组可在 Google 地图上显示的 PNG 图片图块。每个图片图块的大小均为 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
热图,以及每个图块的坐标:
如需了解详情,请参阅地图和图块坐标。
热图端点简介
热图图块由包含图块数据的字节数组表示(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
该板块显示如下:
如需详细了解如何在默认地图上叠加图块,请参阅叠加层地图类型。