空气质量指数
最后更新于：2022-04-02 08:24:03
## 空气质量指数
>[danger]### 会员接口，仅限会员使用，购买[API会员](https://market.topthink.com/product/210)
> 查询全国三百多个城市或地区的空气质量指数，较小地区的数据返回上级地区的空气质量。
## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)）
### 请求地址
```
GET https://api.topthink.com/aqi/search
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| area| 是 | string | 地区名|
### 返回`data`参数
| 名称 | 类型 | 示例值 | 说明 |
| --- | --- | --- | --- |
| area | string | 上海 | 地区 |
| area\_code | string | shanghai | 地区代码 |
| so2 | string | 7 | 二氧化硫一小时平均，μg/m³ |
| o3 | string | 89 | 臭氧1小时平均，μg/m³ |
| pm2\_5 | string | 22 | 颗粒物（粒径小于等于2.5μm）1小时平均，μg/m³ |
| primary\_pollutant | string | 颗粒物(PM10) | 首要污染物 |
| co | string | 0.4 | 一氧化碳1小时平均，mg/m³ |
| num | string | 330 | 污染数 |
| no2 | string | 21 | 二氧化氮1小时平均，μg/m³ |
| quality | string | 轻度污染 | 空气质量指数类别，有“优、良、轻度污染、中度污染、重度污染、严重污染”6类 |
| aqi | string | 113 | 空气质量指数(AQI) |
| pm10 | string | 175 | 颗粒物（粒径小于等于10μm）1小时平均，μg/m³ |
| o3\_8h | string | 83 | 臭氧8小时滑动平均，μg/m³ |
| time | string | 2020-03-19 14:00:34.778 | 更新时间 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->aqiSearch()
->withArea('上海')
->request();
```
返回示例：
~~~
{
"code":0,
"message": "成功的返回",
"data": {
"area":"上海",
"area_code":"shanghai",
"so2":"7",
"o3":"89",
"pm2_5":"22",
"primary_pollutant":"颗粒物(PM10)",
"co":"0.4",
"num":"330",
"no2":"21",
"quality":"轻度污染",
"aqi":"113",
"pm10":"175",
"o3_8h":"83",
"time":"2020-03-19 14:00:34.778"
}
}
~~~
';