全國天氣預(yù)報信息 API 接口
精確到行政區(qū)的7日天氣預(yù)報贸人。
1. 產(chǎn)品功能
支持通過地理坐標(biāo)间景、區(qū)域編碼兩種形式查詢對應(yīng)地區(qū)的天氣信息；
全國天氣預(yù)報每隔 6 小時更新數(shù)據(jù)艺智；
精確到行政區(qū)級別的天氣預(yù)報數(shù)據(jù)拱燃；
提供最長 7 天的天氣預(yù)報數(shù)據(jù)；
提供每日小時級別的天氣預(yù)報數(shù)據(jù)力惯；
提供本地日出日落碗誉、當(dāng)日歷史溫度等附加數(shù)據(jù)；
提供紫外線父晶、穿衣哮缺、洗車、空氣污染等額外指導(dǎo)數(shù)據(jù)甲喝；
全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）尝苇；
全面兼容 Apple ATS；
全國多節(jié)點 CDN 部署埠胖；
接口極速響應(yīng)糠溜，多臺服務(wù)器構(gòu)建 API 接口負(fù)載均衡。
2. API 文檔
API 詳情地址: https://www.gugudata.com/api/details/weatherinfo
接口請求地址: https://api.gugudata.com/weather/weatherinfo
返回格式: application/json; charset=utf-8
請求方式: GET
請求協(xié)議: HTTPS
請求示例: https://api.gugudata.com/weather/weatherinfo?appkey=YOUR_APPKEY&code=YOUR_VALUE&days=1
接口測試: https://api.gugudata.com/weather/weatherinfo/demo
前置接口
前置接口說明: 查詢地區(qū)編碼直撤，根據(jù)市或區(qū)的關(guān)鍵字進(jìn)行查詢非竿，如北京、蘇州谋竖、海淀红柱、吳中等
前置接口參數(shù)說明: appkey=YOUR_APPKEY&keyword=查詢編碼的市或區(qū)關(guān)鍵字锤悄，如北京、海淀
前置接口返回格式: application/json; charset=utf-8
前置接口返回說明: 包含地區(qū)編碼以及省嘉抒、市零聚、區(qū)相關(guān)信息
前置接口請求方式: GET
前置接口請求協(xié)議: HTTPS
3. 請求參數(shù)
| 參數(shù)名 | 參數(shù)類型 | 是否必須 | 默認(rèn)值 | 備注 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付費后獲取的 APPKEY |
| code | string | 是 | YOUR_VALUE | 地理坐標(biāo)或地區(qū)編碼。當(dāng)傳遞地理坐標(biāo)時，格式為: [經(jīng)度,緯度]隶症，如:[120.730724,31.31592]容诬；如果傳遞地區(qū)編碼，那么可通過前置接口查詢獲得地區(qū)編碼沿腰。 |
| days | int | 否 | 1 | 獲取天氣預(yù)報的天數(shù)览徒，默認(rèn)為1，即為當(dāng)天數(shù)據(jù)颂龙。最大值為7习蓬。 |
4. 返回參數(shù)
| 參數(shù)名 | 參數(shù)類型 | 備注 |
|---|---|---|
| DataStatus.StatusCode | int | 接口返回狀態(tài)碼 |
| DataStatus.StatusDescription | string | 接口返回狀態(tài)說明 |
| DataStatus.ResponseDateTime | string | 接口數(shù)據(jù)返回時間 |
| DataStatus.DataTotalCount | int | 此條件下的總數(shù)據(jù)量 |
| Data.Code | string | 地區(qū)編碼 |
| Data.CodeAddress | string | 如果傳遞的查詢參數(shù)為地理坐標(biāo)，那么該字段將返回地理坐標(biāo)反解析之后的行政區(qū)劃信息措嵌，格式為: 省份,市,區(qū),街道/鎮(zhèn),POI地址,詳細(xì)地址躲叼，如: 江蘇省,蘇州市,吳中區(qū),斜塘街道,東湖·春之韻,會心街99號(金塔橋以西,鴻禧橋以北)；如果傳遞的查詢參數(shù)是地區(qū)編碼企巢，那么此字段值為 null枫慷，具體值可通過 Data.WeatherRegion 獲取。 |
| Data.WeatherDate | string | 天氣預(yù)報的日期 |
| Data.WeatherRegion | object | 當(dāng)前天氣預(yù)報的詳細(xì)地區(qū)信息浪规，數(shù)據(jù)格式與查詢地區(qū)編碼接口返回數(shù)據(jù)格式一致或听。 |
| Data.WeatherRegion.ReginType | string | 位置信息類型，2為市級別數(shù)據(jù)笋婿，3為區(qū)級別數(shù)據(jù) |
| Data.WeatherRegion.Code | string | 地區(qū)完整編碼 |
| Data.WeatherRegion.ProvinceCode | string | 省編碼 |
| Data.WeatherRegion.ProvinceName | string | 省名稱 |
| Data.WeatherRegion.CityCode | string | 市編碼 |
| Data.WeatherRegion.CityName | string | 市名稱 |
| Data.WeatherRegion.RegionCode | string | 區(qū)編碼 |
| Data.WeatherRegion.RegionName | string | 區(qū)名稱 |
| Data.WeatherRegion.TownCode | string | 鎮(zhèn)編碼 |
| Data.WeatherRegion.TownName | string | 鎮(zhèn)名稱 |
| Data.WeatherInfo | string | 天氣情況 |
| Data.TemperatureHigh | int | 最高溫度 |
| Data.TemperatureLow | int | 最低溫度 |
| Data.TodayHistoryHighestTemperature | int | 當(dāng)日歷史最高溫度 |
| Data.TodayHistoryLowestTemperature | int | 當(dāng)日歷史最低溫度 |
| Data.WeatherWindCondition1 | string | 風(fēng)向1 |
| Data.WeatherWindCondition2 | string | 風(fēng)向2 |
| Data.WeatherWindLevel | string | 風(fēng)級 |
| Data.SunRiseTime | string | 日出時間 |
| Data.SunSetTime | string | 日落時間 |
| Data.WeatherPerHour | array | 當(dāng)日小時級別的天氣預(yù)報數(shù)據(jù)數(shù)組 |
| Data.WeatherPerHour.WeatherTime | string | 預(yù)報的小時時間誉裆，24小時制 |
| Data.WeatherPerHour.WeatherInfo | string | 天氣情況 |
| Data.WeatherPerHour.Temperature | string | 溫度 |
| Data.WeatherPerHour.WeatherWindCondition | string | 風(fēng)向 |
| Data.WeatherPerHour.WeatherWindLevel | string | 風(fēng)級 |
| Data.LifeHelperUV | object | UV指數(shù) |
| Data.LifeHelperWear | object | 穿衣指數(shù) |
| Data.LifeHelperWashCar | object | 洗車指數(shù) |
| Data.LifeHelperAir | object | 空氣指數(shù) |
| Data.LifeHelper.HelperName | string | 指數(shù)名稱 |
| Data.LifeHelper.HelperStatus | string | 指數(shù)狀態(tài) |
| Data.LifeHelper.HelperValue | string | 指數(shù)值「妆簦總分：紫外線5分足丢，穿衣7分，洗車4分庇配，空氣5分 |
| Data.LifeHelper.HelperContent | string | 指數(shù)內(nèi)容 |
| Data.WeatherDataGenerateDateTime | string | 天氣預(yù)報內(nèi)容數(shù)據(jù)生成時間 |
