世界空氣品質指數專案空氣品質數據發布指南

分享: aqicn.org/publishingdata/hk/

發布世界空氣品質指數計畫的數據對每個人都是免費的。但這也很簡單明了:在世界空氣品質指數地圖上添加數據所需的只是提供一個提要 URL,其中包含有關監測站(名稱和位置)、正在測量的污染物以及真實空氣質量的實時信息。 -時間讀數(連同單位,例如毫克或ppb)。


資格標準

請注意,從歷史上看,世界空氣品質指數地圖(aqicn.org 和 waqi.info)上發布的數據只是每個國家各自環境保護局提供的官方數據(請參閱完整的 EPA 清單)。

官方數據是指使用專業的BAM、TEOM和類似的高成本空氣品質監測站監測的數據。這些站的使用並不簡單,並且確實需要 EPA 專業現場工程團隊的持續維護和校準。

然而,如今,更便宜的基於雷射散射的空氣品質監測站被廣泛使用,作為官方空氣品質監測站的配套。那些更實惠的站的成本可以比 BAM 和 TOEM 站低 1000 倍。

為此,我們建議使用半專業的GAIA空氣品質監測站。但我們也接受其他站的數據。然而,此類基於粒子計數器的站需要報告增強的資料饋送以及額外的品質控制(請參閱品質控制部分)。

飼料格式

由於幾乎每個國家都有自己的報告格式,因此世界空氣品質指數項目可以接受任何類型的來源格式:它們可以是 CSV、JSON 或純文字或 HTML 格式。您可以在本頁底部找到 3 個 CSV、HTML 和 JSON 範例。

作為參考,請查看新加坡荷蘭的官方來源,並注意儘管它們各不相同,但它們都可以被我們的系統攝取。

對於即時空氣粒子計數器,您可以透過我們自己的網路伺服器或透過thingspeak報告資料。

資料攝取

世界空氣品質指數系統將定期檢查來源中的數據,每次更新時,都會對其進行處理,轉換為美國 EPA 等級 AQI 值,並在分鐘。

此外,雖然僅發布 PM 2.5 、 PM 10 、臭氧、NO 2 、SO 2和 CO 空氣品質數據,但係統確實收集了更多污染物用於預測目的:苯、甲苯、乙苯、NO x 、 THC、 NMHC、PM 1 、甲醛、汞、氨、甲烷、硫化氫、亞硝酸、酚、萘、對二甲苯(p-Xylen)、間二甲苯(m-Xylen)等。

還可以發布氣象資料:溫度、大氣壓力、濕度、降水、風速、風向、太陽輻射和紫外線。如果未提供,我們將使用其他相關氣象資訊來源。

Feed 範例(CSV 格式)

 #ID: ID_BEI_DC
#City: Beijing
#Station: Dongcheng
#Name: 东城东四
#Latitude: 39.929
#Longitude: 116.417
#Timezone: +0800
Date,PM10,PM25,CO,Ozone,Sulphur Dioxide,Nitrogen Dioxide,AmbientTemperature,RelativeHumidity,WindDirection,WindSpeed,Pressure,RainGauge
Unit,ug/m3,ug/m3,ppm,µg/m3,µg/m3,µg/m3,°C,%,°,m/s,hPa,mm
10/29/2016 13:00,16,3,,58,10,3,32,66,200,3,1001,0
10/29/2016 14:00,19,8,,57,9,4,32,64,197,2,1001,0
10/29/2016 15:00,15,9,,52,47,17,30,72,190,2,1001,0
10/29/2016 16:00,31,19,,52,34,17,30,75,191,2,1001,0
10/29/2016 17:00,31,17,,49,49,19,29,75,194,1,1002,0
10/29/2016 18:00,37,18,,45,55,25,29,73,183,1,1003,0
10/29/2016 19:00,24,13,,40,21,19,29,80,65,1,1004,0
10/29/2016 20:00,39,22,,44,4,16,28,85,7,1,1005,0
10/29/2016 21:00,24,16,,43,3,7,28,85,10,1,1005,0

提要範例(HTML 格式)

這是一個基於 HTML 格式的範例(直接 url: publishingdata/html/ ):

Station list:
Station ID City or County Name Station Name Local name (optional) Latitude/Longitude Timezone (optional)
ID_BEI_DC Beijing Dongcheng 东城东四 39.929/116.417 +0800
ID_BEI_WP Beijing West Park 西城官园 39.929/116.339 +0800
ID_BEI_OP Beijing Olympic Park 朝阳奥体中心 39.982/116.397 +0800
... ... ... ... ... ...
  • Station ID 」是每個站的唯一標識符,它可以只是一個數字(例如ID8373),也可以是站城市和站名稱的串聯(例如「北京/東城」)。
  • 預設情況下,可以透過 url /city/ country-name / city-name / station-name存取該電台。
  • Station Name 」必須使用拉丁字符,因此可以提供可選的「 Local Name 」來本地化網頁。

Real-time pollutant list:
Station ID Pollutant Unit Update time Value Averaging
ID_BEI_DC PM10 mg/m3 2024-12-30T21:00:00+09:0027.8 1 hour
ID_BEI_DC PM25 mg/m3 2024-12-30T21:00:00+09:0010.8 1 hour
ID_BEI_DC Ozone mg/m3 2024-12-30T21:00:00+09:0015.2 1 hour
ID_BEI_DC Ozone mg/m3 2024-12-30T21:00:00+09:0018.2 8 hours
ID_BEI_DC Temperature Celcius 2024-12-30T21:00:00+09:0022.3 1 hour
ID_BEI_WP PM10 mg/m3 2024-12-30T21:00:00+09:0027.8 1 hour
ID_BEI_WP PM25 mg/m3 2024-12-30T21:00:00+09:0010.8 1 hour
ID_BEI_WP SO2 ppb 2024-12-30T21:00:00+09:0015.2 1 hour
ID_BEI_WP Humidiy % 2024-12-30T21:00:00+09:0088 1 hour
... ... ... ... ...
  • Averaging ”列用於指定值的持續時間。最常見的平均時間是 1 小時。它也是首選,因為我們的後端系統會自動對臭氧和一氧化碳進行 8 小時平均計算。
  • 如果提供的讀數比每小時更頻繁(例如每 30 分鐘或 10 分鐘),您可以提供給定時間段的原始讀數,也可以僅提供每小時平均值:無論如何,我們的後端系統都會處理數據即使在一個小時之間。

Feed 範例(JSON 格式)

這是一個基於 JSON 格式的範例(直接 url: /publishingdata/json/

..

粒子計數器感測器的品質控制

對於即時顆粒計數器,例如Plantower PMSNova SDS ,它們提供瞬時(幾秒內)顆粒物讀數,通常每分鐘報告一次數據。該數據通常是根據一兩分鐘內的幾個「平均」讀數來計算的。

然而,平均的使用還不夠好,特別是對於發生故障的傳感器(或即將報廢的傳感器)。因此,對於此類感測器,需要提供額外的度量,例如中位數、最小值、最大值和標準差。例如,請參閱以下 JSON 資料來源中的readings物件。

..

您可以使用以下 arduino 相容程式碼來收集這些指標:

class Accumulator 
{ 
    #define OUTPUT_BUFFER_SIZE 120 
    char buffer[OUTPUT_BUFFER_SIZE]; 
 
    #define MAXACCVALUES 120 
    int vals[MAXACCVALUES]; 
 
    int count = 0; 
 
public: 
    Accumulator() 
    { 
        reset(); 
    } 
 
    void reset() 
    { 
        count = 0; 
        for (int i=0;i< MAXACCVALUES;i++)  
        { 
            vals[i]=0; 
        } 
    } 
 
    bool hasData()  
    { 
        return count!=0; 
    } 
 
    std::string output()  
    { 
        if (!hasData()) return std::string("{}"); 
 
        sprintf(buffer, OUTPUT_BUFFER_SIZE, "{\"min\":%d,\"max\":%d,\"median\":%d,\"average\":%.1f,\"stddev\":%.1f,\"count\":%d}",  
            vmin(), vmax(), median(), average(), stddev(), count); 
 
        return std::string(buffer); 
 
    } 
 
    void add(int val) 
    { 
        if (count==MAXACCVALUES-1) { 
          for (int i = 0; i < MAXACCVALUES - 1; i++) { 
            vals[i] = vals[i + 1]; 
            } 
            count --; 
        } 
        vals[count++]=val; 
    } 
 
    float stddev()  
    { 
        if (!hasData()) return -1; 
        int u  =avg(); 
        int t = 0; 
        for (int i=0;ivals[j]) { 
                    float t = vals[j]; 
                    vals[j]=vals[i]; 
                    vals[i]=t; 
                } 
  
            } 
        } 
        return vals[count/2]; 
    } 
 
    float avg()  
    { 
        if (!hasData()) return -1; 
        float t = 0; 
        for (int i=0;ivals[i]) { 
                t=vals[i]; 
            } 
        } 
        return t; 
    } 
 
    float vmax()  
    { 
        if (!hasData()) return -1; 
        float t = vals[0]; 
        for (int i=0;it) { 
                t=vals[i]; 
            } 
        } 
        return t; 
    } 
};

調查表



MetOne BAM 1020 station

在世界空氣品質指數地圖(aqicn.org 和 waqi.info)上發布數據是免費且簡單的。

專業和DIY空氣品質監測站均可接受。

然而,DIY 站,例如“luftdaten”,會經過額外的數據品質控制,以確保高品質的數據

一旦您的數據經過驗證,您將獲得您所在站的專用頁面,您可以在其中查看即時數據、空氣品質和天氣預報以及歷史數據 - 全部免費。

如果您沒有任何監測站,但想擁有一個,請查看我們的GAIA空氣品質監測站。如果您更喜歡 DIY 電台,請查看GAIA A08


--

上傳數據

將資料上傳到地圖中分為三種情況:

    Either you have a known Air Quality monitoring station (IQAir, Oizom, Luftdaten, Sensor Community, PurpleAir, U-Rad, LUN, ...), or a known Weather Station with an air quality sensor module (Weather Link, Eco-Witt, Ambient Weather...). In which case, you only need to tell us your station details, such as the ID/Name. We already have adapters for those stations.



    您已經擁有一個網站(或諸如 thing-speak 之類的提要),我們可以從中收集您站的資料。在這種情況下,我們的系統將定期加載您的頁面,提取數據,然後將其重新發佈在我們的地圖上。檢查網站範例的提要範例


    要么您沒有網站,但您有一個站點,並且您想將資料直接「推送」到我們的系統。在這種情況下,您需要編寫一個小程式來透過我們的上傳 API「發布」您的電台資料。我們有 Arduino 和 Python 的程式碼範例。程式碼範例可從上傳 API頁面取得。


如果您屬於前兩類(擁有已知電台或網站),或者您有任何疑問,請使用下面的表格向我們發送訊息。如果您屬於第二類,並且想要透過我們的上傳 API 以程式設計方式發布數據,請檢查我們的數據上傳腳本和 API頁面。

聯絡表

Your name - eg "John Doe"


Your email address - eg "john.doe@mail.com"


Your data-feed URL - eg "https://airnow.gov/"
or station Id - eg "https://weatherlink.com/..."

告訴我們您需要或可以提供什麼樣的協助。

數據驗證

如果您擁有 luftdaten 或類似的低成本感測器,您可以檢查空氣品質資料驗證服務:

https://aqicn.org/data-feed/validation/hk/

例如,對於「luftdaten」感測器84804,您可以查看頁面aqicn.org/data-feed/validation/#/luftdaten/84804

數據驗證和鑑定也每天自動完成一次。

您知道您所在地區有空氣品質監測站嗎?
為什麼不使用您自己的空氣品質站參與地圖呢?

我們的 GAIA 空氣品質監測儀設定非常簡單:您只需要一個 WIFI 存取點和一個 USB 相容電源。

連接後,您可以透過地圖和 API 立即獲得即時空氣污染等級。

該站配有 10 公尺長的防水電源線、USB 電源、安裝設備和可選的太陽能電池板。

關於空氣質量與空氣污染指數

本網站採用的污染指數和顏色與EPA是完全相同的。 EPA的指數可以從 AirNow上查到

空气质量指数 空气质量指数级别(状况)及表示颜色 对健康影响情况 建议采取的措施
0 - 50 一级(优) 空气质量令人满意,基本无空气污染 各类人群可正常活动
51 -100 二级(良) 空气质量可接受,但某些污染物可能对极少数异常敏感人群健康有较弱影响 极少数异常敏感人群应减少户外活动
101-150 三级(轻度污染) 易感人群症状有轻度加剧,健康人群出现刺激症状 儿童、老年人及心脏病、呼吸系统疾病患者应减少长时间、高强度的户外锻炼
151-200 四级(中度污染) 进一步加剧易感人群症状,可能对健康人群心脏、呼吸系统有影响 儿童、老年人及心脏病、呼吸系统疾病患者避免长时间、高强度的户外锻炼,一般人群适量减少户外运动
201-300 五级(重度污染) 心脏病和肺病患者症状显著加剧,运动耐受力降低,健康人群普遍出现症状 儿童、老年人及心脏病、肺病患者应停留在室内,停止户外运动,一般人群减少户外运动
300+ 六级(严重污染) 健康人群运动耐受力降低,有明显强烈症状,提前出现某些疾病 儿童、老年人和病人应停留在室内,避免体力消耗,一般人群避免户外活动
(参考详见 http://zh.wikipedia.org/wiki/空气质量指数)

如果你想了解更多有關空氣質量與污染,詳見維基百科或者 AirNow

有關健康建議詳​​見北京的Richard Saint Cyr MD醫生的博客:www.myhealthbeijing.com


注意事項: 所有空氣品質數據在發佈時均未經驗證,且為了確保資料準確性,這些數據可能隨時被修改,恕不另行通知。 世界空氣品質指數專案在編制這些訊息內容時已經謹慎的運用了所有適當的技巧,在任何情況下世界空氣品質指數 在任何情況下,世界空氣品質指數專案團隊或其代理人均不對因提供此數據而直接或間接引起的任何損失、傷害或損害來承擔契約、侵權或其他責任。



設定


選擇語言:


Temperature unit:
Celcius