Назад к документации
SVG Генератор транзитных диаграмм
SVG Генератор транзитных диаграмм
POST
/api/v1/natal/chart/transitsСоздайте транзитную карту bi-wheel, показывающую текущие положения планет, наложенные на натальную карту. Натальные планеты появляются во внешнем кольце (по умолчанию синие), транзитные планеты во внутреннем кольце (по умолчанию красные). Полный контроль над цветами, пропорциями и визуальным стилем.
Если время рождения неизвестно, введите natal.time_known: false опустить дома и углы.
Полный URL-адрес
https://api.freeastroapi.com/api/v1/natal/chart/transitsПараметры натального субъекта (вложен внутри natal объект)
Детали карты рождения субъекта.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| name | string | Yes | - | Имя субъекта |
| year | integer | Yes | - | Год рождения |
| month | integer | Yes | - | Месяц рождения (1-12) |
| day | integer | Yes | - | День рождения (1-31) |
| hour | integer | Yes | - | Час рождения (0-23) |
| minute | integer | Yes | - | Минута рождения (0-59) |
| time_known | boolean | No | true | Установите false, если время рождения неизвестно. Дома и углы на натальном колесе опущены. |
| city | string | No | - | Город рождения. Необязательно, если указаны широта и долгота. |
| lat | float | No | auto | Широта рождения. Требуется вместе с lng, если город опущен. |
| lng | float | No | auto | Долгота рождения. Требуется вместе с широтой, если город опущен. |
| tz_str | string | No | AUTO | Часовой пояс (например Europe/London или AUTO) |
| house_system | string | No | placidus | placidus, whole_sign, equal, koch и т. д. |
| zodiac_type | string | No | tropical | tropical или sidereal |
| format | string | No | svg | Формат вывода: svg или png. |
| size | integer | No | 700 | Ширина/высота диаграммы в пикселях |
| theme_type | string | No | light | Тема: light, dark или mono. |
| png_quality_scale | float | No | 2.0 | Множитель разрешения PNG (1,0–5,0) |
| show_metadata | boolean | No | true | Показать блок метаданных на диаграмме |
Параметры транзита (top-level)
Где и когда рассчитывать транзитное небо.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| current_city | string | Yes | - | Город для позиций транзитных планет |
| current_lat | float | No | auto | Транзитная широта (необязательно) |
| current_lng | float | No | auto | Транзитная долгота (необязательно) |
| transit_date | string | No | now | Формат ISO даты и времени транзита: YYYY-MM-DDTHH:MM (по умолчанию — текущий момент) |
| tz_str | string | No | AUTO | Часовой пояс транзитного пункта |
Видимость линии аспекта (top-level)
Управляйте тем, какие наборы аспектных линий рисуются.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| show_inter_aspects | boolean | No | true | Показать транзитные → натальные линии аспекта (cross-aspects) |
| show_natal_aspects | boolean | No | false | Показать натальные → натальные аспектные линии |
| show_transit_aspects | boolean | No | false | Показать транзитные линии → транзитные аспектные линии |
Цвета Планеты (top-level)
Переопределить цвет символа планеты и текста градусов для каждого кольца. Проходить null использовать цвет элемента каждой планеты.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| natal_planet_color | string | No | #1565C0 | Цвет символов натальной планеты + текст градуса (шестнадцатеричный). Нуль = элементарные цвета. |
| transit_planet_color | string | No | #C62828 | Цвет символов транзитных планет + текст градуса (шестнадцатеричный). Нуль = элементарные цвета. |
Настройки дисплея (внутри natal.display_settings)
Контролируйте, какие тела появляются на натальном кольце.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| sun | boolean | No | true | Показать Солнце |
| moon | boolean | No | true | Показать Луну |
| mercury | boolean | No | true | Показать Меркурий |
| venus | boolean | No | true | Показать Венеру |
| mars | boolean | No | true | Показать Марс |
| jupiter | boolean | No | true | Показать Юпитер |
| saturn | boolean | No | true | Показать Сатурн |
| uranus | boolean | No | true | Показать Уран |
| neptune | boolean | No | true | Показать Нептун |
| pluto | boolean | No | true | Показать Плутон |
| north_node | boolean | No | true | Показать северный узел |
| chiron | boolean | No | true | Показать Хирона |
| lilith | boolean | No | true | Show Mean Black Moon Lilith (старый псевдоним mean_lilith) |
| mean_lilith | boolean | No | false | Показать Злую Черную Луну Лилит |
| true_lilith | boolean | No | false | Показать Истинную (колеблющуюся) Черную Луну Лилит |
| eris | boolean | No | false | Показать Эрис |
| eros | boolean | No | false | Показать Эрос |
| part_of_fortune | boolean | No | false | Показать часть удачи |
Конфигурация диаграммы (внутри natal.chart_config)
Fine-tune внешний вид графика. Все параметры являются необязательными и размещаются внутри natal.chart_config object.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| sign_ring_thickness_fraction | float | No | 0.16 | Толщина знакового кольца (0,0–1,0) |
| house_ring_thickness_fraction | float | No | 0.05 | Толщина кольца дома (0,0–1,0) |
| center_disk_fraction | float | No | 0.45 | Радиус центрального диска (0,0–1,0) |
| planet_symbol_scale | float | No | 0.35 | Множитель размера символа планеты |
| sign_symbol_scale | float | No | 0.6 | Множитель размера знака |
| house_number_scale | float | No | 0.35 | Множитель размера номера дома |
| chart_background | string | No | null | Переопределение цвета фона (шестнадцатеричное) |
| custom_planet_color | string | No | null | Переопределить все цвета планет (шестнадцатеричные). Нуль = элементарные цвета. |
| custom_sign_color | string | No | null | Переопределить все цвета символов знака (шестнадцатеричные) |
| custom_house_color | string | No | null | Переопределить все цвета номеров домов (шестнадцатеричные) |
| custom_sign_bg_color | string | No | null | Один шестнадцатеричный цвет для всех 12 фонов колец знаков. Если этот параметр установлен, фон для знаков включается автоматически. |
| custom_house_bg_color | string | No | null | Один шестнадцатеричный цвет для всех 12 фоновых колец домов. Если этот параметр установлен, фон дома включается автоматически. |
| sign_line_width | float | No | 2.0 | Толщина линии-разделителя знаков |
| house_line_width | float | No | 1.0 | Ширина линии разделителя дома |
| asc_line_width | float | No | - | Ширина линии оси ASC |
| mc_line_width | float | No | - | Ширина линии оси MC |
| aspect_conjunction_width | float | No | - | Ширина линии аспекта соединения |
| aspect_trine_width | float | No | - | Ширина линии тригонального аспекта |
| aspect_opposition_width | float | No | - | Ширина линии противоположного аспекта |
| aspect_square_width | float | No | - | Ширина линии квадратного аспекта |
| aspect_sextile_width | float | No | - | Ширина линии аспекта секстиля |
| show_retrograde_markers | boolean | No | false | Включите ретроградные маркеры на метках градусов планет. |
| retrograde_marker_style | string | No | R | Стиль ретроградного маркера, когда он включен: «R» или «rx» (℞). |
| houses_inside_planets | boolean | No | true | Размещайте дома внутри планетарного кольца (рекомендуется для транзита bi-wheel) |
| french_style | boolean | No | false | Французская раскладка bi-wheel: аспектный диск внутри обода знака, натальные дома снаружи знаков, натальные планеты вне домов и транзитные планеты во внешней полосе. |
| french_planet_radius_offset | float | No | 0 | Смещение полосы движения натальной планеты French-mode. Перемещает глифы натальных планет в радиальном направлении, не перемещая кольца дома/знака. |
| french_transit_planet_radius_offset | float | No | 24 | Обычное французское смещение планетарной полосы transit-mode. Перемещает транзитные глифы радиально, не перемещая натальные кольца. |
| french_transit_degree_label_offset | float | No | -28 | Смещение метки французского градуса transit-mode. Позитив перемещает ярлыки внутрь; отрицательный сдвигает их наружу. |
| french_transit_natal_planets_inside | boolean | No | false | Французский вариант transit-mode. Перемещает кольцо дома, номера домов и аспектный диск внутрь, как в обычной карте SVG, помещает пользовательские/натальные планеты внутри кольца знаков и оставляет current-sky/транзитные планеты снаружи. |
| french_transit_natal_inner_radius_offset | float | No | 0 | Французский вариант transit-mode inner-natal. Регулирует радиус полосы внутренней планеты пользователя. |
| french_transit_inner_natal_house_gap | float | No | 60 | Французский вариант transit-mode inner-natal. Зазор от внутреннего кольца знака до внешнего кольца дома; большие значения уменьшают размер кольца дома и аспектного диска. |
| french_transit_inner_natal_planet_radius_offset | float | null | No | null | Французский вариант transit-mode inner-natal. Переопределяет смещение полосы движения current-sky/транзитной планеты; null использует для этого режима значение закрытия по умолчанию. |
Пример кода
curl -X POST "https://api.freeastroapi.com/api/v1/natal/chart/transits" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"natal": {
"name": "John Doe",
"year": 1990,
"month": 5,
"day": 15,
"hour": 14,
"minute": 30,
"time_known": false,
"city": "London",
"tz_str": "AUTO",
"size": 700,
"theme_type": "light",
"format": "svg",
"chart_config": {
"custom_sign_bg_color": "#e8e0f0",
"custom_house_bg_color": "#e0f0f8",
"show_retrograde_markers": true,
"retrograde_marker_style": "R",
"french_style": true,
"french_planet_radius_offset": 0,
"french_transit_planet_radius_offset": 24,
"french_transit_degree_label_offset": -28,
"french_transit_natal_planets_inside": false,
"french_transit_natal_inner_radius_offset": 0,
"french_transit_inner_natal_house_gap": 60,
"french_transit_inner_natal_planet_radius_offset": null,
"custom_planet_color": null
}
},
"current_city": "New York",
"transit_date": "2026-02-26T12:00",
"show_inter_aspects": true,
"show_natal_aspects": false,
"show_transit_aspects": false,
"natal_planet_color": "#1565C0",
"transit_planet_color": "#C62828"
}' --output transit_chart.svg