天文数据 API

日出日落、月相、黄金/蓝色时刻与日月位置等专业天文信息，适用于摄影规划、文旅日历与户外体验类应用（进阶订阅产品）。

产品概述

华风爱科天文数据帮助您的应用呈现日出日落、月升月落、月相变化，以及摄影爱好者关注的黄金时刻与蓝色时刻等专业天文信息。本产品为进阶订阅能力，面向对天文与户外体验有更高要求的行业客户。适用于天文日历、摄影助手、文旅内容运营与户外提醒等场景。由中国气象局授权品牌与 AccuWeather 全球数据能力提供支撑。

  • ✓天文实况： 掌握当前日月位置与月相概况
  • ✓天文逐日： 日出日落、黎明黄昏、日照时长与月相周期
  • ✓天文逐小时： 整点日月高度与方位，便于轨迹与动画展示
  • ✓典型场景： 摄影规划、天文日历、平板大屏、移动端提醒
产品展示

基于天文数据可以构建的应用示例

Tablet华风爱科天文 API 平板端月相与日出日落展示示例

平板应用

iPad/Android平板优化的天文应用，直观展示日出日落、月相变化等天文景象

动态月相天文日历大屏适配
iOS/Android华风爱科 astronomy 天文数据移动端摄影助手示例

移动端APP

随身天文助手，实时掌握日落月升，助力摄影规划与天文观测

实时提醒触控优化便捷搜索

快速开始

  1. 天文数据为进阶订阅能力，标准测试 Key 无法调用；请注册账号后联系商务开通权限。
  2. 调用前需通过 定位搜索 API 获取地点标识（Location Key），并在请求中传入。
  3. 产品提供实况、逐日、逐小时三种能力形态，下表列出主要请求参数与返回能力说明。

进阶能力接口

⚠️ 本能力为进阶订阅产品，标准测试 Key 无法调用。请先注册开发者账号，再通过商务咨询或开发者后台了解开通方案；完整对接文档在签约后单独提供。
GET 天文实况 进阶
完整 URL 与参数说明在开通权限后，于开发者后台或商务交付文档中提供。
GET 天文逐日 进阶
完整 URL 与参数说明在开通权限后，于开发者后台或商务交付文档中提供。
GET 天文逐小时 进阶
完整 URL 与参数说明在开通权限后，于开发者后台或商务交付文档中提供。

请求参数

下表为各接口通用及可选查询参数；requestDate、days 主要用于逐日/逐小时查询范围。

参数名 类型 必填 默认值 说明 示例
apikey String 是 - 用以在 API 里验证与授权使用的用户密钥 YOUR_API_KEY
version String 是 v1 当前 API 版本 v1
locationkey String 是 - 指定地点的唯一标识，由定位搜索 API 返回 57465
format String 否 JSON 响应格式 JSON
requestDate String 否 - 查询范围起始时间，格式：YYYYMMDDHHm（UTC） 20240523034
days String 否 - 要查询的天数（逐日/逐小时） 2

天文实况返回

能力项 包含内容 说明 数据形式示例
实时时间信息 - 数据对应的实时时间 2024-05-20T10:10:02+08:00
太阳实时位置 高度角 / 方位角 太阳实时空间位置 数值型（含角度单位）
  方位角（中文） 太阳方位中文描述 119° 东东南
  地日距离 地球与太阳实时距离 数值型（含距离单位）
月球实时位置 高度角 / 方位角 月球实时空间位置 数值型（含角度单位）
  方位角（中文） 月球方位中文描述 17° 北东北
  地月距离 地球与月球实时距离 数值型（含距离单位）
  月相 / 发光占比 实时月相及月球发光部分百分比 盈凸月 / 88.4%

天文逐日返回

能力项 包含内容 说明 数据形式示例
日期信息 - 数据对应的目标日期 2024-05-23
太阳全时段信息 日出 / 日落时间 当日核心日出日落时刻 04:53 / 19:30
  黎明 / 黄昏各阶段 天文 / 航海 / 民用黎明与黄昏时刻 2:58（天文黎明）等
  黄金 / 蓝色时刻 摄影级黄金 / 蓝色黎明与黄昏时段 4:52–5:32（黄金黎明）等
  日照 / 夜晚时长 当日日照总时长、夜晚总时长 14 小时 37 分 / 9 小时 23 分
月球全时段信息 月出 / 月落时间 当日月出月落时刻 19:31 / 次日 04:48
  月相 / 月龄 当日月相及离上一次新月天数 满月 / 15 天
天文周期信息 满月 / 新月间隔 距离下次满月 / 新月的自然日数 距离下次满月 14 天

天文逐小时返回

能力项 包含内容 说明 数据形式示例
小时级时间 - 数据对应的整点时间 2024-05-23T12:00:00+08:00
太阳小时级位置 高度角 / 方位角 该整点太阳高度角与方位角 数值型（含角度单位）
  方位角（中文） 该整点太阳方位中文描述 119° 东东南
  地日距离 该整点地日实时距离 数值型（含距离单位）
月球小时级位置 高度角 / 方位角 该整点月球高度角与方位角 数值型（含角度单位）
  方位角（中文） 该整点月球方位中文描述 17° 北东北
  地月距离 该整点地月实时距离 数值型（含距离单位）