API - Air Quality Programmatic APIs

Share: aqicn.org/api/jp/

Initial setup

The first step is to make sure to acquire your own token for all API access.
You can get your token from the data-platform token page.

Map tile API

The map tile API can be used to show the real-time Air Quality index on a google, bing or openstreet map.
Read more about the Map tile API description and examples

Widget API

The widget API can be used to integrate the real-time Air Quality index on any web page.
Read more about the Widget API description


There is also a non-progammatic API for an easy integration with word-press, which can generate any of the widget below. For more information, go to your city page (eg aqicn.org/city/auckland), scroll-down until you find the "Download the real-time Air Quality Index Widget" and click on the "Wordpress & Blogger" logo.

JSON API

 $ curl -i "http://api.waqi.info/feed/shanghai/?token=demo"
The JSON API can be used for advanced programmatic integration:
  • Access to more than 11000 station-level and 1000 city-level data
  • Geo-location query (based on latitude/longitude or IP address)
  • Individual AQI for all pollutants (PM2.5, PM10, NO2, CO, SO2, Ozone)
  • Station name and coordinates
  • Originating EPA name and link
  • Current weather conditions
  • Stations within a map lat/lng bounds
  • Search stations by name
For more information, you can use the on-line API documentation or refer to the sample javascript code / web demo.

Note that more functionality will be added during the coming weeks:
  • Air Quality forecast (for 3~8 days)
  • Weather forecast (for 8 days)
  • World ranking and trend
  • Neighbor stations AQI
  • Historical Data
  • Pollutant raw concentration (for usage with different scales)
  • PubSub notification service


We may change, delete, add to, or otherwise amend information contained on this website without notice
  • Under no circumstances will the World Air Quality Index project team or its agents be liable in contract, tort or otherwise for any loss, injury or damage arising directly or indirectly from the supply of this data.
  • Term of Service

    The usage of the programmatic API are subjected to a "acceptable usage" policy:

    API Usage

    • All the APIs are provided for free.
    • A valid key must be used for accessing the API.
    • All the API are subjected to quota.
    The default quota is max 1000 (one thousand) requests per second. (Yes, that's a lot, and that's thanks to the support from our colleagues at the UNEP).

    Data usage

    • The data can not be sold or included in sold packages.
    • The data can not be used in paid applications or services.
    • The data can not be redistributed as cached or archived data.
    (where data refers to the data obtained from the APIs)
    For the historical data, check the data platform page.

    App usage

    • Attribution to the World Air Quality Index Project as well as originating EPA is mandatory.
    • Public usage by for-profit corporations requires explicit agreement wit the World Air Quality Index team.
    • Public usage by non-profit organization requires prior notification (by email) to the World Air Quality Index team.
    (where app refers to any application, services which make use of the above mentioned data)

    --

    If the above policy does not fulfill your needs, or if you need larger quota, then please contact us first.

    Please note that the we reserve the right to change the term of service at any time and without prior notice.

    Warranty

    All reasonable measures have been taken to ensure the quality and accuracy of the Data provided by the above APIs. However:
    • We do not make warranty, express or implied, nor assume any legal liability or responsibility for the accuracy, correctness, completeness of the information.
    • We do not assume any legal liability or responsibility for any damage or loss that may directly or indirectly result from any information contained on this website or any actions taken as a result of the content of this website;



    --

    Read or publish comments (they rely on Disqus)

    大気汚染指数の測定方法:

    大気汚染レベルについて

    指数 大気質指数の分類(米国) 健康影響 / カテゴリ 粒子状物質(PM10,PM2.5)
    0 - 50 良い - Good 通常の活動が可能 なし
    51 -100 並 - Moderate 特に敏感な者は、長時間又は激しい屋外活動の減少を検討 非常に敏感な人は、長時間または激しい活動を減らすよう検討する必要がある。
    101-150 敏感なグループにとっては健康に良くない - Unhealthy for Sensitive Groups 心臓・肺疾患患者、高齢者及び子供は、長時間又は激しい屋外活動を減少 心疾患や肺疾患を持つ人、高齢者、子供は、長時間または激しい活動を減らす必要がある。
    151-200 健康に良くない - Unhealthy 上記の者は、長時間又は激しい屋外活動を中止
    すべての者は、長時間又は激しい屋外活動を減少
    心疾患や肺疾患を持つ人、高齢者、子供は、長時間または激しい活動を中止する必要がある。それ以外の人でも、長時間または激しい活動を減らす必要がある。
    201-300 極めて健康に良くない - Very Unhealthy 上記の者は、すべての屋外活動を中止
    すべての者は、長時間又は激しい屋外活動を中止
    心疾患や肺疾患を持つ人、高齢者、子供は、全ての屋外活動を中止する必要がある。それ以外の人でも、長時間または激しい活動を中止する必要がある。
    300+ 危険 - Hazardous 上記の者は、屋内に留まり、体力消耗を避ける
    すべての者は、屋外活動を中止
    全ての人が屋外活動を中止する必要がある。特に、心疾患や肺疾患を持つ人、高齢者、子供は、屋内に留まって激しい活動を避け静かに過ごす必要がある。
    (Reference: see wikipedia, and cn.emb-japan.go.jp/)

    大気汚染についての更なる詳細をお知りになりたい方は、WikipediaAirNowを参照してください。

    北京在住の医師Richard Saint Cyr氏による大変役に立つ健康上のアドバイスは、 www.myhealthbeijing.com をご覧ください。


    使用上の注意: すべての大気質データは公開時点では妥当性が担保されていないため、これらのデータは予告なしに修正することがあります。 世界大気質指数プロジェクトは、この情報の内容を編集に最善の注意を尽くしておりますが、いかなる状況においても World Air Quality Index プロジェクトチームまたはそのエージェントは、このデータの供給によって直接的または間接的に生じる損失や損害について責任を負いません。



    設定


    言語を選択:


    Temperature unit:
    Celcius