Moon Phase: Exact Instants & Moonrise by Coordinates
收藏资源简介:
The exact minute of every New Moon, First Quarter, Full Moon and Last Quarter — not the day — plus moonrise, transit and moonset for any coordinates with their azimuth, and a whole month of either in one call. Pure astronomical computation with the algorithm, its accuracy and the delta-T used published in every response.
数据集详情总结
数据集概述
Moon Phase: Exact Instants & Moonrise by Coordinates 是一个基于纯天文学计算的数据集/API,旨在提供精确的月相时刻(精确到分钟)以及指定坐标下的月出、月中天和月落时间。该API不依赖任何上游服务、外部数据集或许可证,所有计算均在进程内基于Jean Meeus的《Astronomical Algorithms》(第2版)中的已发表算法完成。
核心功能
- 精确月相时刻:提供新月、上弦月、满月、下弦月四个相位在UTC分钟级别的精确发生时刻,支持按月份或整年查询。每个时刻附带Brown朔望月编号及该时刻月球的真实距离。
- 月出/月落信息:根据用户提供的坐标(经纬度)和固定UTC偏移量,返回月出、月中天和月落的本地墙钟时间,以及出没方位角和过中天高度角。
- 批量查询:一次调用可获取长达62天的月出月落数据,大大减少请求次数(一个月仅需1次请求)。
- 任意时刻月球状态:可查询任一时刻的月球照明比例、相位角、距角、月龄(从精确上一次新月算起)、距离、视直径、黄道及赤道坐标、亮缘位置角等。
- 年度满月数据:返回一年中每个满月的真实距离、年度最近与最远满月、蓝月及传统历书名称。
使用场景
适用于天文学教育、历法应用开发、天文观测规划、摄影计划等需要精确月相时刻或具体地点月出月落时间的场景。
数据精度与验证
- 每个响应都包含算法名称、使用的delta-T值(TT−UT)和精度声明。
- 与两个独立权威目录(美国海军天文台USNO和Fred Espenak表)进行过验证:2026年全部50个相位时刻,两个目录均与API结果在1分钟内一致(50/50);月出、月中天、月落与USNO历书在12个地点的36个现象全部精确到分钟一致。
- 明确承诺精度为±1分钟,不提供秒级精度,因为方法本身在考虑delta-T不确定性后不支持更精细的分辨率。
数据特点与限制
- 不包含:近地点和远地点时刻(因无法诚实计算到分钟精度)、任意时区数据库(仅接受固定UTC偏移)、地平线高度模型(默认海平面、标准34角分大气折射、上边缘、平坦无障碍物)。
- 特殊处理:当某天月球不升起或不落下时,返回
null值和机器可读的原因说明(如no_rise_in_window、above_horizon_all_window等),而非编造时间。 - 坐标系:经度采用ISO 6709标准(东经为正),方位角从北向东计算(0°北、90°东、180°南、270°西)。
- 数据范围:支持1900年至2100年。
订阅方案
| 方案 | 价格 | 每月请求数 |
|---|---|---|
| BASIC(免费) | $0.00/月 | 500次 |
| PRO | $9.90/月 | 25,000次 |
| ULTRA | $24.90/月 | 150,000次 |
| MEGA | $49.90/月 | 500,000次 |
所有方案均为硬性月度上限,超额不额外收费;免费方案无需绑定信用卡。
错误处理
API统一返回JSON格式的错误对象{"error": {"code", "message"}}。常见状态码包括:
- 400:参数格式错误或超出范围(消息会明确指出出错的字段)
- 404:未知路由
- 429:达到套餐配额上限
由于不依赖上游服务,该API不存在503状态码。对于固定日期星历数据,响应带有Cache-Control: public, max-age=31536000, immutable头,而/v1/moon/phase(无datetime参数表示当前时刻)不缓存。



