历史

history 端点提供 特定位置在特定位置的每小时历史空气质量信息, 时间范围,最长为 30 天。您可以控制哪些 AQI 和 返回相关信息(如污染物浓度水平和 健康建议)。

您可以使用 history 端点,方法是将 HTTP POST 请求发送到:

https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY

在 JSON 中包含您的请求选项 请求正文。请求正文 包含您希望获取 每小时的空气质量历史记录。它还包含各种用于控制 要在响应中包含哪些空气质量信息。

借助 API Explorer,您可以发出实时请求 API 和 API 选项:

试试看!

一小时请求示例

单小时请求正文

以下代码展示了如何构建单个小时的请求正文 检索历史记录请求 history 方法。 在此示例中,您设置了位置和过去的时间戳。

curl -X POST -d '{
  "dateTime": "2023-06-26T15:01:23Z",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

一小时响应

上述调用会生成以下内容 JSON 响应。 如需详细了解响应数据,请参阅响应数据

{
    "hoursInfo": [
        {
            "dateTime": "2023-06-26T15:00:00Z",
            "indexes": [
                {
                    "code": "uaqi",
                    "displayName": "Universal AQI",
                    "aqi": 73,
                    "aqiDisplay": "73",
                    "color": {
                        "red": 118,
                        "green": 202,
                        "blue": 51,
                        "alpha": 255
                    },
                    "category": "Good air quality",
                    "dominantPollutant": "pm10"
                }
            ]
        }
    ],
    "regionCode": "us"
}

时间范围请求示例

时间范围请求

以下代码展示了如何为 history,该函数会返回多个 历史每小时空气质量记录。

您可以通过指定时间范围(表示开始时间)来请求多条记录。 和结束时间戳,也可以指定从当前时间戳开始还有的小时数 。

在下面的示例中,由于您将页面大小设置为 2,因此对 系统会分两个页面返回 4 小时的空气质量历史记录, 包含两小时的数据

curl -X POST -d '{
  "hours": 4,
  "pageSize": 2,
  "pageToken":"",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

您可以通过传递开始和结束时间戳来发出类似的请求:

curl -X POST -d '{
  "period": {
      "startTime":"2023-06-15T08:00:00Z",
      "endTime":"2023-06-15T12:00:00Z"
  },
  "pageSize": 2,
  "pageToken":"",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

时间范围响应

上述调用会生成 JSON 响应,形式为 。如需详细了解响应数据,请参阅 响应数据

上述两个通话都请求 4 小时的空气质量数据。但是,由于您将 将 pageSize 属性设置为 2,则响应仅包含 最近两个小时的搜索结果。

{
    "hoursInfo": [
        {
            "dateTime": "2023-06-15T11:00:00Z",
            "indexes": [
                {
                    "code": "uaqi",
                    "displayName": "Universal AQI",
                    "aqi": 83,
                    "aqiDisplay": "83",
                    "color": {
                        "red": 74,
                        "green": 185,
                        "blue": 54,
                        "alpha": 255
                    },
                    "category": "Excellent air quality",
                    "dominantPollutant": "o3"
                }
            ]
        },
        {
            "dateTime": "2023-06-15T10:00:00Z",
            "indexes": [
                {
                    "code": "uaqi",
                    "displayName": "Universal AQI",
                    "aqi": 89,
                    "aqiDisplay": "89",
                    "color": {
                        "red": 48,
                        "green": 175,
                        "blue": 55,
                        "alpha": 255
                    },
                    "category": "Excellent air quality",
                    "dominantPollutant": "o3"
                }
            ]
        }
    ],
    "regionCode": "us",
    "nextPageToken": "ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA"
}

请注意,响应还包含 nextPageToken 属性。使用此属性可访问下一页结果,其中包含接下来两小时的数据。

要访问下一页结果,请再次向 history 端点,但这次将 pageToken 属性设置为 第一个响应中 nextPageToken 的值。

curl -X POST -d '{
  "hours": 4,
  "pageSize": 2,
  "pageToken":"ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'