日出与日落时间 API 接口详解 | 咕咕数据
获取全国城市任意日期的精准日出日落时间、曙暮光时段、正午时间及太阳地球距离等天文数据，支持历史查询，适用于天气服务、摄影助手、农业平台等应用场景。
内容目录
产品功能亮点
咕咕数据的日出与日落时间 API 提供全国城市在任意日期的天文日照信息，包括但不限于日出日落、民用/航海/天文曙暮光时间、白昼长度变化、正午时刻与太阳距离等。
核心优势：
- 🏙️ 多城市支持： 全国范围覆盖，适配地理场景应用；
- 🌅 全时段天文数据： 民用、航海、天文曙暮光一应俱全；
- 🕰️ 白昼时长与变化： 包括与前一日的差值；
- ☀️ 正午时间与日地距离： 提供高精度日地距离估算；
- 🌐 安全快速： 全 HTTPS 支持，CDN 分发稳定快速；
- 🛡️ 实时监控平台： 状态查看
接口文档信息
-
接口地址：
https://api.gugudata.com/weather/sunriseandsunset -
接口文档详情：
www.gugudata.com/api/details… -
返回格式：
application/json; charset=utf-8 -
请求方式：
GET -
请求协议：
HTTPS
请求示例：
GET https://api.gugudata.com/weather/sunriseandsunset?appkey=YOUR_APPKEY&city=南京&date=20240601
请求参数说明
| 参数名 | 类型 | 是否必须 | 示例值 | 描述 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 由咕咕数据平台提供的身份认证凭证 |
| city | string | 是 | 南京 | 查询城市名称 |
| date | string | 是 | 20240601 | 查询日期，格式为 YYYYMMDD |
返回字段详解
| 字段名 | 类型 | 描述 |
|---|---|---|
| DataStatus.StatusCode | int | 返回状态码 |
| DataStatus.StatusDescription | string | 状态描述 |
| DataStatus.ResponseDateTime | string | 数据响应时间 |
| DataStatus.DataTotalCount | int | 返回数据数量，通常为 1 |
| Data.City | string | 城市名称 |
| Data.SunriseTime | string | 日出时间（格式：hh:mm） |
| Data.SunsetTime | string | 日落时间（格式：hh:mm） |
| Data.DaylightHours | string | 白昼时长（格式：hh:mm:ss） |
| Data.DaylightHoursDiff | string | 白昼与前一日时长差值（格式：+/-hh:mm） |
| Data.AstroTwilightStart | string | 天文曙光开始时间 |
| Data.AstroTwilightEnd | string | 天文曙光结束时间 |
| Data.NauticalTwilightStart | string | 航海曙光开始时间 |
| Data.NauticalTwilightEnd | string | 航海曙光结束时间 |
| Data.CivilTwilightStart | string | 民用曙光开始时间 |
| Data.CivilTwilightEnd | string | 民用曙光结束时间 |
| Data.SolarNoonTime | string | 正午时间 |
| Data.SolarNoonDistance | string | 正午时刻日地距离（单位：百万公里） |
典型应用场景
- 🌄 天气/日历类 APP： 提供日照、日落图表与建议；
- 📸 摄影计划助手： 辅助规划金光/蓝光拍摄时间；
- 🌱 农业物候模型： 模拟植物与光照周期关系；
- 🎣 户外/钓鱼工具： 结合天光周期优化活动时间；
- 🧘 冥想类产品： 根据曙暮光自动触发自然节奏内容；
测试入口与数据预览
延伸阅读
咕咕数据 —— 专注中文结构化信息服务，助力产品融合自然节律，连接真实世界。
官网地址：www.gugudata.com
