太阳回归与月亮回归

计算太阳回归（生日盘）和月亮回归星盘。回归盘显示行星回归到其本命位置那一刻的行星位置，为未来一年或一个月提供预测洞察。

---

太阳回归

太阳回归盘是在太阳每年回归到其本命度数的精确时刻计算的，这通常发生在生日前后。它用于预测未来一年的主题。

所需模块

需要 solar-return:calc 模块。

curl -X POST "https://api.astroapi.cloud/api/calc/solar-return" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDateTime": "1990-06-15T14:30",
    "birthLocation": {
      "longitude": -0.1278,
      "latitude": 51.5074,
      "timezone": "Europe/London"
    },
    "returnYear": 2024,
    "houseSystem": "placidus",
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

参数

参数	类型	必填	描述
birthDateTime	string	是	出生日期和时间，格式为 YYYY-MM-DDTHH:mm
birthLocation	object	是	出生地点（见下方地点对象）
returnYear	number	否	太阳回归的年份（默认：当前年份）
houseSystem	string	否	宫位系统（默认："placidus"）
language	string	否	文本内容的语言代码（默认："en"）
includeText	boolean	否	包含解读文本（默认：false）
includeReadableEntities	boolean	否	包含人类可读的实体标题（默认：false）
points	array	否	计算中包含的天体点
orbs	object	否	每种相位类型的自定义容许度值

地点对象

{
    "longitude": -0.1278,
    "latitude": 51.5074,
    "timezone": "Europe/London"
}

响应

{
    "data": {
        "returnYear": 2024,
        "returnDate": "2024-06-15T08:42:17Z",
        "aspects": [
            {
                "point1": "sun",
                "point2": "moon",
                "aspect": "trine",
                "orb": 1.8,
                "applying": false
            }
        ],
        "points": {
            "sun": {
                "longitude": 84.71,
                "latitude": 0.0,
                "sign": "gemini",
                "house": 10,
                "retrograde": false
            },
            "moon": {
                "longitude": 324.15,
                "latitude": -2.3,
                "sign": "aquarius",
                "house": 6,
                "retrograde": false
            }
        },
        "houses": {
            "1": { "cusp": 195.4, "sign": "libra" },
            "10": { "cusp": 84.5, "sign": "gemini" }
        },
        "charts": {
            "solarReturn": {
                "title": "Solar Return Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "biWheel": {
                "title": "Solar Return / Natal Bi-wheel",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "natal": {
                "title": "Natal Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            }
        }
    }
}

响应字段

字段	类型	描述
returnYear	number	太阳回归的年份
returnDate	string	太阳回归的精确 UTC 时刻
aspects	array	太阳回归盘内的相位
points	object	太阳回归盘中的行星位置
houses	object	太阳回归盘的宫位起点
charts.solarReturn	object	太阳回归盘图像 URL
charts.biWheel	object	太阳回归盘叠加在本命盘上的双轮盘
charts.natal	object	本命盘图像 URL

---

月亮回归

月亮回归盘是在月亮每月回归到其本命度数的精确时刻计算的（大约每 27.3 天一次）。它用于预测未来一个月的主题。

所需模块

需要 lunar-return:calc 模块。

curl -X POST "https://api.astroapi.cloud/api/calc/lunar-return" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDateTime": "1990-06-15T14:30",
    "birthLocation": {
      "longitude": -0.1278,
      "latitude": 51.5074,
      "timezone": "Europe/London"
    },
    "returnDate": "2024-06-01",
    "houseSystem": "placidus",
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

参数

参数	类型	必填	描述
birthDateTime	string	是	出生日期和时间，格式为 YYYY-MM-DDTHH:mm
birthLocation	object	是	出生地点（经度、纬度、时区）
returnDate	string	否	从此日期（YYYY-MM-DD）开始查找下一次月亮回归（默认：现在）
houseSystem	string	否	宫位系统（默认："placidus"）
language	string	否	文本内容的语言代码（默认："en"）
includeText	boolean	否	包含解读文本（默认：false）
includeReadableEntities	boolean	否	包含人类可读的实体标题（默认：false）
points	array	否	计算中包含的天体点
orbs	object	否	每种相位类型的自定义容许度值

响应

{
    "data": {
        "returnDate": "2024-06-12T03:18:44Z",
        "aspects": [
            {
                "point1": "moon",
                "point2": "venus",
                "aspect": "sextile",
                "orb": 0.9,
                "applying": true
            }
        ],
        "points": {
            "moon": {
                "longitude": 245.2,
                "latitude": -3.1,
                "sign": "sagittarius",
                "house": 4,
                "retrograde": false
            }
        },
        "houses": {
            "1": { "cusp": 130.8, "sign": "leo" },
            "4": { "cusp": 240.5, "sign": "sagittarius" }
        },
        "charts": {
            "lunarReturn": {
                "title": "Lunar Return Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "biWheel": {
                "title": "Lunar Return / Natal Bi-wheel",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "natal": {
                "title": "Natal Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            }
        }
    }
}

响应字段

字段	类型	描述
returnDate	string	月亮回归的精确 UTC 时刻
aspects	array	月亮回归盘内的相位
points	object	月亮回归盘中的行星位置
houses	object	月亮回归盘的宫位起点
charts.lunarReturn	object	月亮回归盘图像 URL
charts.biWheel	object	月亮回归盘叠加在本命盘上的双轮盘
charts.natal	object	本命盘图像 URL

---

宫位系统

两个端点均支持与本命盘计算相同的宫位系统：

值	名称
placidus	Placidus（默认）
koch	Koch
equal	等宫制
whole	整体星座宫位制
campanus	Campanus
regiomontanus	Regiomontanus
porphyry	Porphyry

回归盘的地点

许多占星师使用回归时当事人实际所在的地点，而非出生地点。如果您希望使用与地点相关的回归盘，请在 birthLocation 中传入当前居住地或旅行地点。