- 一个会员资源包即可调用【所有会员接口】
- 注册即免费送会员包(流量次数限制)
- if (会员包到期 or 次数用完 or 流量用完) then 会员包失效 end
- 可购买多个资源包,会自动递延生效串联使用
天津
本接口每1小时更新。空气质量指数提供实时空气质量情况,目前支持全国367个城市;服务支持功能包括:实时查询空气质量,小时粒度;实时给出空气质量AQI指数,并给出空气质量级别和首要污染物。
使用PM排行榜的数据制作的图表如下:
支持API接口化全过程, 实现内外接口调用, 通达容易数据之源
专注全域API服务, 您的支持就是我们最大的肯定
让网络数据像水、电一样, 使用容易、自由和便宜
已为3000多家企业提供API服务
非文件上传的POST时,请设置headers['Content-Type'] = 'application/x-www-form-urlencoded',
并把对象形式的数据转成查询字符串
文件上传的POST时,请设置headers['Content-Type'] = 'multipart/form-data'
参数名称 | 类型 | 示例值 | 必须 | 描述 |
---|---|---|---|---|
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时将压缩,其他值不压缩。 |
... |
参数名称 | 类型 | 默认值 | 示例值 | 必须 | 描述 |
---|---|---|---|---|---|
city | String |
天津
|
是 |
要查询的城市
|
以JSON格式返回结果。
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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 |
... |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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_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"
}
]
}
}
用户名: showapi
电话: 4009988033
微博: http://www.weibo.com/showapi
邮箱:
QQ: 3007663665
微信: show_api (公众号)