PM2.5空气质量指数 官方自营 免费使用

 

本接口每小时更新1次。空气质量指数提供实时空气质量情况,目前支持全国近400个城市;服务支持功能包括:查询空气质量、pm2.5、AQI指数,并给出空气质量级别和首要污染物等资料。

浏览量: 233192

调用量: 211855326

使用人数: 29082

¥ 0.00 元起

接入点说明: 单个城市及其下属的监测点的PM数据,包括AQI,空气质量,指数类别,首要污染物,PM 2.5,细颗粒物,PM 10,可吸入颗粒物, 一氧化碳, 二氧化氮, 臭氧1小时平均, 臭氧8小时平均, 二氧化硫等信息。
相关文档:
接口地址: http://route.showapi.com/104-29 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
返回格式: json
请求方式: HTTP协议,支持GET/POST方法。
调用样式及调试工具: 测试工具

请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):展开收起
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_sign_method String md5 签名生成方式,其值可选为"md5"或"hmac"。如果不传入则默认"md5"。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数):
参数名称 类型 默认值 示例值 必须 描述
city String
天津
要查询的城市

返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
showapi_res_error String 用户输入有误! 错误信息的展示
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
pm PM
PM结构数据
- aqi String
空气质量指数(AQI),即air quality index,是定量描述空气质量状况的无纲量指数
- area String
城市名称
- co String
一氧化碳1小时平均,mg/m³
- ct String
发布时间
- no2 String
二氧化氮1小时平均,μg/m³
- o3 String
臭氧1小时平均,μg/m³
- o3_8h String
臭氧8小时滑动平均,μg/m³
- pm10 String
颗粒物(粒径小于等于10μm)1小时平均,μg/m³
- pm2_5 String
颗粒物(粒径小于等于2.5μm)1小时平均,μg/m³
- primary_pollutant String
首要污染物
- quality String
空气质量指数类别,有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
- so2 String
二氧化硫一小时平均,μg/m³
- siteList SitePm[]
下属的监测站的PM数据。此列表数据只在【单个城市PM】接入点中存在。
-- aqi String
空气质量指数(AQI),即air quality index,是定量描述空气质量状况的无纲量指数
-- site_name String
监测点名称
-- co String
一氧化碳1小时平均,mg/m³
-- ct String
发布时间
-- no2 String
二氧化氮1小时平均,μg/m³
-- o3 String
臭氧1小时平均,μg/m³
-- o3_8h String
臭氧8小时滑动平均,μg/m³
-- pm10 String
颗粒物(粒径小于等于10μm)1小时平均,μg/m³
-- pm2_5 String
颗粒物(粒径小于等于2.5μm)1小时平均,μg/m³
-- primary_pollutant String
首要污染物
-- quality String
空气质量指数类别,有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
-- so2 String
二氧化硫一小时平均,μg/m³
ret_code String
0
0为成功,其他失败
...

返回示例/ Return example

{
  "showapi_res_code": 0,
  "showapi_res_error": "",
  "showapi_res_body": {
    "ret_code": 0,
    "pm": {
     	"num": "1",  //排名
        "so2": "2",  //
        "o3": "96",  //臭氧1小时平均,μg/m3
        "area_code": "hangzhou",  //
        "pm2_5": "91",  //颗粒物(粒径小于等于2.5μm)1小时平均,μg/m3
        "ct": "2017-05-06 16:19:26.556",  //发布时间
        "primary_pollutant": "颗粒物(PM10)",  //首要污染物
        "co": "0.28",  //一氧化碳1小时平均,mg/m3
        "area": "杭州",  //城市名称
        "no2": "8",  //二氧化氮1小时平均,μg/m3
        "aqi": "500",  //空气质量指数(AQI),即air quality index,是定量描述空气质量状况的无纲量指数
        "quality": "严重污染",  //空气质量指数类别,有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
        "pm10": "841",  //颗粒物(粒径小于等于10μm)1小时平均,μg/m3
        "o3_8h": "89"  //臭氧8小时滑动平均,μg/m3
    },
    "siteList": [
      {
        "site_name": "万寿西宫",
        "co": "0.2",
        "so2": "2",
        "o3": "112",
        "no2": "8",
        "aqi": "59",
        "quality": "良",
        "pm10": "54",
        "pm2_5": "42",
        "o3_8h": "89",
        "primary_pollutant": "细颗粒物(PM2.5)",
        "ct": "2017-05-06 16:19:40.889"
      },
      {
        "site_name": "定陵",
        "co": "0.2",
        "so2": "2",
        "o3": "116",
        "no2": "2",
        "aqi": "52",
        "quality": "良",
        "pm10": "_",
        "pm2_5": "36",
        "o3_8h": "109",
        "primary_pollutant": "细颗粒物(PM2.5)",
        "ct": "2017-05-06 16:19:40.889"
      } 
    ]
  }
}