Sunrise Sunset API

Look up the sunrise and sunset by latitude and longitude

原始信息汇总

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"

搜集汇总

背景与挑战

背景概述

Sunrise Sunset API 是一个数据集，提供基于经纬度查询日出和日落时间的功能。它允许用户通过坐标获取相关的天文时间信息。