CycleCalcs Astronomy API
收藏官方服务：
资源简介：
Interpreted astronomy, not raw coordinates: moon phase, sunrise and twilight, eclipses with visibility, planets, retrogrades and 28 endpoints, computed live for any date and place.
创建时间：
2026-08-06
原始信息汇总
CycleCalcs Astronomy API 数据集详情总结
一、数据集概述
CycleCalcs Astronomy API 是一个提供天文计算服务的应用程序编程接口，由 CycleCalcs 开发，隶属于科学（Science）类别。该 API 旨在回答用户实际提出的天文问题，而非仅仅提供原始坐标数据。它通过 28 个 GET 端点，提供解释性的天文学数据，如月相、日出日落、晨昏蒙影、日月食、行星位置等。所有计算结果均在请求时实时计算，支持从公元 1700 年到 2200 年间的任意日期和地球上的任意位置。
二、核心功能与数据内容
该 API 提供以下主要功能类别和端点：
| 功能类别 | 端点示例 | 功能描述 |
|---|---|---|
| 月球 | /v2/moon, /v2/phases, /v2/libration, /v2/moon-nodes |
月相名称、照明百分比、年龄、天平动、升落时间；月相日历、超级月亮分类；月球穿越黄道点及食季。 |
| 太阳与光 | /v2/sun, /v2/twilight, /v2/dark-window, /v2/sky-quality |
完整的太阳日（日出日落）、所有晨昏蒙影区间、夜间黑暗观测窗口、裸眼极限星等。 |
| 天文事件 | /v2/eclipses, /v2/seasons, /v2/apsides, /v2/conjunctions, /v2/retrogrades |
日月食及可见性、分至点、远地点/近地点、行星合、行星逆行。 |
| 位置 | /v2/positions, /v2/rise-set, /v2/separation |
所有天体的位置、任意天体的升中落、两目标间的角距。 |
| 行星 | /v2/planet-board, /v2/jupiter-moons |
一次请求获取八大行星信息、木星伽利略卫星及掩食事件。 |
| 时间 | /v2/time, /v2/sidereal-time, /v2/equation-of-time |
各类时间尺度、恒星时、均时差。 |
| 工具与元数据 | /v2/today, /v2/cycles, /v2/places, /v2/discovery, /v2/conventions, /v2/enums, /v2/attribution |
单一请求获取当前天空概况、天文周期状态、地名查询、接口文档、约定与限制、枚举值、数据来源。 |
三、数据特点与质量
- 实时计算：所有数据均在请求时实时计算，不使用查找表，确保精确到请求的特定时刻和地点。
- 高精度：数据在五个世纪（1700-2200）内可靠。
- 字段命名规范：每个字段的名称都包含其单位（如
illumination_percent,distance_km），响应会说明参考系、历元和折射模型。 - 错误处理：错误遵循 RFC 9457 标准，提供稳定的机器可读代码、提示和文档链接。
- 数据一致性：所有订阅计划获得的数据精度和内容完全一致，区别仅在于请求量。
四、数据格式与访问
- 支持格式：默认返回 JSON 格式，统一响应结构（
endpoint,data,links,meta）。支持通过format=csv参数导出 CSV 格式（适用于电子表格），部分端点支持format=txt纯文本格式。 - 性能优化：支持 ETag 和 304 状态码，实现缓存，减少不必要的数据传输。
- 批量查询：支持通过
start,end,step参数进行范围查询，如一次请求获取一年中的所有日食，或一个月中的日出时间。
五、使用方式
- 快速开始：订阅任何计划（BASIC 免费）后，通过 API 网关调用
/v2/moon端点，请求头需包含X-RapidAPI-Key和X-RapidAPI-Host。 - 公共参数：
at（指定时刻，默认当前）、start/end/step（范围查询）、lat/lon（十进制经纬度）或place（地名查询）、tz（本地时区）。 - 返回示例：例如请求月球数据，会返回月相名称、照明百分比、距离、升落时间、下一次月相变化及一段自然语言摘要。
六、订阅计划
该 API 提供以下订阅计划，所有计划均提供完整精度和日食数据，区别仅在于请求配额和速率限制：
| 计划名称 | 价格 | 每月配额 | 速率限制 |
|---|---|---|---|
| BASIC | $0 | 5,000 次/天 | 5 次/秒 |
| PRO | $5/月 | 500,000 次/月 | 10 次/秒 |
| ULTRA（推荐） | $9/月 | 800,000 次/月 | 20 次/秒 |
| MEGA | $15/月 | 1,000,000 次/月 | 33 次/秒 |
- 硬性限制：所有配额均为硬性限制，超出即拒绝请求，不会产生额外费用。
- 范围上限：付费计划会提高单次请求的范围上限（如 BASIC 计划单次可查询 366 天，MEGA 计划可达 3,660 天）。
七、其他信息
- 文档：完整的 API 参考文档可在
https://www.cyclecalcs.com/api/reference.html获取，错误目录在https://www.cyclecalcs.com/api/errors.html。 - API 创建者：CycleCalcs
- 订阅人数：1 位
- 所属类别：科学（Science）
