## 空氣質量指數 >[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/m3 | | o3 | string | 89 | 臭氧1小時平均，μg/m3 | | pm2\_5 | string | 22 | 顆粒物（粒徑小于等于2.5μm）1小時平均，μg/m3 | | primary\_pollutant | string | 顆粒物(PM10) | 首要污染物 | | co | string | 0.4 | 一氧化碳1小時平均，mg/m3 | | num | string | 330 | 污染數 | | no2 | string | 21 | 二氧化氮1小時平均，μg/m3 | | quality | string | 輕度污染 | 空氣質量指數類別，有“優、良、輕度污染、中度污染、重度污染、嚴重污染”6類 | | aqi | string | 113 | 空氣質量指數(AQI) | | pm10 | string | 175 | 顆粒物（粒徑小于等于10μm）1小時平均，μg/m3 | | o3\_8h | string | 83 | 臭氧8小時滑動平均，μg/m3 | | 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" } } ~~~