全國天氣預報信息 API 接口
精確到行政區的7日天氣預報。
1. 產品功能
- 支持通過地理坐標、區域編碼兩種形式查詢對應地區的天氣信息；
- 全國天氣預報每隔 6 小時更新數據；
- 精確到行政區級別的天氣預報數據；
- 提供最長 7 天的天氣預報數據；
- 提供每日小時級別的天氣預報數據；
- 提供本地日出日落、當日歷史溫度等附加數據；
- 提供紫外線、穿衣、洗車、空氣污染等額外指導數據；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全國多節點 CDN 部署；
- 接口極速響應，多台服務器構建 API 接口負載均衡。
2. API 文檔
API 詳情地址: https://www.gugudata.com/api/details/weatherinfo
接口請求地址: https://api.gugudata.com/weather/weatherinfo
返回格式: application/json; charset=utf-8
請求方式: GET
請求協議: HTTPS
請求示例: https://api.gugudata.com/weather/weatherinfo?appkey=YOUR_APPKEY&code=YOUR_VALUE&days=1
接口測試: https://api.gugudata.com/weather/weatherinfo/demo
前置接口
前置接口說明: 查詢地區編碼，根據市或區的關鍵字進行查詢，如北京、蘇州、海淀、吳中等
前置接口地址: https://api.gugudata.com/weather/weatherinfo/region?appkey=APPKEY&keyword=查詢編碼的市或區關鍵字，如北京、海淀
前置接口參數說明: appkey=YOUR_APPKEY&keyword=查詢編碼的市或區關鍵字，如北京、海淀
前置接口返回格式: application/json; charset=utf-8
前置接口返回說明: 包含地區編碼以及省、市、區相關信息
前置接口請求方式: GET
前置接口請求協議: HTTPS
3. 請求參數（如果為 POST 請求，那么參數以 JSON 的格式傳遞）
| 參數名 | 參數類型 | 是否必須 | 默認值 | 備注 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付費后獲取的 APPKEY |
| code | string | 是 | YOUR_VALUE | 地理坐標或地區編碼。當傳遞地理坐標時，格式為: [經度,緯度]，如:[120.730724,31.31592]；如果傳遞地區編碼，那么可通過前置接口查詢獲得地區編碼。 |
| days | int | 否 | 1 | 獲取天氣預報的天數，默認為1，即為當天數據。最大值為7。 |
4. 返回參數
| 參數名 | 參數類型 | 備注 |
|---|---|---|
| DataStatus.StatusCode | int | 接口返回狀態碼 |
| DataStatus.StatusDescription | string | 接口返回狀態說明 |
| DataStatus.ResponseDateTime | string | 接口數據返回時間 |
| DataStatus.DataTotalCount | int | 此條件下的總數據量 |
| Data.Code | string | 地區編碼 |
| Data.CodeAddress | string | 如果傳遞的查詢參數為地理坐標，那么該字段將返回地理坐標反解析之后的行政區划信息，格式為: 省份,市,區,街道/鎮,POI地址,詳細地址，如: 江蘇省,蘇州市,吳中區,斜塘街道,東湖·春之韻,會心街99號(金塔橋以西,鴻禧橋以北)；如果傳遞的查詢參數是地區編碼，那么此字段值為 null，具體值可通過 Data.WeatherRegion 獲取。 |
| Data.WeatherDate | string | 天氣預報的日期 |
| Data.WeatherRegion | object | 當前天氣預報的詳細地區信息，數據格式與查詢地區編碼接口返回數據格式一致。 |
| Data.WeatherRegion.ReginType | string | 位置信息類型，2為市級別數據，3為區級別數據 |
| Data.WeatherRegion.Code | string | 地區完整編碼 |
| Data.WeatherRegion.ProvinceCode | string | 省編碼 |
| Data.WeatherRegion.ProvinceName | string | 省名稱 |
| Data.WeatherRegion.CityCode | string | 市編碼 |
| Data.WeatherRegion.CityName | string | 市名稱 |
| Data.WeatherRegion.RegionCode | string | 區編碼 |
| Data.WeatherRegion.RegionName | string | 區名稱 |
| Data.WeatherRegion.TownCode | string | 鎮編碼 |
| Data.WeatherRegion.TownName | string | 鎮名稱 |
| Data.WeatherInfo | string | 天氣情況 |
| Data.TemperatureHigh | int | 最高溫度 |
| Data.TemperatureLow | int | 最低溫度 |
| Data.TodayHistoryHighestTemperature | int | 當日歷史最高溫度 |
| Data.TodayHistoryLowestTemperature | int | 當日歷史最低溫度 |
| Data.WeatherWindCondition1 | string | 風向1 |
| Data.WeatherWindCondition2 | string | 風向2 |
| Data.WeatherWindLevel | string | 風級 |
| Data.SunRiseTime | string | 日出時間 |
| Data.SunSetTime | string | 日落時間 |
| Data.WeatherPerHour | array | 當日小時級別的天氣預報數據數組 |
| Data.WeatherPerHour.WeatherTime | string | 預報的小時時間，24小時制 |
| Data.WeatherPerHour.WeatherInfo | string | 天氣情況 |
| Data.WeatherPerHour.Temperature | string | 溫度 |
| Data.WeatherPerHour.WeatherWindCondition | string | 風向 |
| Data.WeatherPerHour.WeatherWindLevel | string | 風級 |
| Data.LifeHelperUV | object | UV指數 |
| Data.LifeHelperWear | object | 穿衣指數 |
| Data.LifeHelperWashCar | object | 洗車指數 |
| Data.LifeHelperAir | object | 空氣指數 |
| Data.LifeHelper.HelperName | string | 指數名稱 |
| Data.LifeHelper.HelperStatus | string | 指數狀態 |
| Data.LifeHelper.HelperValue | string | 指數值。總分：紫外線5分，穿衣7分，洗車4分，空氣5分 |
| Data.LifeHelper.HelperContent | string | 指數內容 |
| Data.WeatherDataGenerateDateTime | string | 天氣預報內容數據生成時間 |
5. 接口響應狀態碼
| 狀態碼 | 狀態碼解釋 | 備注 |
|---|---|---|
| 100 | 正常返回 | 可通過判斷此狀態碼斷言接口正常返回 |
| -1 | 請求失敗 | 請求處理請求失敗 |
| 501 | 參數錯誤 | 請檢查您傳遞的參數個數以及參數類型是否匹配 |
| 502 | 請求頻率受限 | 一般建議每秒請求不超過 100 次 |
| 503 | APPKEY 權限超限/訂單到期 | 請至開發者中心檢查您的 APPKEY 是否到期或是否權限超限 |
| 504 | APPKEY 錯誤 | 請檢查傳遞的 APPKEY 是否為開發者中心獲取到的值 |
| 505 | 請求的次數超出接口限制 | 請檢查對應接口是否有請求次數限制以及您目前的接口請求剩余次數 |
| 900 | 接口內部響應錯誤 | 接口可用性為 99.999%，如獲取到此狀態碼請郵件聯系我們 |
6. 開發語言請求示例代碼
示例代碼包含的開發語言：C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等，其他語言進行對應的 RESTful API 請求實現即可。
咕咕數據，專業的數據提供商，提供專業全面的數據接口、商業數據分析，讓數據成為您的生產原料。
咕咕數據基於我們五年來為企業客戶提供的海量數據支撐，將部分通用數據、通用功能抽象成產品級 API，大大滿足了用戶在產品開發過程中對基礎數據的需求，同時降低了復雜功能的實現門檻與人力成本。
除了我們已開放的分類數據與接口外，還有海量數據正在整理、清洗、整合、構建中，后期會開放更多的數據與雲端功能接口供用戶使用。
目前已開放的數據接口 API
- [條碼工具] 通用二維碼生成
- [條碼工具] Wi-Fi 無線網二維碼生成
- [條碼工具] 通用條形碼生成
- [圖像識別] 通用 OCR
- [圖像識別] HTML 轉 PDF
- [圖像識別] HTML 轉 Word
- [區域/坐標] 全國大學高校基礎信息
- [區域/坐標] 地理坐標逆編碼
- [區域/坐標] IP地址定位
- [區域/坐標] 全國省市區街道區域信息
- [區域/坐標] 地理坐標系轉換
- [元數據/字典] 歷年高考省錄取分數線
- [元數據/字典] 歷年高考高校錄取分數線
- [元數據/字典] 歷年高考專業錄取分數線
- [新聞/資訊] 軟件開發技術博文頭條
- [新聞/資訊] 獲取任意鏈接文章正文
- [新聞/資訊] 公眾號頭條文章
- [新聞/資訊] 獲取任意鏈接正文圖片
- [新聞/資訊] 獲取公眾號文章封面
- [新聞/資訊] 幽默笑話大全
- [短信/語音] 手機歸屬地查詢
- [文字/文本] 中文文本分詞
- [文字/文本] 中英文排版規范化
- [文字/文本] 百萬中國對聯數據
- [文字/文本] 簡體繁體互轉
- [文字/文本] 唐詩宋詞大全
- [文字/文本] 關鍵字摘要智能提取
- [天氣/空氣質量] 全國天氣預報信息
- [網站工具] 獲取任意站點標題與圖標
- [股票行情] A 股歷史行情數據
- [股票行情] 美股歷史行情數據
- [股票行情] 港股歷史行情數據
- [股票行情] 美股實時行情數據
- [股票行情] 港股實時行情數據
- [股票行情] A股實時行情數據
- [體育/比賽] 歷年奧運比賽數據