空气质量数据集合

GETair

接口介绍

本接口集合了空气质量相关数据,包括空气质量实况数据空气质量未来7天预报以及空气质量未来逐小时预报,有权限的用户可通过本接口一次性获取某一地区以上所有空气质量相关数据。

普通用户和认证个人开发者仅可通过本接口获取到环保部1500个监测站点的空气质量实况数据

请求URL

https://api.heweather.com/s6/air?parameters

parameters代表请求参数,包括必选和可选参数。所有请求参数均使用&进行分隔,参数值存在中文或特殊字符的情况,需要对参数进行 url encode

请求参数

参数 描述 选择 示例值
location 需要查询的城市或地区,可输入以下值:
1. 城市ID:城市列表
2. 经纬度格式:经度,纬度(经度在前纬度在后,英文,分隔,十进制格式,北纬东经为正,南纬西经为负
3. 城市名称,支持中英文和汉语拼音
4. 城市名称,上级城市 或 省 或 国家,英文,分隔,此方式可以在重名的情况下只获取想要的地区的天气数据,例如 西安,陕西
5. IP
6. 根据请求自动判断,根据用户的请求获取IP,通过 IP 定位并获取城市数据
必选 1. location=CN101010100
2. location=116.40,39.9
3. location=北京、 location=北京市、 location=beijing
4. location=朝阳,北京、 location=chaoyang,beijing
5. location=60.194.130.1
6. location=auto_ip
lang 多语言,可以不使用该参数,默认为简体中文
详见多语言参数
可选 lang=en
unit 单位选择,公制(m)或英制(i),默认为公制单位
详见度量衡单位参数
可选 unit=i
key 用户认证key,登录控制台可查看
支持数字签名方式进行认证,推荐使用
必选 key=xxxxxxxxxxxxxx

字段和数值说明

basic 基础信息

参数 描述 示例值
location 地区/城市名称 海淀
cid 地区/城市ID CN101080402
lat 地区/城市纬度 39.956074
lon 地区/城市经度 116.310316
parent_city 该地区/城市的上级城市 北京
admin_area 该地区/城市所属行政区域 北京
cnty 该地区/城市所属国家名称 中国
tz 该地区/城市所在时区 +8.0

update 接口更新时间

参数 描述 示例值
loc 当地时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 12:34
utc UTC时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 04:34

status 接口状态

参数 描述 示例
status 接口状态,具体含义请参考接口状态码及错误码 ok

air_forecast 空气质量 AQI 7天预报

参数 描述 示例
date 预报日期,格式yyyy-MM-dd 2017-08-09
aqi 空气质量指数,AQI和PM25的关系 74
main 主要污染物 pm25
qlty 空气质量,取值范围:优,良,轻度污染,中度污染,重度污染,严重污染,查看计算方式

air_hourly 空气质量 AQI 逐小时预报

参数 描述 示例
time 预报日期,格式yyyy-MM-dd HH:mm 2017-08-09 14:00
aqi 空气质量指数,AQI和PM25的关系 74
main 主要污染物 pm25
qlty 空气质量,取值范围:优,良,轻度污染,中度污染,重度污染,严重污染,查看计算方式

air_now_city AQI城市实况

参数 描述 示例
pub_time 数据发布时间,格式yyyy-MM-dd HH:mm 2017-03-20 12:30
aqi 空气质量指数,AQI和PM25的关系 74
main 主要污染物 pm25
qlty 空气质量,取值范围:优,良,轻度污染,中度污染,重度污染,严重污染,查看计算方式
pm10 pm10 78
pm25 pm25 66
no2 二氧化氮 40
so2 二氧化硫 30
co 一氧化碳 33
o3 臭氧 20

air_now_station AQI站点实况

参数 描述 示例
pub_time 数据发布时间,格式yyyy-MM-dd HH:mm 2017-03-20 12:30
air_sta 站点名称 万寿西宫
asid 站点ID,请参考所有站点ID CNA110000
lat 站点纬度 116.405285
lon 站点经度 39.904989
aqi 空气质量指数,AQI和PM25的关系 74
main 主要污染物 pm25
qlty 空气质量,取值范围:优,良,轻度污染,中度污染,重度污染,严重污染,查看计算方式
pm10 pm10 78
pm25 pm25 66
no2 二氧化氮 40
so2 二氧化硫 30
co 一氧化碳 33
o3 臭氧 20