为了让更多人更快更好的知道PM2.5,我们做了一个艰难的决定,决定无偿开放PM2.5数据接口,以方便更多的开发者使用!
重要关于PM25.in的免责声明:
第一条、Pm25.in是Labs@Bestapp.us为广大应用开发者免费提供空气质量数据的一个公益性网站,Pm25.in的数据全部来源于网友提供的国家环保网站公开数据,我们根据国家环保网站的实时数据进行二次核实;Pm25.in所提供的数据仅供开发者作为开发参考信息,开发者据此做出的行为及所产生的后果与Labs@Bestapp.us及其关联单位无关。 第二条、由于不可抗力或互联网传输原因等造成Pm25.in信息传播的延迟、中断或缺失,Pm25.in及Labs@Bestapp.us不承担任何责任;因不可预测或无法控制的系统故障、设备故障、通讯故障等原因给用户造成损失的,Pm25.in及Labs@Bestapp.us不承担任何赔偿责任。 第三条、Pm25.in及Labs@Bestapp.us尽全力给开发者提供及时、准确的空气质量数据及相关产品服务,但不承担因数据准确率、真实性和全面性等原因引起的任何损失、损害,因使用上述数据而产生的一切风险由开发者自身承担。 第四条、未经Labs@Bestapp.us事先许可,使用Pm25.in API接口数据的开发者不得自行修改本网站提供的数据,如果对Pm25. in提供的数据有疑义,请直接按照本网站提供的联系方式与我们联系,且不得实施任何有损Pm25.in及Labs@Bestapp.us声誉的行为,否则,Pm25.in及Labs@Bestapp.us有权要求该开发使用者承担因此对Pm25.in及Labs@Bestapp.us所造成的一切损失。 第五条、本声明的最终解释权归Labs@Bestapp.us所有。 以上风险提示,您已阅读并理解,如果继续使用,即表明您同意承担使用Labs@Bestapp.us所有服务可能存在的风险。
我相信程序员都是有节操的,不会恶意使用这个Key!公共测试AppKey:5j1znBVAsnSf5xQyNQyq
这个AppKey每小时调用的次数限制和单独申请的AppKey没什么两样,大家不要恶意使用而导致他人用不了。我相信大家是有节操的人,做损人不利己的事,请三思,为自己积点德。
需要数据做测试的开发者,请求一次之后,把结果保存成json格式的文件,放在本地就可以测试了,等作品开发完成再来申请AppKey。
Pm25.in API
文档更新时间:2014-01-03 注意 1、所有API的调用,必须附带"token"这个参数,即申请的AppKey; 2、API中的'city'参数支持中文、拼音和区号,例如:"city=广州","city=guangzhou","city=020"; 3、因为参数使用中文需要encode,所以推荐开发者city参数尽量使用拼音; 4、重名情况:泰州的拼音为"taizhoushi",台州的拼音为"taizhou"; 5、API返回的JSON格式数据是经过UTF-8编码的,这个文档里的"成功返回示例"为了直观,已经decode过; 6、由于有些开发者对API调用过于频繁,严重影响了服务器,现在对API调用次数作出调整:1.10和1.11每小时15次、1.12每小时5次、1.13每小时15次,其余每小时500次; 7、由于数据源方面的原因,API中的24小时均值、station_code有时返回可能为空; 数据格式说明: PM25.in网站提供的空气质量指数实时数据来源于国家环境保护部,API返回的数据包括了以下内容:
字段 | 字段说明 |
---|---|
aqi | 空气质量指数(AQI),即air quality index,是定量描述空气质量状况的无纲量指数 |
area | 城市名称 |
position_name | 监测点名称 |
station_code | 监测点编码 |
so2 | 二氧化硫1小时平均 |
so2_24h | 二氧化硫24小时滑动平均 |
no2 | 二氧化氮1小时平均 |
no2_24h | 二氧化氮24小时滑动平均 |
pm10 | 颗粒物(粒径小于等于10μm)1小时平均 |
pm10_24h | 颗粒物(粒径小于等于10μm)24小时滑动平均 |
co | 一氧化碳1小时平均 |
co_24h | 一氧化碳24小时滑动平均 |
o3 | 臭氧1小时平均 |
o3_24h | 臭氧日最大1小时平均 |
o3_8h | 臭氧8小时滑动平均 |
o3_8h_24h | 臭氧日最大8小时滑动平均 |
pm2_5 | 颗粒物(粒径小于等于2.5μm)1小时平均 |
pm2_5_24h | 颗粒物(粒径小于等于2.5μm)24小时滑动平均 |
primary_pollutant | 首要污染物 |
quality | 空气质量指数类别,有“优、良、轻度污染、中度污染、重度污染、严重污染”6类 |
time_point | 数据发布的时间 |
地址 | http://www.pm25.in/api/querys/pm2_5.json |
方法 | GET |
参数 | * city:城市名称,必选参数 * avg:是否返回一个城市所有监测点数据均值的标识,可选参数,默认是true,不需要均值时传这个参数并设置为false * stations:是否只返回一个城市均值的标识,可选参数,默认是yes,不需要监测点信息时传这个参数并设置为no |
返回 | 一个数组,里面的一项是一个监测点的PM2.5信息,其中每一项数据包括 * aqi * area * pm2_5 * pm2_5_24h * position_name * primary_pollutant * quality * station_code * time_point 默认情况下,最后一项是所有监测点的均值(即一个城市的值) |
地址 | http://www.pm25.in/api/querys/pm10.json |
方法 | GET |
参数 | * city:必选 * avg:可选 * stations:可选 |
返回 | 一个数组,其中每一项数据包括 * aqi * area * pm10 * pm10_24h * position_name * primary_pollutant * quality * station_code * time_point |
地址 | http://www.pm25.in/api/querys/co.json |
方法 | GET |
参数 | * city:必选 * avg:可选 * stations:可选 |
返回 | 一个数组,其中每一项数据包括 * aqi * area * co * co_24h * position_name * primary_pollutant * quality * station_code * time_point |
地址 | http://www.pm25.in/api/querys/no2.json |
方法 | GET |
参数 | * city:必选 * avg:可选 * stations:可选 |
返回 | 一个数组,其中每一项数据包括 * aqi * area * no2 * no2_24h * position_name * primary_pollutant * quality * station_code * time_point |
地址 | http://www.pm25.in/api/querys/so2.json |
方法 | GET |
参数 | * city:必选 * avg:可选 * stations:可选 |
返回 | 一个数组,其中每一项数据包括 * aqi * area * so2 * so2_24h * position_name * primary_pollutant * quality * station_code * time_point |
地址 | http://www.pm25.in/api/querys/o3.json |
方法 | GET |
参数 | * city:必选 * avg:可选 * stations:可选 |
返回 | 一个数组,其中每一项数据包括 * aqi * area * o3 * o3_24h * o3_8h * o3_8h_24h * position_name * primary_pollutant * quality * station_code * time_point |
地址 | http://www.pm25.in/api/querys/aqi_details.json |
方法 | GET |
参数 | * city:必选 * avg:可选 * stations:可选 |
返回 | 一个数组,其中每一项数据包括 * aqi * area * co * co_24h * no2 * no2_24h * o3 * o3_24h * o3_8h * o3_8h_24h * pm10 * pm10_24h * pm2_5 * pm2_5_24h * position_name * primary_pollutant * quality * so2 * so2_24h * station_code * time_point |
地址 | http://www.pm25.in/api/querys/only_aqi.json |
方法 | GET |
参数 | * city:必选 * avg:可选 * stations:可选 |
返回 | 一个数组,其中每一项数据包括 * aqi * area * position_name * primary_pollutant * quality * station_code * time_point |
地址 | http://www.pm25.in/api/querys/aqis_by_station.json |
方法 | GET |
参数 | * station_code:必选 |
返回 | 一个数组,其中的一项数据包括 * aqi * area * co * co_24h * no2 * no2_24h * o3 * o3_24h * o3_8h * o3_8h_24h * pm10 * pm10_24h * pm2_5 * pm2_5_24h * position_name * primary_pollutant * quality * so2 * so2_24h * station_code * time_point |
地址 | http://www.pm25.in/api/querys/station_names.json |
方法 | GET |
参数 | * city:必选 |
返回 | * city * stations:值是一个数组,里面的一个数组又包含了station_name和station_code |
地址 | http://www.pm25.in/api/querys.json |
方法 | GET |
参数 | * 无 |
返回 | * cities:值是一个数组 |
地址 | http://www.pm25.in/api/querys/all_cities.json |
方法 | GET |
参数 | * 无 |
返回 | 一个数组,里面包含目前支持的190个城市所有监测点的详细信息,一共946项,其中每项的信息有 * aqi * area * co * co_24h * no2 * no2_24h * o3 * o3_24h * o3_8h * o3_8h_24h * pm10 * pm10_24h * pm2_5 * pm2_5_24h * position_name * primary_pollutant * quality * so2 * so2_24h * station_code * time_point |
地址 | http://www.pm25.in/api/querys/aqi_ranking.json |
方法 | GET |
参数 | * 无 |
返回 | 一个数组,里面包含目前支持的190个城市AQI排行榜信息,其中每项的信息有 * aqi * area * co * co_24h * no2 * no2_24h * o3 * o3_24h * o3_8h * o3_8h_24h * pm10 * pm10_24h * pm2_5 * pm2_5_24h * quality * level * so2 * so2_24h * primary_pollutant * time_point 说明primary_pollutant的值可能为[二氧化硫","二氧化氮","颗粒物(PM10)","颗粒物(PM2.5)","一氧化碳","臭氧1小时","臭氧8小时"]中的一项或多项组合,出现多项时,各项之间用逗号","分隔;AQI低于50时,没有值,为"". |
常见问题
Q:如何申请AppKey?
A:你猜
Q:如果猜不到,你可以告诉我吗?
A:好,你填好上面的表格,我就把答案Email给你。
Q:申请之后多久可以收到Appkey?
A:我们的工作人员一般会在5天之内处理完的,周末和节假日除外。
Q:过了5天还没收到,我该咋办?
A:1、你是否认真填写了申请理由呢?2、垃圾邮件里面找找?3、请看最后面一条吐槽!4、邮件咨询
Q:我申请时,提示email错误怎么办?
A:看起来,你是重复申请了。
Q:收到AppKey之后,我该做些什么?
A:你除了进行测试外,请一个星期内发邮件回来进行反馈,包括应用名称、团队名称、负责人、预估的用户量、API调用次数等,越详细越好。个人开发者或申请用来学习的,团队名称等可省略。如果一个月之后也还不反馈信息的,我们将有权收回AppKey。
纯吐槽: 能认真填写email地址不?我的邮件发出之后提示这个邮件地址不存在啊,魂淡!!!