空气质量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 | 用以搜索指定地点的特定ID | N/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_5 | PM2.5（直径小于2.5微米的颗粒物）浓度，单位为微克每立方米 (µg/m3) |
| ParticulateMatter10 | PM10（直径小于10微米的颗粒物）浓度，单位为微克每立方米 (µg/m3) |
| Ozone | 臭氧颗粒物浓度，单位为微克每立方米 (µg/m3) |
| CarbonMonoxide | 一氧化碳浓度，单位为毫克每立方米 (mg/m3) |
| NitrogenMonoxide | 一氧化氮浓度，单位为微克每立方米 (µg/m3) |
| NitrogenDioxide | 二氧化氮浓度，单位为微克每立方米 (µg/m3) |
| SulfurDioxide | 二氧化硫浓度，单位为微克每立方米 (µg/m3) |
| Lead | 铅颗粒物浓度，单位为微克每立方米 (µg/m3) |