全国天气预报信息 API 接口详解 | 咕咕数据
精确到区县级别的 7 日天气预报接口，支持小时级预报、历史气温、生活指数等丰富数据维度，适用于天气产品、智能终端、出行服务等应用场景。
内容目录
产品功能亮点
- 📍 支持区县级查询： 精确至行政区，适配地理位置服务；
- 🕑 小时级别预报： 提供 24 小时预报明细，动态更新；
- 🌞 日出日落信息： 提供本地化天文指标数据；
- 🌡️ 历史极值温度： 当日最高/最低历史温度对比；
- 🧭 风向风速指标： 多维度风况预测数据；
- 📋 生活指数建议： 紫外线、穿衣、洗车、空气质量打分说明；
- ⏱️ 6 小时更新频率： 数据保持新鲜，稳定响应；
- 🛡️ 安全高可用： HTTPS 加密传输，全国 CDN 节点部署。
接口文档信息
-
API 地址：
https://api.gugudata.com/weather/weatherinfo -
返回格式：
application/json; charset=utf-8 -
请求方式：
GET -
协议支持：
HTTPS
请求示例：
GET https://api.gugudata.com/weather/weatherinfo?appkey=YOUR_APPKEY&code=110108&days=3
前置接口说明（行政区编码查询）
如需通过地区名称获取 code 值，请调用以下接口：
-
接口地址：
https://api.gugudata.com/weather/weatherinfo/region -
请求参数：
| 参数名 | 类型 | 是否必须 | 示例值 | 描述 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | API 鉴权密钥 |
| keyword | string | 是 | 北京、海淀 | 关键词模糊匹配行政区 |
- 返回值： 包括省/市/区完整编码与名称等结构化信息。
请求参数说明
| 参数名 | 类型 | 是否必须 | 默认值 | 描述 |
|---|---|---|---|---|
| appkey | string | 是 | 无 | 咕咕数据提供的接口密钥 |
| code | string | 是 | 无 | 地理坐标 [经度,纬度] 或地区编码，如 110108；需通过前置接口获取 |
| days | int | 否 | 1 | 天气预报天数（最大 7 天） |
返回字段详解（节选核心字段）
| 字段名 | 类型 | 描述 |
|---|---|---|
| DataStatus.StatusCode | int | 返回状态码 |
| DataStatus.StatusDescription | string | 状态说明 |
| Data.Code | string | 查询区域的行政编码 |
| Data.CodeAddress | string | 反地理坐标编码结果 |
| Data.WeatherDate | string | 当前天气数据日期 |
| Data.WeatherInfo | string | 当前天气描述（如“多云转晴”） |
| Data.TemperatureHigh | int | 当日最高温度 |
| Data.TemperatureLow | int | 当日最低温度 |
| Data.TodayHistoryHighestTemperature | int | 当日历史最高温度 |
| Data.TodayHistoryLowestTemperature | int | 当日历史最低温度 |
| Data.SunRiseTime | string | 日出时间 |
| Data.SunSetTime | string | 日落时间 |
小时级预报字段（Data.WeatherPerHour）
| 字段名 | 类型 | 描述 |
|---|---|---|
| WeatherTime | string | 小时时间点（24h） |
| WeatherInfo | string | 天气情况 |
| Temperature | string | 该时段温度 |
| WeatherWindCondition | string | 风向 |
| WeatherWindLevel | string | 风力等级 |
生活指数字段（Data.LifeHelper）
| 字段名 | 类型 | 描述 |
|---|---|---|
| HelperName | string | 指数名称，如“紫外线”、“穿衣” |
| HelperStatus | string | 当前状态，例如“弱”、“较适宜” |
| HelperValue | string | 评分值（UV 为 5 分制，穿衣 7 分制等） |
| HelperContent | string | 建议描述内容 |
典型应用场景
- 📱 天气 APP 与小程序： 提供精准城市/区县天气展示；
- 🚘 车载与出行服务平台： 接入未来 7 日天气与小时变化数据；
- 🧍♂️ 穿衣与活动建议系统： 利用生活指数构建个性化出行助手；
- 🌾 农业气象系统： 支持乡镇级天气数据采集；
- 🏞️ 旅游/户外平台： 推送本地化日照/气温/风力预警与建议。
测试入口与数据预览
- 🧪 接口测试地址
延伸阅读
咕咕数据，专注结构化数据服务，为产品提供实时天气感知能力。
访问官网：www.gugudata.com
