空气质量

数据介绍

通过空气质量数据接口,可获取空气质量相关数据,包括空气质量实况数据、空气质量未来7天预报以及空气质量未来逐小时预报。

获取方式

HTTP GET

数据格式

JSON

请求URL

商业版:

https://api.heweather.net/s6/air/{air-type}?{parameters}

免费版:

https://free-api.heweather.net/s6/air/{air-type}?{parameters}
  • {air-type}代表不同的天气数据类型,必选,请使用以下值替代:
air-type 值 描述 授权
now 空气质量实况 商业/免费
forecast 未来3-7天空气质量预报 商业
hourly 未来24小时逐小时空气质量预报 商业

请注意:如果数据用于任何商业行为,必须购买商业授权;某些数据的商业版和免费版有所不同

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

请注意,在替换{air-type}{parameters}对应值的时候,URL中不要包含大括号{}

请求URL示例

# 获取北京空气质量实况天气:
https://api.heweather.net/s6/air/now?location=beijing&key=xxx

请求参数

参数 描述 选择 示例值
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
支持数字签名方式进行认证,推荐使用
必选 key=xxxxxxxxxxxxxx

返回参数和数值说明

空气质量数据接口将返回一些基本字段和不同空气质量类型的字段。

返回的数据中,basicupdatestatus是基本参数,在不同数据类型中都会返回。

具体的空气质量数据,会根据你请求的{air-type}不同,将返回不同的空气质量数据。

basic 基础信息

基础信息包括所查询的城市/地区的一些基本信息,例如名称、ID、经纬度等

参数 描述 示例值
location 地区/城市名称 卓资
cid 地区/城市ID CN101080402
lat 地区/城市纬度 40.89576
lon 地区/城市经度 112.577702
parent_city 该地区/城市的上级城市 乌兰察布
admin_area 该地区/城市所属行政区域 内蒙古
cnty 该地区/城市所属国家名称 中国
tz 该地区/城市所在时区 +8.0

update 接口更新时间

接口更新时间为当前接口的更新时间,包括城市/地区所在地的当地时间和UTC时间。在一些接口中,其中一部分数据会单独更新,但此时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

satuts 接口状态

当前接口的状态,正常返回数据会返回ok,若未能返回数据,会给出具体的错误码,不同的错误码请参考接口状态码及错误码

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

air_now_city 空气质量实况(市县区级别)

中国3240个市县区的实时空气质量(AQI)数据,包含环保部300+国控站点所在的地级市。 了解更多

参数 描述 示例
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 空气质量实况(站点级别)

环保部1500+国控监测站点实时空气质量(AQI)数据。

参数 描述 示例
pub_time 数据发布时间,格式yyyy-MM-dd HH:mm 2017-03-20 12:30
air_sta 站点名称 万寿西宫
asid 站点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

air_forecast 空气质量预报

结合环保部最新排放污染清单以及WRF-CHEM模型算法,和风天气推出了全国首家且唯一的未来7天空气质量预报数据,本数据接口可对未来7天全国3240个城市地区进行空气质量AQI预报。

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

air_hourly 空气质量逐小时预报

全国3240个城市地区进行精确到每一小时的空气质量预报,最长达120小时

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