单盘接口通用参数说明

其他参数

请求示例

示例1：使用动态天体配置

{
    "chart_type": "transit",
    "data": {
        "datetime": "1990-06-15 14:30:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": 8
    },
    "dynamic_planet_config": {
        "level": "custom",
        "custom_planets": ["default", "-PLUTO", "-URANUS"],
        "custom_asteroids": [17],
        "custom_arabic_parts": ["AP0001", "AP0002"]
    },
    "include_fixed_star": "default",
    "fixed_stars_in_svg": "conjunct",
    "include_analysis": true,
    "include_svg": true
}

示例2：完整配置（所有参数）

{
    "chart_type": "natal",
    "data": {
        "datetime": "1990-01-01 12:00:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": 8
    },
    "house_system": "P",
    "dynamic_planet_config": {
        "level": "modern_complete",
        "custom_arabic_parts": ["AP0001", "AP0002", "AP0004", "AP0005"]
    },
    "include_fixed_star": "default",
    "fixed_stars_in_svg": ["conjunction", "opposition"],
    "include_analysis": true,
    "aspect_scheme": "transit",
    "house_ruler_system": "modern",
    "include_fixed_star_aspects": true,
    "orb_scheme": "default",
    "custom_orbs": {
        "aspects": {
            "conjunction": 8.0,
            "opposition": 8.0,
            "trine": 6.0,
            "square": 6.0,
            "sextile": 4.0
        },
        "planets": {
            "SUN": 1.5,
            "MOON": 1.5
        },
        "fixed_stars": {
            "magnitude_1": 6.0,
            "magnitude_2": 5.0
        }
    },
    "include_svg": true,
    "chart_style": "standard",
    "display_aspects": ["conjunction", "opposition", "trine", "square", "sextile"],
    "use_chinese_font": false,
    "theme": "light"
}

示例3：完整阿拉伯点配置

{
    "chart_type": "natal",
    "data": {
        "datetime": "1990-01-01 12:00:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": 8
    },
    "dynamic_planet_config": {
        "level": "modern_standard",
        "custom_arabic_parts": [
            "AP0001", "AP0002", "AP0003", "AP0004", "AP0005", 
            "AP0006", "AP0007", "AP0008", "AP0009", "AP0100"
        ]
    },
    "include_fixed_star": "essential",
    "include_analysis": true,
    "include_svg": true,
    "chart_style": "standard"
}

说明：使用现代标准行星配置 + 10个常用阿拉伯点 + 核心恒星，适合详细分析。

示例4：极简SVG（不嵌入字体，无颜色，前端动态渲染）

{
    "chart_type": "natal",
    "data": {
        "datetime": "1990-01-01 12:00:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": 8
    },
    "include_svg": true,
    "minimal_svg": true
}

说明：返回的SVG不包含嵌入字体和颜色填充，文字使用系统sans-serif字体，所有fill属性为none，stroke为黑色。 前端可通过JS动态设置颜色和加载自定义字体，适合需要动态切换样式的场景。SVG体积从约38KB降至约14KB。

示例5：自定义颜色和字体大小

{
    "chart_type": "natal",
    "data": {
        "datetime": "1990-01-01 12:00:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": 8
    },
    "include_svg": true,
    "theme": "light",
    "use_chinese_font": true,
    "custom_colors": {
        "line_color": "#ff0000",
        "zodiac_ring_fill": "#00ff00",
        "axis_line_color": "#0000ff"
    },
    "custom_config": {
        "zodiac_font_size": 40,
        "chinese_zodiac_font_size": 36,
        "planet_size": 40,
        "chinese_planet_size": 28,
        "house_number_font_size": 18,
        "chinese_house_number_font_size": 16
    },
    "svg_radius_config": {
        "base_radius": 350,
        "radius_factors": {
            "zodiac_inner": 0.85,
            "planet_symbol": 0.65
        }
    }
}

说明：使用中文占星符号字体，自定义颜色覆盖主题颜色，自定义字体大小覆盖默认值，自定义半径倍数调整星盘布局。

注意事项

• 动态天体配置：推荐使用 dynamic_planet_config 参数进行天体配置，支持减法语法和完全自定义
• 恒星计算：恒星通过 include_fixed_star 参数计算，支持多种预设方案和自定义列表
• 阿拉伯点：阿拉伯点会同时出现在 arabic_parts 和 planets 数据中，便于统一处理
• 阿拉伯点编号系统：使用AP编号（如AP0001=福点, AP0004=爱情点, AP0005=婚姻点），系统支持400+个阿拉伯点
• SVG显示控制：fixed_stars_in_svg 控制SVG中显示哪些恒星，智能默认为只显示有合相的恒星
• 相位计算：即使 include_analysis=false，如果请求了SVG，相位也会被计算用于绘图
• 容许度方案：
  • default: 相位容许度 + 行星容许度之和
  • xingguang: 星光容许度（行星容许度的平均值）
• 向后兼容：支持旧的参数格式，如 custom_aspect_orbs 会自动转换为 custom_orbs.aspects
• 数据过滤：返回的JSON数据会根据动态配置自动过滤，确保与SVG显示一致
• 性能考虑：计算恒星、阿拉伯点和详细分析会增加计算时间，按需使用
• 主题支持：支持多种主题（light, dark, classic等），影响SVG的颜色和样式
• 交互式接口：除了标准的 /onechart 接口，还提供 /onechart_interactive 接口，返回额外的坐标数据用于前端交互

返回数据结构说明

坐标数据结构（include_coordinates=true时返回）

当 include_coordinates 参数为 true 时，返回数据中会包含 coordinates 字段，提供所有可交互元素的坐标位置：

{
    "coordinates": {
        "svg_config": {
            "width": 800,
            "height": 800,
            "center_x": 400,
            "center_y": 400,
            "asc_longitude": 285.5
        },
        "planets": [
            {
                "name": "SUN",
                "type": "planet",
                "longitude": 280.5,
                "z_x": 400,
                "z_y": 200,
                "sign": "Capricorn",
                "house": 10
            },
            {
                "name": "FORTUNA",
                "type": "arabic_part",
                "longitude": 150.2,
                "z_x": 550,
                "z_y": 300
            },
            {
                "name": "ALDEBARAN",
                "type": "fixed_star",
                "longitude": 69.5,
                "z_x": 600,
                "z_y": 350
            }
        ],
        "houses": [
            {"number": 1, "z_x": 420, "z_y": 420},
            {"number": 2, "z_x": 380, "z_y": 450}
        ],
        "signs": [
            {"name": "Aries", "index": 0, "z_x": 460, "z_y": 460},
            {"name": "Taurus", "index": 1, "z_x": 520, "z_y": 520}
        ]
    }
}