万维易源-单个城市及其监测点PM数据

PM2.5空气质量指数 官方自营会员接口

累计调用

3亿+

会员接口交流群： 1054956818 查看演示

查看加密签名方式 二、请求参数/ Request parameter

非文件上传的POST时，请设置headers['Content-Type'] = 'application/x-www-form-urlencoded', 并把对象形式的数据转成查询字符串
文件上传的POST时，请设置headers['Content-Type'] = 'multipart/form-data'

1、系统级参数（所有接入点都需要的参数）：展开收起

参数名称	类型	示例值	必须	描述
showapi_appid	String	100	是	易源应用id
showapi_sign	String	698d51a19d8a121ce581499d7b701668	是	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。可选【简单密钥方式】,在url后带上showapi_appid和showapi_sign即可
showapi_timestamp	String	20141114142239	否	客户端时间。格式yyyyMMddHHmmss,如20141114142239 为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。
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，服务不存在或未上线 -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为成功，其他失败
...

四、请求示例/ Request example 查看使用向导查看我的showapi_appid与showapi_sign 丨

五、返回示例/ Return example

{
  "showapi_res_code": 0,
  "showapi_res_error": "",
  "showapi_res_id":"ce135f6739294c63be0c021b76b6fbff",
    "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"
      } 
    ]
  }
}

一个会员资源包即可调用【所有会员接口】
注册即免费送会员包（流量次数限制）
if （会员包到期 or 次数用完 or 流量用完） then 会员包失效 end
可购买多个资源包，会自动递延生效串联使用

PM2.5空气质量指数官方自营会员接口

1、接口介绍

2、使用场景

3、产品优势对比

4、我们的实力

5、合作伙伴

一、接入点/ API point

查看加密签名方式二、请求参数/ Request parameter

三、返回参数/ Return parameter

四、请求示例/ Request example 查看使用向导 查看我的showapi_appid与showapi_sign 丨

五、返回示例/ Return example

提供方联系方式/ Contact Information

易源·API市场

PM2.5空气质量指数 官方自营 会员接口