月亮

访问限制

本部分 API 属于增值服务，仅提供给企业套餐开发者，如需采购请联系彩云商务

提供月升时间、月落时间、月相以及逐小时高度角和方位角数据。

月升月落

• 认证与鉴权 | 错误信息

curl "https://singer.caiyunhub.com/v3/astro/moon?longitude=116&latitude=39&lang=zh-Hans&days=15&token={token}"

参数说明：

参数	类型	可选	默认值	含义
longitude	float	✅	0.0	经度
latitude	float	✅	0.0	纬度
lang	enum	✅	zh-Hans	语言参数，具体可以参见 多语言支持
days	int	✅	3	多少天，支持范围 [1, 15]

返回结构：

{
  "moon": [
    {
      "date": "2022-05-20",
      "rise": "22:48",
      "set": "10:09",
      "phase": 233.22,
      "phase_name": "亏凸月"
    },
    {
      "date": "2022-05-21",
      "rise": "23:45",
      "set": "11:08",
      "phase": 246.7,
      "phase_name": "亏凸月"
    },
    {
      "date": "2022-05-22",
      "rise": "-",
      "set": "12:03",
      "phase": 259.84,
      "phase_name": "下弦月"
    }
  ]
}

字段	类型	描述
date	string	日期
rise	string	升起时间，如果没有升起则是 -
set	string	落下时间，如果没有落下则是 -
phase	float
phase_name	enum	月相名称

简体中文环境下支持的月相可能取值：

Emoji	月相
🌑	新月
🌒	眉月
🌓	上弦月
🌔	盈凸月
🌕	满月
🌖	亏凸月
🌗	下弦月
🌘	残月

月亮高度/方位角

提供逐小时的月亮高度角和方位角数据。

• 认证与鉴权 | 错误信息

curl "https://singer.caiyunhub.com/v3/astro/moon/location?longitude=116&latitude=39&dailystart=-1&days=2&token={token}"

参数说明：

参数	类型	可选	默认值	含义
longitude	float	✅	0.0	经度
latitude	float	✅	0.0	纬度
dailystart	int	✅	0	起始天数偏移，仅支持 -1（从昨天开始）
days	int	✅	1	天数，支持范围 [1, 2]

返回结构：

{
  "data": [
    { "timestamp": 1769468400, "altitude": 21.5018, "azimuth": 268.0806 },
    { "timestamp": 1769472000, "altitude": 18.6872, "azimuth": 282.1501 },
    // ...
    { "timestamp": 1769637600, "altitude": 35.81, "azimuth": 225.1094 }
  ]
}

字段	类型	描述
timestamp	int	时间戳
altitude	float	高度角
azimuth	float	方位角