三盘API文档 - 本命盘+太阳弧推运+行运盘

接口说明

本命盘+太阳弧推运+行运盘接口用于生成三层星盘的对比分析。内圈显示本命盘，中圈显示太阳弧推运盘，外圈显示行运盘，用于综合分析本命、太阳弧推运和当前行运的影响。

请求参数

参数名 类型 必填 说明
type1 String 是 第一层星盘类型，固定值："natal"
type2 String 是 第二层星盘类型，固定值："solararc"
type3 String 是 第三层星盘类型，固定值："transit"
data1 Object 是 本命盘数据（内圈）
data2 Object 是 太阳弧推运盘数据（中圈）
data3 Object 是 行运盘数据（外圈）
house_system String 是 宫位系统，例如："P"（普拉西德）
include_svg Boolean 否 是否包含SVG图像，默认true

data1、data2和data3的参数结构

参数名 类型 必填 说明
datetime String 是 日期时间，格式："YYYY-MM-DD HH:MM:SS"
lat Number 是 纬度，范围：-90到90
lon Number 是 经度，范围：-180到180
tz Number 是 时区偏移，例如：8.0（东八区）

请求示例

        {
        "type1": "natal",
        "type2": "solararc",
        "type3": "transit",
        "data1": {
        "datetime": "1990-01-01 12:00:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": 8.0
        },
        "data2": {
        "datetime": "2024-01-15 10:30:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": 8.0
        },
        "data3": {
        "datetime": "2024-12-25 15:00:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": 8.0
        },
        "house_system": "P",
        "include_svg": true
        }

返回参数

参数名 类型 说明
success Boolean 请求是否成功
data Object 星盘数据
data.type1 String 第一层星盘类型："natal"
data.type2 String 第二层星盘类型："solararc"
data.type3 String 第三层星盘类型："transit"
data.house_cusps Array 宫头位置数组（12个元素）
data.chart1_planets Object 本命盘行星位置数据
data.chart2_planets Object 太阳弧推运盘行星位置数据
data.chart3_planets Object 行运盘行星位置数据
svg String SVG格式的星盘图像（当include_svg为true时）
message String 响应消息

返回示例

        {
        "success": true,
        "data": {
        "type1": "natal",
        "type2": "solararc",
        "type3": "transit",
        "house_cusps": [0.0, 30.0, 60.0, 90.0, 120.0, 150.0, 180.0, 210.0, 240.0, 270.0, 300.0, 330.0],
        "chart1_planets": {
            "Sun": {"longitude": 280.123, "speed": 1.0},
            "Moon": {"longitude": 45.678, "speed": 13.2}
        },
        "chart2_planets": {
            "Sun": {"longitude": 314.456, "speed": 1.0},
            "Moon": {"longitude": 79.789, "speed": 13.1}
        },
        "chart3_planets": {
            "Sun": {"longitude": 275.123, "speed": 1.0},
            "Moon": {"longitude": 180.456, "speed": 13.3}
        }
        },
        "svg": "...",
        "message": "三盘计算成功"
        }

注意事项

  • 时间格式必须为 YYYY-MM-DD HH:MM:SS 或 YYYY-MM-DD HH:MM
  • 时区格式为数字，东时区为正数，西时区为负数
  • type1必须设置为"natal"，type2必须设置为"solararc"，type3必须设置为"transit"
  • data1为本命盘数据（内圈），data2为太阳弧推运盘数据（中圈），data3为行运盘数据（外圈）
  • 太阳弧推运盘使用太阳的移动弧度来推进所有行星和宫头
  • 行运盘显示指定时间的实际天体位置
  • 三个时间点通常为：出生时间、推运时间、当前时间
  • 返回的行星位置包含经度和速度信息