Sunrise Sunset API
收藏RapidAPI2025-05-09 更新2025-05-10 收录
下载链接：
https://rapidapi.com/garrisonbates02/api/sunrise-sunset-api1
下载链接
链接失效反馈官方服务：
资源简介：
Look up the sunrise and sunset by latitude and longitude
创建时间：
2025-05-09
原始信息汇总
Sunrise Sunset API 数据集概述
基本信息
- API名称: Sunrise Sunset API
- 类别: Weather
- 提供者: Garrison Bates
- 订阅数: 1
- 免费: 是
- 流行度: 7.9
- 服务等级: 100%
- 延迟: 98ms
- 测试率: 57%
API概述
提供基于纬度、经度和可选高度的日出日落时间查询，包括以下指标：
- 日出
- 日落
- 日出结束
- 日落开始
- 黄金时段
- 黄金时段结束
- 夜晚
- 夜晚结束
- 太阳正午
- 最低点
- 黎明
- 黄昏
- 航海黎明
- 航海黄昏
端点
GET /api/get-sunrise-sunset
查询参数
| 参数 | 类型 | 必填 | 描述 | 示例 |
|---|---|---|---|---|
lat |
Number | 是 | 纬度 (-90 到 90) | 34.0522 |
lng |
Number | 是 | 经度 (-180 到 180) | -118.2437 |
date |
String | 否 | 日期 (YYYY-MM-DD)，默认为当天 (UTC) | 2025-05-08 |
height |
Number | 否 | 观察者海拔高度 (米) | 10 |
验证规则
lat必须在-90和90之间。lng必须在-180和180之间。date必须是有效的YYYY-MM-DD格式日期字符串。
响应
返回包含以下字段的JSON数据：
| 字段 | 描述 |
|---|---|
sunrise |
日出时间 (UTC) |
sunriseEnd |
日出结束时间 |
goldenHourEnd |
早晨黄金时段结束时间 |
solarNoon |
太阳正午时间 |
goldenHour |
傍晚黄金时段开始时间 |
sunsetStart |
日落开始时间 |
sunset |
日落时间 (UTC) |
dusk |
黄昏开始时间 |
nauticalDusk |
航海黄昏开始时间 |
night |
夜晚开始时间 |
nadir |
最暗时刻 (太阳正午的对立面) |
nightEnd |
夜晚结束时间 |
nauticalDawn |
航海黎明开始时间 |
dawn |
黎明开始时间 |
成功响应示例
json { "sunrise": "2025-05-08T12:01:00.000Z", "sunset": "2025-05-08T02:44:00.000Z", "solarNoon": "2025-05-08T19:22:00.000Z", "goldenHour": "2025-05-08T02:07:00.000Z", "goldenHourEnd": "2025-05-08T12:38:00.000Z", ... }
错误响应示例
json { "error": { "fieldErrors": { "lat": ["Invalid latitude: Must be between -90 and 90"], "date": ["Invalid date format"] } } }
使用示例
bash curl "https://yourapi.com/api/get-sunrise-sunset?lat=34.0522&lng=-118.2437&date=2025-05-08"
