太阳

访问限制

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

提供日出日落时间以及逐小时高度角和方位角数据。

日出日落

• 认证与鉴权 | 错误信息

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

参数说明：

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

返回结构：

{
  "data": [
    {
      "date": "2026-01-27",
      "rise": "07:21",
      "set": "17:26",
      "astronomical_dawn_start": "05:30",
      "astronomical_dusk_end": "19:17",
      "civil_dawn_start": "06:52",
      "civil_dusk_end": "17:55",
      "nautical_dawn_start": "06:12",
      "nautical_dusk_end": "18:35",
      "solar_midnight": "00:23",
      "solar_noon": "12:23"
    }
    // ...
  ]
}

字段	类型	描述
date	string	日期
rise	string	日出时间，如果没有则是 -
set	string	日落时间，如果没有则是 -
astronomical_dawn_start	string	天文曙光开始，如果没有则是 -
astronomical_dusk_end	string	天文昏影结束，如果没有则是 -
civil_dawn_start	string	民用曙光开始，如果没有则是 -
civil_dusk_end	string	民用昏影结束，如果没有则是 -
nautical_dawn_start	string	航海曙光开始，如果没有则是 -
nautical_dusk_end	string	航海昏影结束，如果没有则是 -
solar_midnight	string	太阳子夜，如果没有则是 -
solar_noon	string	太阳正午，如果没有则是 -

太阳高度/方位角

提供逐小时的太阳高度角和方位角数据。

• 认证与鉴权 | 错误信息

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

参数说明：

参数	类型	可选	默认值	含义
longitude	float	✅	0.0	经度
latitude	float	✅	0.0	纬度
days	int	✅	1	天数，支持范围 [1, 2]

返回结构：

{
  "data": [
    { "timestamp": 1671638400, "altitude": -74.1515, "azimuth": 348.0473 },
    // ...
    { "timestamp": 1671721200, "altitude": -67.8016, "azimuth": 309.0398 }
  ]
}

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