双盘API文档 - 本命盘vs行运盘

接口说明

本命盘vs行运盘接口用于生成本命盘与行运盘的对比星盘。内圈显示本命盘，外圈显示指定时间的行运盘位置，用于分析行运对本命盘的影响。

请求参数

参数名 类型 必填 说明
chart_type String 是 双盘类型，固定值："transit"
data1 Object 是 本命盘数据（内圈）
data2 Object 是 行运盘数据（外圈）
house_system String 是 宫位系统，例如："P"（普拉西德）
include_svg Boolean 否 是否包含SVG图像，默认true

data1和data2的参数结构

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

请求示例

        {
        "chart_type": "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
        },
        "house_system": "P",
        "include_svg": true
        }

返回参数

参数名 类型 说明
success Boolean 请求是否成功
data Object 星盘数据
data.chart_type String 双盘类型："transit"
data.house_cusps Array 宫头位置数组（12个元素）
data.chart1_planets Object 本命盘行星位置数据
data.chart2_planets Object 行运盘行星位置数据
svg String SVG格式的星盘图像（当include_svg为true时）
message String 响应消息

返回示例

        {
        "success": true,
        "data": {
        "chart_type": "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": 295.456, "speed": 1.0},
            "Moon": {"longitude": 120.789, "speed": 13.1}
        }
        },
        "svg": "...",
        "message": "双盘计算成功"
        }

注意事项

  • 时间格式必须为 YYYY-MM-DD HH:MM:SS 或 YYYY-MM-DD HH:MM
  • 时区格式为数字，东时区为正数，西时区为负数
  • chart_type必须设置为"transit"
  • data1为本命盘数据（内圈），data2为行运盘数据（外圈）
  • 行运盘通常使用与本命盘相同的地理位置
  • 返回的行星位置包含经度和速度信息