GeoAstroApi

High‑precision astronomy REST API for sunrise/sunset, Moon phases, planet visibility, golden hour and blue hour — built for photographers, app developers and astronomy enthusiasts.

原始信息汇总

GeoAstroApi 数据集概述

基本信息

• 数据集名称: GeoAstroApi
• 提供方: LittleCake Media
• 类别: Science
• API版本: 1.0.3 (current)
• 访问平台: RapidAPI
• 服务等级: 100%
• 平均延迟: 234ms
• 流行度评分: 9.2

核心描述

GeoAstro API 是一个高精度天文学 REST API，为任何地点和日期提供专业级的太阳、月亮和行星数据。它返回准确的升起、落下和中天过境时间，民用/航海/天文曙暮光，黄金时段和蓝色时段间隔，以及详细的月相、照明度、亮边方向和每日/每月天文日历。所有响应都具有时区感知能力，支持海平面或自定义观测者海拔高度，并以简洁的 JSON 格式返回。

主要功能

太阳数据

• 日出和日落时间
• 民用、航海和天文曙暮光
• 太阳中天过境（上中天和下中天）
• 视太阳位置（方位角和高度角）
• 黄金时段和蓝色时段间隔
• 指定时区的完整每日太阳摘要

月亮数据

• 月出和月落
• 月球中天过境
• 视月球位置（方位角和高度角）
• 照明比例
• 相位角、相位ID和相位名称
• 即将到来的主要月相（新月、弦月、满月）
• 亮边角度（用于正确定向月球图形）
• 指定时区的完整每日月球摘要

行星数据

• 选定行星在给定日期的升起、落下和中天过境时间
• 特定时刻行星的视方位角和高度角
• 行星的每日可见性窗口和定性可见性评分
• 支持的行星列表及其内部标识符

季节数据

• 给定年份的二分点和二至点日期和时间

日历数据

• 结合太阳和月亮关键事件的每日天文日历
• 特定日期的黄金时段和蓝色时段日历
• 太阳事件的月度日历（日出、日落、曙暮光）
• 月相、月出和月落的月度日历

坐标系与约定

• 方位角以度表示：0° = 北，90° = 东，180° = 南，270° = 西
• 高度角为真地平线以上的视高度角（度）
• 时间戳始终为 Unix 时间戳（秒，UTC）
• 每日摘要使用提供的 IANA 时区来确定“今天”的含义

端点概览

太阳端点

• GET /v1/sun/position: 给定时刻的视太阳方位角和高度角
• GET /v1/sun/transits: 一天的日出、日落、曙暮光和中天过境
• GET /v1/sun/summary: 位置和本地日的完整太阳概览

月亮端点

• GET /v1/moon/illumination: 月球的照明比例
• GET /v1/moon/transits: 月出、月落和中天过境
• GET /v1/moon/position: 视月球方位角和高度角
• GET /v1/moon/phase-angle: 带有相位ID和名称的相位角
• GET /v1/moon/info: 照明和相位信息的组合
• GET /v1/moon/bright-limb-angle: 照明边缘的方向角
• GET /v1/moon/next-phases: 即将到来的主要月相（约30天）
• GET /v1/moon/summary: 位置的完整月球每日摘要

行星端点

• GET /v1/planet/transits: 选定行星在给定日期的升起、落下和中天过境时间
• GET /v1/planet/position: 特定时刻行星的视方位角和高度角
• GET /v1/planet/visibility/daily: 行星的每日可见性窗口和定性可见性评分
• GET /v1/planet/list: 支持的行星列表及其内部标识符

季节端点

• GET /v1/seasonal/seasons: 给定年份的二分点和二至点日期和时间

日历端点

• GET /v1/calendar/daily: 结合太阳和月亮关键事件的每日天文日历
• GET /v1/calendar/golden-blue: 特定日期的黄金时段和蓝色时段日历
• GET /v1/calendar/monthly-sun: 太阳事件的月度日历（日出、日落、曙暮光）
• GET /v1/calendar/monthly-moon: 月相、月出和月落的月度日历

订阅计划与功能可用性

所有 GeoAstro API 端点在所有计划中都可用。由于其显著更高的计算成本，每日摘要和月度日历端点仅在 PRO 和 ULTRA 计划中可用。

计划定价

• BASIC: $0.00 / 月
• PRO: $19.00 / 月
• ULTRA: $39.00 / 月
• MEGA: $69.00 / 月

端点可用性表

端点	FREE	BASIC	PRO	ULTRA
Sun
/v1/sun/position	✅	✅	✅	✅
/v1/sun/transits	✅	✅	✅	✅
/v1/sun/summary	❌	❌	✅	✅
Moon
/v1/moon/illumination	✅	✅	✅	✅
/v1/moon/transits	✅	✅	✅	✅
/v1/moon/position	✅	✅	✅	✅
/v1/moon/phase-angle	✅	✅	✅	✅
/v1/moon/info	✅	✅	✅	✅
/v1/moon/bright-limb-angle	✅	✅	✅	✅
/v1/moon/next-phases	✅	✅	✅	✅
/v1/moon/summary	❌	❌	✅	✅
Planets
/v1/planet/transits	✅	✅	✅	✅
/v1/planet/position	✅	✅	✅	✅
/v1/planet/visibility/daily	✅	✅	✅	✅
/v1/planet/list	✅	✅	✅	✅
Seasons
/v1/seasonal/seasons	✅	✅	✅	✅
Calendar
/v1/calendar/daily	✅	✅	✅	✅
/v1/calendar/golden-blue	✅	✅	✅	✅
/v1/calendar/monthly-sun	❌	❌	✅	✅
/v1/calendar/monthly-moon	❌	❌	✅	✅

错误处理

所有错误都遵循一致的 JSON 格式。常见的 HTTP 状态码包括：

• 400: 参数无效或缺失
• 401: 直接访问被阻止（请求必须通过 RapidAPI 路由）
• 500: 内部服务器错误

典型用例

• 天文学和观星应用
• 太阳和月亮日历
• 摄影规划工具
• 天气仪表板
• 智能家居或物联网日光自动化
• 教育性天文学软件
• 月相小部件和手表应用

搜集汇总

背景与挑战

背景概述

该数据集提供了一系列天文地理数据API接口，包括行星位置、月相角度、太阳活动等信息的查询功能，适用于科学计算和天文研究场景。