PM2.5空气质量指数

第三方服务商
价格:会员免费  
服务商: 万维易源
  • 产品介绍
  • 接口文档
  • 服务商
  • 官方客服

 

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

使用PM排行榜的数据制作的图表如下:

全国城市空气质量排行榜


接口地址:http://route.showapi.com/104-41 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

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

1、系统级参数(所有接入点都需要的参数): 

参数名称类型示例值必须描述
showapi_appidString100易源应用id
showapi_signString698d51a19d8a121ce581499d7b701668为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 
showapi_timestampString20141114142239客户端时间。 
格式yyyyMMddHHmmss,如20141114142239 
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。 
showapi_res_gzipString1或0返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...

2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 

参数名称类型默认值示例值必须描述
请求示例:String res=new ShowApiRequest("http://route.showapi.com/104-41","my_appId","my_appSecret") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起 

名称类型示例值描述
showapi_res_bodyString{"city":"昆明","prov":"云南"}消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_codeint0易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-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受限
-1014,token权限无效
 
showapi_res_errorString用户输入有误!错误信息的展示
showapi_res_idStringce135f6739294c63be0c021b76b6fbff本次请求id
...

2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起 

名称类型示例值描述
list Object[]  
-  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 Object[] 下属的监测站的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 String00为成功,其他失败
...
返回示例:{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "ret_code": 0, "list": [ { "o3": "32", "area_code": "ganzizhou", "pm2_5": "10", "primary_pollutant": "", "ct": "2017-05-06 13:11:50.500", "num": "1", "co": "0.45", "area": "甘孜州", "no2": "26", "aqi": "18", "quality": "优", "pm10": "17", "o3_8h": "23" } ] } }

全国3600城市空气质量查询


接口地址:http://route.showapi.com/104-42 (注意:接口支持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 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述
area String
双桥镇
由于国家只发布了370个大城市空气质量,因此查询小地区时,系统将返回此地区的上级区域空气质量。
请求示例:String res=new ShowApiRequest("http://route.showapi.com/104-42","my_appId","my_appSecret") .addTextPara("area","双桥镇") .post(); System.out.println(res);

三、返回参数/ 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,服务不存在或未上线
-7, API创建者的网关资源不足
-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受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
paraName String
请填写参数描述
ret_code String
0
0为成功,其他失败
...
返回示例:{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "so2": "22", "o3": "102", "pm2_5": "63", "primary_pollutant": "颗粒物(PM10)", "ct": "2018-04-18 11:30:00.000", "num": "347", "co": "1.2", "area": "承德", "no2": "43", "aqi": "146", "quality": "轻度污染", "pm10": "239", "o3_8h": "51" } }

单个城市及其监测点PM数据


接口地址: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 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述
city String
天津
要查询的城市
请求示例:String res=new ShowApiRequest("http://route.showapi.com/104-29","my_appId","my_appSecret") .addTextPara("city","天津") .post(); System.out.println(res);

三、返回参数/ 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,服务不存在或未上线
-7, API创建者的网关资源不足
-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受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
pm Object[]
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 Object[]
下属的监测站的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为成功,其他失败
...
返回示例:{ "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" } ] } }

服务商介绍:易源数据是昆明秀派科技有限公司旗下的大数据生产、交易、流通平台。

易源数据通过打破资源壁垒,搭建起数据资源的基础设施,将接口纳入统一的接口池,把多个异构数据源合并到同一根管线上,以统一的访问和控制方式,对外提供统一格式的数据。

让开发者可以像搭积木一样通过各种API操纵资源。

截至2017年12月,平台已经拥有API接口230个,日调用量2000万,覆盖全网10万+真实消费者,为超过3000+的企业用户提供全域数据服务。

 

联系方式:

电话: 4009988033

 

微博: http://www.weibo.com/showapi

 

邮箱: services@showapi.com

 

QQ: 3007663665

 

微信: show_api

进制数据介绍:

企业和程序员可以通过进制数据封装的API或SDK极速接入其他数据资源,同时进制数据提供数据交易等服务。通过进制数据,不仅开发成本极大降低,而且可以获得其他丰富的数据服务:数据交易,数据分析,区块链Token管理等服务。

 

 

联系我们:

电话:173-6457-5198

QQ① 群:792473404

客服 QQ:1643296538

微信客服:binstds

                                      扫描二维码添加客服微信

 

 

工作时间

 周一至周五 9:00 - 21:00(其中周三为 9:00 - 18:00) 

周六 9:00 - 12:00(节假日除外) 

 

 

进制数据团队

 

 

2020.01.01

 

 

 

 

 


其他服务商
热门API推荐
相关API推荐