API - Air Quality Programmatic APIs

Share: aqicn.org/api/cn/

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 9000 station level and 600 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 minute (~16RPS) and with burst up to 60 requests.

    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)

    关于空气质量与空气污染指数

    本网站采用的污染指数和颜色与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