空气质量API

该API提供任意特定位置的当前空气污染数据，同时还可获取所选位置的空气质量预测数据以及历史空气污染数据。

注意： 历史空气污染数据自2020年11月27日起可用。

该API提供空气质量指数（AQI）及相关污染物气体的浓度数据，包括：

• 一氧化碳（CO）
• 氨气（NH₃）
• 一氧化氮（NO）
• 二氧化氮（NO₂）
• 臭氧（O₃）
• 粗颗粒物（PM₁₀）
• 细颗粒物（PM₂.₅）
• 二氧化硫（SO₂）

空气质量指数等级说明

注意： 了解空气质量指数的计算方法，请参阅相关资料。

接口地址

当前空气污染数据

通过向以下URI发送GET请求，获取指定位置的当前空气污染数据：

http://api.openweathermap.org/data/2.5/air_pollution?lat={lat}&lon={lon}&appid={APP_ID}

空气污染预报数据

通过向以下URI发送GET请求，获取指定位置的空气污染预报数据：

http://api.openweathermap.org/data/2.5/air_pollution/forecast?lat={lat}&lon={lon}&appid={APP_ID}

历史空气污染数据

通过向以下URI发送GET请求，获取指定位置的历史空气污染数据：

http://api.openweathermap.org/data/2.5/air_pollution/history?lat={lat}&lon={lon}&start={start}&end={end}&appid={APP_ID}

请求参数

示例代码

第1–2行： 输入西雅图（美国）的地理坐标 47.6038321 和 -122.3300624，分别对应参数 lat 和 lon。

点击下方工具栏中的“运行”按钮查看输出结果。

1lat = 47.6038321
2lon = -122.3300624
3
4url =   'http://api.openweathermap.org/data/2.5/air_pollution?' \
5        + 'lat=' + str(lat) + '&lon=' + str(lon) + '&appid={{APP_ID}}'
6
7response = requests.get(url)
8
9printResponse(response)

第1–2行： 输入西雅图（美国）的地理坐标 47.6038321 和 -122.3300624，分别对应参数 lat 和 lon。

点击下方工具栏中的“运行”按钮查看输出结果。

1lat = 47.6038321
2lon = -122.3300624
3
4url =   'http://api.openweathermap.org/data/2.5/air_pollution/forecast?' \
5        + 'lat=' + str(lat) + '&lon=' + str(lon) + '&appid={{APP_ID}}'
6
7response = requests.get(url)
8
9printResponse(response)

第1–2行： 输入西雅图（美国）的地理坐标 47.6038321 和 -122.3300624，分别对应参数 lat 和 lon。

第3–4行： 获取最近5天的历史空气污染数据，因此 start 和 end 参数自动设置为5天前和当前时间戳。

点击下方工具栏中的“运行”按钮查看输出结果。

1lat = 47.6038321
2lon = -122.3300624
3start = int(time.time() - (5 * 86400))
4end = int(time.time())
5
6url =   'http://api.openweathermap.org/data/2.5/air_pollution/history?' \
7        + 'lat=' + str(lat) + '&lon=' + str(lon) + '&start=' + str(start)+ '&end=' + str(end) \
8        + '&appid={{APP_ID}}'
9
10response = requests.get(url)
11
12printResponse(response)

输出说明

第一个代码的输出显示指定位置的当前空气污染数据。

第二个代码的输出显示指定位置未来5天内每小时粒度的空气污染预报数据。

第三个代码的输出显示指定位置在指定时间段内每小时粒度的历史空气污染数据。

接下来深入分析API返回的响应字段。

响应参数