## 城市空氣質量  > 城市空氣質量、城市空氣PM2.5指數、城市輻射指數 ## 接口費用（ [點擊購買](https://market.topthink.com/product/325)） > 最低 0.0015元/次 ## 接口調用（[調用須知](https://docs.topthink.com/think-api/1835086)） ## 接口1：城市空氣質量查詢 ### 請求地址 ``` GET https://api.topthink.com/air/search ``` ### 請求參數 | 名稱 | 必填 | 類型 | 說明 | | --- | --- | --- | --- | | appCode| 是| string|用戶授權碼，參考[API調用](https://docs.topthink.com/think-api/1835086) | | ?city | 是 | String | 城市名稱的中文名稱或拼音，如：上海 或 shanghai | ### 返回`data`參數 | 名稱 | 類型 | 說明 | | --- | --- | --- | | citynow | JSONObject | 查詢的最新結果 | | lastTwoWeeks | JSONObject | 最近幾周的空氣質量數據 | | lastMoniData | JSONObject | 各監測點的數據,如果字段返回"—",可能是該監測點未監測這項數據或者有延遲 | ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->airSearch() ->withCity('蘇州') ->request(); dump($result); ``` 返回示例 ``` { "code": 0, "message": "成功", "data":[ { "citynow": { "city": "suzhou", "AQI": "77", "quality": "良", "date": "2014-05-09 14:00" }, "lastTwoWeeks": { "1": { "city": "suzhou", "AQI": "100", "quality": "良", "date": "2014-05-08" }, "2": { "city": "suzhou", "AQI": "99", "quality": "良", "date": "2014-05-07" }, "3": { "city": "suzhou", "AQI": "77", "quality": "良", "date": "2014-05-06" }, "4": { "city": "suzhou", "AQI": "75", "quality": "良", "date": "2014-05-05" }, "5": { "city": "suzhou", "AQI": "78", "quality": "良", "date": "2014-05-04" }, "6": { "city": "suzhou", "AQI": "84", "quality": "良", "date": "2014-05-03" }, "7": { "city": "suzhou", "AQI": "135", "quality": "輕度污染", "date": "2014-05-02" }, "8": { "city": "suzhou", "AQI": "126", "quality": "輕度污染", "date": "2014-05-01" }, "9": { "city": "suzhou", "AQI": "87", "quality": "良", "date": "2014-04-30" }, "10": { "city": "suzhou", "AQI": "97", "quality": "良", "date": "2014-04-29" }, "11": { "city": "suzhou", "AQI": "77", "quality": "良", "date": "2014-04-28" }, "12": { "city": "suzhou", "AQI": "84", "quality": "良", "date": "2014-04-27" }, "13": { "city": "suzhou", "AQI": "45", "quality": "優", "date": "2014-04-26" }, "14": { "city": "suzhou", "AQI": "56", "quality": "良", "date": "2014-04-25" }, "15": { "city": "suzhou", "AQI": "83", "quality": "良", "date": "2014-04-24" }, "16": { "city": "suzhou", "AQI": "95", "quality": "良", "date": "2014-04-23" }, "17": { "city": "suzhou", "AQI": "101", "quality": "輕度污染", "date": "2014-04-22" } }, "lastMoniData": { "1": { "city": "上方山", "AQI": "77", "quality": "良", "PM2.5Hour": "46μg/m3", "PM2.5Day": "46μg/m3", "PM10Hour": "104μg/m3", "lat": "31.247222", "lon": "120.561389" }, "2": { "city": "南門", "AQI": "112", "quality": "輕度污染", "PM2.5Hour": "84μg/m3", "PM2.5Day": "84μg/m3", "PM10Hour": "—μg/m3", "lat": "31.286389", "lon": "120.6275" }, "3": { "city": "彩香", "AQI": "76", "quality": "良", "PM2.5Hour": "46μg/m3", "PM2.5Day": "46μg/m3", "PM10Hour": "101μg/m3", "lat": "31.301944", "lon": "120.590833" }, "4": { "city": "軋鋼廠", "AQI": "68", "quality": "良", "PM2.5Hour": "41μg/m3", "PM2.5Day": "41μg/m3", "PM10Hour": "85μg/m3", "lat": "31.326389", "lon": "120.595556" }, "5": { "city": "吳中區", "AQI": "64", "quality": "良", "PM2.5Hour": "46μg/m3", "PM2.5Day": "46μg/m3", "PM10Hour": "—μg/m3", "lat": "31.270278", "lon": "120.612778" }, "6": { "city": "蘇州新區", "AQI": "72", "quality": "良", "PM2.5Hour": "46μg/m3", "PM2.5Day": "46μg/m3", "PM10Hour": "93μg/m3", "lat": "31.299444", "lon": "120.543333" }, "7": { "city": "蘇州工業園區", "AQI": "82", "quality": "良", "PM2.5Hour": "60μg/m3", "PM2.5Day": "60μg/m3", "PM10Hour": "88μg/m3", "lat": "31.309722", "lon": "120.669167" } } } ] } ``` ## 接口2：查詢城市PM2.5指數 ### 請求地址 ``` GET https://api.topthink.com/air/pm ``` ### 請求參數 | 名稱 | 必填 | 類型 | 說明 | | --- | --- | --- | --- | | appCode| 是| string|用戶授權碼，參考[API調用](https://docs.topthink.com/think-api/1835086) | | city | 是 | String | 城市名稱的中文名稱或拼音，如：上海 或 shanghai | ### 返回`data`參數 參考返回示例 ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->airPm() ->withCity('蘇州') ->request(); dump($result); ``` 返回結果示例: ``` { "code": 0, "message": "成功", "data":[ { "city": "蘇州", /*城市*/ "PM2.5": "73", /*PM2.5指數(ug/m3)*/ "AQI": "98", /*空氣質量指數*/ "quality": "良", /*空氣質量*/ "PM10": "50",/*PM10(ug/m3)*/ "CO": "0.79", /*一氧化碳(mg/m3)*/ "NO2": "65", /*二氧化氮(ug/m3)*/ "O3": "28", /*臭氧(ug/m3)*/ "SO2": "41", /*二氧化硫(ug/m3)*/ "time": "2014-12-26 11:48:40"/*更新時間*/ } ] } ``` ## 接口3：查詢支持空氣質量指數的城市列表 ### 請求地址 ``` GET https://api.topthink.com/air/city ``` ### 請求參數 無 ### 返回`data`參數 參考返回示例 ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->airCity() ->request(); dump($result); ``` 返回結果示例: ``` { "code": 0, "message": "成功", "data":[ { "name": "湛江",/*城市名*/ "pinyin": "zhanjiang"/*城市拼音*/ }, { "name": "石河子", "pinyin": "shihezi" }, { "name": "壽光", "pinyin": "shouguang" }, { "name": "玉林", "pinyin": "yulinshi" }, { "name": "大慶", "pinyin": "daqing" }, { "name": "上海", "pinyin": "shanghai" }, ... ] } ``` ## 接口4：查詢支持PM2.5指數的城市 ### 請求地址 ``` GET https://api.topthink.com/air/pm_city ``` ### 請求參數 無 ### 返回`data`參數 參考返回示例 ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->airPmCity() ->request(); dump($result); ``` 返回結果示例: ``` { "code": 0, "message": "成功", "data":[ { "name": "泰州",/*城市名*/ "pinyin": "taizhoushi"/*城市拼音*/ }, { "name": "淮安", "pinyin": "huaian" }, { "name": "邢臺", "pinyin": "xingtai" }, { "name": "南平", "pinyin": "nanping" }, { "name": "舟山", "pinyin": "zhoushan" }, ... ] } ```