二次推运

计算二次推运（也称为"一天等于一年"推运）。出生后每一天对应生命中的一年，创建一个随时间缓慢演变的推运盘。

所需模块

需要 progression:calc 模块。

计算推运

curl -X POST "https://api.astroapi.cloud/api/calc/progressions" \
  -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"
    },
    "targetDate": "2024-06-15T12:00",
    "houseSystem": "placidus",
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

参数

参数	类型	必填	描述
birthDateTime	string	是	出生日期和时间，格式为 YYYY-MM-DDTHH:mm
birthLocation	object	是	出生地点（经度、纬度、时区）
targetDate	string	是	推运目标日期，格式为 YYYY-MM-DDTHH:mm
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": {
        "progressedDate": "2024-06-15T12:00",
        "natalDate": "1990-06-15T14:30",
        "targetDate": "2024-06-15T12:00",
        "aspects": [
            {
                "point1": "sun",
                "point2": "moon",
                "aspect": "sextile",
                "orb": 1.2,
                "applying": true
            }
        ],
        "aspectsToNatal": [
            {
                "point1": "moon",
                "point2": "sun",
                "aspect": "conjunction",
                "orb": 0.4,
                "applying": false,
                "text": "Progressed Moon conjunct natal Sun marks a significant personal turning point..."
            }
        ],
        "points": {
            "sun": {
                "longitude": 108.3,
                "latitude": 0.0,
                "sign": "cancer",
                "house": 10,
                "retrograde": false
            },
            "moon": {
                "longitude": 108.7,
                "latitude": -1.5,
                "sign": "cancer",
                "house": 10,
                "retrograde": false
            },
            "mercury": {
                "longitude": 95.1,
                "latitude": 0.8,
                "sign": "cancer",
                "house": 9,
                "retrograde": true
            }
        },
        "natalPoints": {
            "sun": {
                "longitude": 84.5,
                "latitude": 0.0,
                "sign": "gemini",
                "house": 10,
                "retrograde": false
            }
        },
        "houses": {
            "1": { "cusp": 180.5, "sign": "libra" },
            "10": { "cusp": 84.5, "sign": "gemini" }
        },
        "charts": {
            "biWheel": {
                "title": "Progressed / Natal Bi-wheel",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "progressed": {
                "title": "Progressed Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "natal": {
                "title": "Natal Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            }
        }
    }
}

响应字段

字段	类型	描述
progressedDate	string	星盘推运到的日期
natalDate	string	原始出生日期和时间
targetDate	string	请求中提供的目标日期
aspects	array	推运行星之间的相位（推运盘内部）
aspectsToNatal	array	推运行星与本命行星之间的相位
points	object	推运行星位置
natalPoints	object	供参考的本命行星位置
houses	object	推运宫位起点
charts.biWheel	object	推运盘叠加在本命盘上的双轮盘图像 URL
charts.progressed	object	独立推运盘图像 URL
charts.natal	object	本命盘图像 URL

理解二次推运

二次推运使用一天等于一年的象征公式。要找到 34 岁时的推运盘（出生后 34 年），即使用出生日期后 34 天的星历表位置。

推运月亮

推运月亮是所有推运点中移动最快的，大约每 2.5 年换一次星座。它是最常追踪的推运点，提供对当前情感主题的洞察。

推运太阳

推运太阳每年移动约一度。推运太阳换星座是一个重要的人生事件，大约每 30 年发生一次。

推运与本命相位

aspectsToNatal 数组显示推运盘与本命盘之间的相位。这些是推运预测中使用的主要指标：

{
    "point1": "moon",
    "point2": "sun",
    "aspect": "conjunction",
    "orb": 0.4,
    "applying": false,
    "text": "Progressed Moon conjunct natal Sun marks a significant personal turning point..."
}

容许度小（1 度以内）的相位通常最为重要。入相位（趋向精确）显示即将到来的主题，而出相位则显示正在消退的能量。