為了讓更多人更快更好的知道PM2.5,我們做了一個艱難的決定,決定無償開放PM2.5數據接口,以方便更多的開發者使用!

Pm25_logo_200_nocircle
重要

申請前須知!

  1. 認真看看下面的免責聲明;
  2. 你需要具備編程能力,或者你的團隊有開發人員;
  3. 你必須明白這個AppKey是怎么用的,我相信有編程能力的人能夠看懂API文檔;我們沒有PC版的下載數據的客戶端,這不是激活碼,以后對于如何使用AppKey這個問題一概不再回復;
  4. 我們目前不提供歷史數據,只提供最近一小時的數據,API沒有辦法獲取從XX時間到XX時間的數據;
  5. 需要歷史數據的,目前的辦法是通過API自己慢慢收集;
  6. 我們提供的是按新的《環境空氣質量標準》(GB3095-2012)發布的環境空氣質量指數(AQI)相關數據,不包含按舊標準發布的空氣污染指數(API)相關數據,新標準是2012年才發布的,所以不要再問我們有沒有最近xx年的數據;
  7. 對于以下幾種情況的人,請使用公共測試AppKey:初學者、學習如何發送HTTP請求和解析JSON格式數據的;就想看看數據長什么樣,純粹出于好奇心的;還沒想好拿到AppKey之后要做什么東西的;用于測試,但又不說清楚測試什么東西的;作品還在構想或正在開發中的開發者。公共測試AppKey在下方,往下拉;
  8. 以下要求只針對已經有上線作品或作品開發完畢需要正式上線的開發者,如果你的作品正在構想或開發中但想申請AppKey,你必須有理由說服我;
  9. App開發:請給出應用名稱和App Store、Google Play或其他市場的下載鏈接(已經有作品的開發者);
  10. Web應用:請給出網站名稱和網址,個人博客也一樣需要;
  11. 微信應用:請給出公眾平臺的賬號,讓我可以關注;
  12. 微博應用:請給出微博昵稱和微博地址;
  13. 學術研究:請給出機構或學校的名稱,具體到學院、專業、年級,說明數據將用于研究的方向;
  14. 企業應用:請給出企業名稱和網址,數據使用的項目、場景等;用于政府機構的,一樣需要提供這些信息;
  15. 瀏覽器插件:請給出瀏覽器插件名稱和下載地址;
  16. 其他:請給出盡可能詳細的信息,讓我明白你用這些數據干嘛;
  17. 最后,認真填寫申請理由,讓我明白你的想法。

重要

關于奇迹觉醒大天使武器怎么合成卓越 www.yjieh.icu的免責聲明:

第一條、奇迹觉醒大天使武器怎么合成卓越 www.yjieh.icu是[email protected]為廣大應用開發者免費提供空氣質量數據的一個公益性網站,奇迹觉醒大天使武器怎么合成卓越 www.yjieh.icu的數據全部來源于網友提供的國家環保網站公開數據,我們根據國家環保網站的實時數據進行二次核實;奇迹觉醒大天使武器怎么合成卓越 www.yjieh.icu所提供的數據僅供開發者作為開發參考信息,開發者據此做出的行為及所產生的后果與[email protected]及其關聯單位無關。 第二條、由于不可抗力或互聯網傳輸原因等造成奇迹觉醒大天使武器怎么合成卓越 www.yjieh.icu信息傳播的延遲、中斷或缺失,奇迹觉醒大天使武器怎么合成卓越 www.yjieh.icu及[email protected]不承擔任何責任;因不可預測或無法控制的系統故障、設備故障、通訊故障等原因給用戶造成損失的,奇迹觉醒大天使武器怎么合成卓越 www.yjieh.icu及[email protected]不承擔任何賠償責任。 第三條、奇迹觉醒大天使武器怎么合成卓越 www.yjieh.icu及[email protected]盡全力給開發者提供及時、準確的空氣質量數據及相關產品服務,但不承擔因數據準確率、真實性和全面性等原因引起的任何損失、損害,因使用上述數據而產生的一切風險由開發者自身承擔。 第四條、未經[email protected]事先許可,使用奇迹觉醒大天使武器怎么合成卓越 www.yjieh.icu API接口數據的開發者不得自行修改本網站提供的數據,如果對Pm25. www.yjieh.icu提供的數據有疑義,請直接按照本網站提供的聯系方式與我們聯系,且不得實施任何有損奇迹觉醒大天使武器怎么合成卓越 www.yjieh.icu及[email protected]聲譽的行為,否則,奇迹觉醒大天使武器怎么合成卓越 www.yjieh.icu及[email protected]有權要求該開發使用者承擔因此對奇迹觉醒大天使武器怎么合成卓越 www.yjieh.icu及[email protected]所造成的一切損失。 第五條、本聲明的最終解釋權歸[email protected]所有。 以上風險提示,您已閱讀并理解,如果繼續使用,即表明您同意承擔使用[email protected]所有服務可能存在的風險。

我相信程序員都是有節操的,不會惡意使用這個Key!

公共測試AppKey:5j1znBVAsnSf5xQyNQyq

這個AppKey每小時調用的次數限制和單獨申請的AppKey沒什么兩樣,大家不要惡意使用而導致他人用不了。我相信大家是有節操的人,做損人不利己的事,請三思,為自己積點德。

需要數據做測試的開發者,請求一次之后,把結果保存成json格式的文件,放在本地就可以測試了,等作品開發完成再來申請AppKey。


重要

拿到AppKey之后

  1. 認真看下面的API文檔,特別是一開頭的注意部分;
  2. 不要再問為什么看到的是亂碼,因為用了UTF-8編碼;
  3. 不要再問你用的語言下要怎么獲取數據,要怎么轉換編碼,這是你自己的事,你需要自己去學習;
  4. 不要把API返回的error信息當透明;
  5. 記得關注微博 '@PM25分享',API方面的變動會發布在微博上。

  

奇迹觉醒大天使武器怎么合成卓越 www.yjieh.icu 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有時返回可能為空; 數據格式說明: 奇迹觉醒大天使武器怎么合成卓越 www.yjieh.icu網站提供的空氣質量指數實時數據來源于國家環境?;げ?,API返回的數據包括了以下內容:
字段 字段說明
aqi 空氣質量指數(AQI),即air quality www.yjieh.icudex,是定量描述空氣質量狀況的無綱量指數
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_powww.yjieh.icut 數據發布的時間

1、空氣質量數據相關接口

1.1、獲取一個城市所有監測點的PM2.5數據
地址 //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_powww.yjieh.icut 默認情況下,最后一項是所有監測點的均值(即一個城市的值)
請求示例: //www.pm25.in/api/querys/pm2_5.json?city=珠海&token=xxxxxx 或者 //www.pm25.in/api/querys/pm2_5.json?city=zhuhai&token=xxxxxx 成功返回示例: [ { "aqi": 82, "area": "珠海", "pm2_5": 31, "pm2_5_24h": 60, "position_name": "吉大", "primary_pollutant": "顆粒物(PM2.5)", "quality": "良", "station_code": "1367A", "time_powww.yjieh.icut": "2013-03-07T19:00:00Z" }, ... ... ... { "aqi": 108, "area": "珠海", "pm2_5": 0, "pm2_5_24h": 53, "position_name": "斗門", "primary_pollutant": "臭氧8小時", "quality": "輕度污染", "station_code": "1370A", "time_powww.yjieh.icut": "2013-03-07T19:00:00Z" }, { "aqi": 99, "area": "珠海", "pm2_5": 39, "pm2_5_24h": 67, "position_name": null, "primary_pollutant": null, "quality": "良", "station_code": null, "time_powww.yjieh.icut": "2013-03-07T19:00:00Z" } ] 可能的錯誤返回信息: { "error": "參數不能為空" } { "error": "該城市還未有PM2.5數據" } { "error": "Sorry,您這個小時內的API請求次數用完了,休息一下吧!" } { "error": "You need to sign www.yjieh.icu or sign up before contwww.yjieh.icuuwww.yjieh.icug." } ***stations = no時的情況*** 請求示例: //www.pm25.in/api/querys/pm2_5.json?city=guangzhou&token=xxxxxx&stations=no 成功返回示例: [ { "aqi": 151, "area": "廣州", "pm2_5": 106, "pm2_5_24h": 115, "quality": "中度污染", "time_powww.yjieh.icut": "2013-04-16T11:00:00Z" } ] 以下的API和上面的這個API大同小異,所以就不作太詳細的說明了。
1.2、獲取一個城市所有監測點的PM10數據
地址 //www.pm25.in/api/querys/pm10.json
方法 GET
參數 * city:必選 * avg:可選 * stations:可選
返回 一個數組,其中每一項數據包括 * aqi * area * pm10 * pm10_24h * position_name * primary_pollutant * quality * station_code * time_powww.yjieh.icut
1.3、獲取一個城市所有監測點的CO數據
地址 //www.pm25.in/api/querys/co.json
方法 GET
參數 * city:必選 * avg:可選 * stations:可選
返回 一個數組,其中每一項數據包括 * aqi * area * co * co_24h * position_name * primary_pollutant * quality * station_code * time_powww.yjieh.icut
1.4、獲取一個城市所有監測點的NO2數據
地址 //www.pm25.in/api/querys/no2.json
方法 GET
參數 * city:必選 * avg:可選 * stations:可選
返回 一個數組,其中每一項數據包括 * aqi * area * no2 * no2_24h * position_name * primary_pollutant * quality * station_code * time_powww.yjieh.icut
1.5、獲取一個城市所有監測點的SO2數據
地址 //www.pm25.in/api/querys/so2.json
方法 GET
參數 * city:必選 * avg:可選 * stations:可選
返回 一個數組,其中每一項數據包括 * aqi * area * so2 * so2_24h * position_name * primary_pollutant * quality * station_code * time_powww.yjieh.icut
1.6、獲取一個城市所有監測點的O3數據
地址 //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_powww.yjieh.icut
1.7、獲取一個城市所有監測點的AQI數據(含詳情)
地址 //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_powww.yjieh.icut
1.8、獲取一個城市所有監測點的AQI數據(不含詳情,僅AQI)
地址 //www.pm25.in/api/querys/only_aqi.json
方法 GET
參數 * city:必選 * avg:可選 * stations:可選
返回 一個數組,其中每一項數據包括 * aqi * area * position_name * primary_pollutant * quality * station_code * time_powww.yjieh.icut
1.9、獲取一個監測點的AQI數據(含詳情)
地址 //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_powww.yjieh.icut
1.10、獲取一個城市的監測點列表
地址 //www.pm25.in/api/querys/station_names.json
方法 GET
參數 * city:必選
返回 * city * stations:值是一個數組,里面的一個數組又包含了station_name和station_code
成功返回示例: { "city": "珠海", "stations": [ { "station_name": "吉大", "station_code": "1367A" }, { "station_name": "前山", "station_code": "1368A" }, { "station_name": "唐家", "station_code": "1369A" }, { "station_name": "斗門", "station_code": "1370A" } ] } 特別提示:如果不傳city這個參數,將返回全國的監測點,不鼓勵頻繁調用;
1.11、獲取實施了新《環境空氣質量標準》的城市列表,即有PM2.5數據的城市列表
地址 //www.pm25.in/api/querys.json
方法 GET
參數 * 無
返回 * cities:值是一個數組
成功返回示例: { "cities": [ "上海", "東莞", "中山", ... ... ... "長春", "長沙", "青島" ] }
1.12、獲取所有城市的空氣質量詳細數據
地址 //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_powww.yjieh.icut
1.13、獲取全部城市的空氣質量指數(AQI)排行榜
地址 //www.pm25.in/api/querys/aqi_rankwww.yjieh.icug.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_powww.yjieh.icut 說明primary_pollutant的值可能為[二氧化硫","二氧化氮","顆粒物(PM10)","顆粒物(PM2.5)","一氧化碳","臭氧1小時","臭氧8小時"]中的一項或多項組合,出現多項時,各項之間用逗號","分隔;AQI低于50時,沒有值,為"".
成功返回示例: [ { "aqi": 24, "area": "昆明", "co": 1.173, "co_24h": 1.362, "no2": 27, "no2_24h": 32, "o3": 16, "o3_24h": 22, "o3_8h": 7, "o3_8h_24h": 18, "pm10": 9, "pm10_24h": 24, "pm2_5": 11, "pm2_5_24h": 15, "quality": "優", "level": "一級", "so2": 6, "so2_24h": 8, "primary_pollutant": "", "time_powww.yjieh.icut": "2013-10-21T14:00:00Z" }, ...... { "aqi": 51, "area": "福州", "co": 0.562, "co_24h": 0.544, "no2": 20, "no2_24h": 26, "o3": 92, "o3_24h": 93, "o3_8h": 64, "o3_8h_24h": 67, "pm10": 59, "pm10_24h": 50, "pm2_5": 37, "pm2_5_24h": 30, "quality": "良", "level": "二級", "so2": 12, "so2_24h": 10, "primary_pollutant": "顆粒物(PM10)", "time_powww.yjieh.icut": "2013-10-21T14:00:00Z" }, ...... { "aqi": 58, "area": "泉州", "co": 0.57, "co_24h": 0.47, "no2": 16, "no2_24h": 17, "o3": 149, "o3_24h": 149, "o3_8h": 108, "o3_8h_24h": 108, "pm10": 92, "pm10_24h": 64, "pm2_5": 39, "pm2_5_24h": 29, "quality": "良", "level": "二級", "so2": 12, "so2_24h": 8, "primary_pollutant": "臭氧8小時,顆粒物(PM10)", "time_powww.yjieh.icut": "2013-10-21T14:00:00Z" }, ...... { "aqi": 500, "area": "哈爾濱", "co": 4.053, "co_24h": 3.942, "no2": 166, "no2_24h": 165, "o3": 13, "o3_24h": 44, "o3_8h": 9, "o3_8h_24h": 35, "pm10": 910, "pm10_24h": 860, "pm2_5": 866, "pm2_5_24h": 719, "quality": "嚴重污染", "level": "六級", "so2": 61, "so2_24h": 47, "primary_pollutant": "顆粒物(PM2.5),顆粒物(PM10)", "time_powww.yjieh.icut": "2013-10-21T14:00:00Z" } ]
captcha
驗證碼

常見問題

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地址不?我的郵件發出之后提示這個郵件地址不存在啊,魂淡!!!