月亮
访问限制
本部分 API 属于增值服务,开发者 Token 需要额外开通权限,请联系商务
提供月升时间、月落时间以及月相数据。
API
bash
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] |
返回结构
json
{
"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 | 月相 |
---|---|
🌑 | 新月 |
🌒 | 眉月 |
🌓 | 上弦月 |
🌔 | 盈凸月 |
🌕 | 满月 |
🌖 | 亏凸月 |
🌗 | 下弦月 |
🌘 | 残月 |