遇见数据集

Moon Phase: Exact Instants & Moonrise by Coordinates

收藏
RapidAPI2026-08-15 更新2026-08-17 收录
官方服务:

资源简介:

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.

创建时间:
2026-08-15
原始信息汇总

数据集详情总结

数据集概述

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_windowabove_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参数表示当前时刻)不缓存。

二维码
社区交流群
二维码
科研交流群
商业服务