Appearance

空气质量API开发指南 ​

基本信息 ​

  • 华风爱科 API提供给用户一个简洁的RESTful Web接口，用以访问基于位置的天气数据。
  • 空气质量搜索需要Location key。请使用定位API以获得您需要位置的Location key。
  • 空气中的颗粒物浓度计算单位为微克每立方米(µg/m3)。
  • 在道路以及灰尘较多的工业区域发现的"可吸入颗粒物"直径小于10微米，大于2.5微米。
  • 雾霾与烟内的"细小颗粒物"直径小于2.5微米。这些颗粒物一般直接由火灾释放，或者当工厂，工业，与汽车排放的气体与空气产生化学反应后形成。
  • 数据支持中英文语言。如需要更多语言与本地化方言请联系商务。

API服务地址 ​

请求URL ​
类型URL请求方式
使用LocationKey调取当前空气质量https://openapi.weathercn.com/airquality/{version}/global/observations/{locationKey}{.{format}}?apikey=<用户的key>{&language={language code}}GET
请求参数 ​
参数说明默认值
apikey用以在API里验证与授权使用的用户密钥。N/A必选
version当前API版本v1必选
locationkey用以搜索指定地点的特定IDN/A必选
format响应格式JSON可选
language指定响应数据语言的字符串zh-cn可选
返回参数 ​
参数说明
Date空气质量日期与时间， ISO8601 格式: yyyy-mm-ddThh:mm:ss±hh:mm
EpochDate空气质量的UNIX时间，从协调世界时1970年1月1日0时0分0秒起至现在的总秒数，不考虑闰秒 (午夜 UTC/GMT)
Index空气质量指数，从0到500,显示，1为最优，500为最差。
ParticulateMatter2_5PM2.5（直径小于2.5微米的颗粒物）浓度，单位为微克每立方米 (µg/m3)
ParticulateMatter10PM10（直径小于10微米的颗粒物）浓度，单位为微克每立方米 (µg/m3)
Ozone臭氧颗粒物浓度，单位为微克每立方米 (µg/m3)
CarbonMonoxide一氧化碳浓度，单位为毫克每立方米 (mg/m3)
NitrogenMonoxide一氧化氮浓度，单位为微克每立方米 (µg/m3)
NitrogenDioxide二氧化氮浓度，单位为微克每立方米 (µg/m3)
SulfurDioxide二氧化硫浓度，单位为微克每立方米 (µg/m3)
Lead铅颗粒物浓度，单位为微克每立方米 (µg/m3)
调用示例 ​

  1. 使用LocationKey调取当前空气质量

    json
    https://openapi.weathercn.com/airquality/v1/global/observations/101924.json?apikey=<用户的key>&language=zh-cn

    在线体验