Назад к документации

Генератор SVG/PNG-карт

Генератор SVG/PNG-карт

POST/api/v1/natal/chart/

Создавайте красивые, настраиваемые визуализации натальных карт в формате SVG или PNG высокого разрешения. Полный контроль над цветами, размерами, небесными телами и визуальным стилем.

Неизвестное время рождения поддерживается с помощью time_known: false; дома и углы в этом режиме опускаются.

Связанные SVG-эндпоинты

Используйте натальную эндпоинт с одним колесом для одного человека. Для диаграмм отношений семейство SVG также включает составные варианты средней точки и синастрические варианты.

SVG Составная диаграмма
Композитное одноколесное колесо, построенное двумя людьми.
SVG Карта синастрии
Таблица совместимости двухколесного транспорта с наложением обоих людей.

Пример вывода

Стандартный натальный пример
Пример натальной карты, созданной API
Пример французского стиля
Натальная карта во французском стиле, созданная API с использованием темы SVG по умолчанию.

Реальный API, сгенерированный SVG, с использованием темы по умолчанию с chart_config.french_style: true.

Гороскоп Shape Наложение

Установите chart_config.show_horoscope_shape to true определить форму распределения карты только по планетам 10. При обнаружении формы центральная аспектная сетка скрывается и заменяется читаемой заполненной геометрией.

Натальная карта SVG с наложением ведра в форме гороскопа, отображаемого на центральном диске

Реальный вывод API

Этот SVG был создан POST /api/v1/natal/chart/ с обнаруженным Bucket форма. Ответ включает в себя data-key="horoscope_shape.bucket" и дополнительные метаданные JSON в freeastroapi-horoscope-shape.

Используйте эти поля chart_config

show_horoscope_shapehoroscope_shape_stylehoroscope_shape_colorhoroscope_shape_labelembed_horoscope_shape_metadata

Поддерживаемые формы и правила обнаружения

Bundle
Все планеты 10 помещаются внутри дуги, занимаемой 120°.
Bucket
Одна планета-рукоятка или одна плотная группа рукояток из двух планет находится за пределами основной группы. Остальные планеты должны вписываться в пределах 181°, без минимального размаха скопления; группа ручек должна охватывать не более 15°, ручка должна находиться на расстоянии не менее 30° от основной группы, а полная диаграмма должна выходить за пределы одной дуги в 180°.
Bowl
Все планеты 10 занимают непрерывную дугу более 120° и не более 210° с большим пустым промежутком не менее 150°. Если в качестве ручки выступает одна планета или плотное скопление из двух планет, приоритет имеет Баккет.
See-Saw
Два отдельных кластера, с самым большим пустым промежутком не менее 90 ° и вторым по величине пустым зазором не менее 50 °.
Locomotive
Планеты занимают более 210° и не более 260°, оставляя один ведущий пустой промежуток от 100° до 150°, но не включая его.
Splash
Широкое распространение без большого пустого промежутка: как самый большой, так и второй по величине межпланетный промежуток имеют угол менее 60 °.

Для обнаружения Shape используются только Солнце, Moon, Меркурий, Венера, Марс, Юпитер, Сатурн, Уран, Нептун и Плутон. Углы, узлы, астероиды, Лилит, Хирон и лоты не влияют на обнаруженную форму.

Наложение шаблона аспектов

Используйте chart_config.show_pattern_overlays для рендеринга обнаруженных аспектных структур непосредственно поверх диаграммы. Наложения узоров сохраняют видимость нормального аспектного круга и добавляют выделенные подложки, штрихи, метки и стабильные атрибуты SVG для взаимодействия UI.

Натальная карта SVG с наложением одного отфильтрованного шаблона аспектов Большого Креста

Реальный вывод API

Этот SVG показывает отфильтрованное Большой Крест только наложение, соответствующее настройке с pattern_overlay_types установлен на grand_cross и pattern_overlay_max_items установлен на 1. Отображаемые элементы включают в себя такие атрибуты, как data-pattern-type, data-bodies, и data-key="шаблон.*" чтобы ваш UI мог выделить, отфильтровать или объяснить выбранную структуру.

Используйте эти поля chart_config

show_pattern_overlayspattern_overlay_typespattern_overlay_stylepattern_overlay_labelspattern_overlay_max_itemsembed_pattern_metadata

Поддерживаемые отображаемые структуры включают в себя grand_trine, t_square, yod, kite, grand_cross, minor_grand_trine, wedge, mystic_rectangle, cradle, castle, grand_sextile, и stellium.

Галерея предварительного просмотра тем

Три темы диаграмм в производственном стиле, созданные на основе пресетов API. Изображения представляют собой оптимизированные предварительные просмотры WebP для демонстрации качества и производительности.

Предварительный просмотр темы астрологической карты Classic Clarity

Классическая ясность

Сбалансированный профиль консультации со сдержанной иерархией линий.

Navy Gold предварительный просмотр темы астрологической карты

Navy Gold

Темная палитра премиум-класса с высококонтрастной символической читаемостью.

Slate Mineral предварительный просмотр темы астрологической карты

Slate Mineral

Нейтральная прохладно-серая палитра для чтения технических графиков.

Пресеты редакционных тем (только цвет)

Эти пресеты используют только существующие параметры запроса. Они не требуют каких-либо внутренних изменений средства визуализации.

Ivory Ink

Легкая редакционная палитра с теплыми бумажными тонами и сдержанным чернильным контрастом.

{
  "name": "Theme: Ivory Ink",
  "year": 1990,
  "month": 5,
  "day": 15,
  "hour": 14,
  "minute": 30,
  "city": "London",
  "lat": 51.5,
  "lng": -0.12,
  "tz_str": "UTC",
  "format": "png",
  "theme_type": "light",
  "chart_config": {
    "chart_background": "#F6F1E8",
    "custom_planet_color": "#1E1B18",
    "custom_sign_color": "#6A5B48",
    "custom_house_color": "#3E362C",
    "custom_sign_bg_color": "#EFE4D3",
    "custom_house_bg_color": "#FAF6EE",
    "sign_line_color": "#3A3128",
    "house_line_color": "#8C7C68",
    "aspect_conjunction_color": "#2F2A24",
    "aspect_opposition_color": "#A1362A",
    "aspect_trine_color": "#1F4E79",
    "aspect_square_color": "#8F2B23",
    "aspect_sextile_color": "#355E8D",
    "aspect_quincunx_color": "#4D6A3A"
  }
}

Navy Gold

Темная палитра премиум-класса с темно-синей основой и приглушенными золотыми символами/линиями.

{
  "name": "Theme: Navy Gold",
  "year": 1990,
  "month": 5,
  "day": 15,
  "hour": 14,
  "minute": 30,
  "city": "London",
  "lat": 51.5,
  "lng": -0.12,
  "tz_str": "UTC",
  "format": "png",
  "theme_type": "dark",
  "chart_config": {
    "chart_background": "#0D1B2A",
    "custom_planet_color": "#E7D3A5",
    "custom_sign_color": "#C9B27C",
    "custom_house_color": "#A7B8C9",
    "custom_sign_bg_color": "#14263B",
    "custom_house_bg_color": "#102034",
    "sign_line_color": "#D8C08A",
    "house_line_color": "#60758D",
    "aspect_conjunction_color": "#D6DCE5",
    "aspect_opposition_color": "#E06C5B",
    "aspect_trine_color": "#6EA8FF",
    "aspect_square_color": "#C85C53",
    "aspect_sextile_color": "#7EB7FF",
    "aspect_quincunx_color": "#7EBB8D"
  }
}

Slate Mineral

Нейтральная прохладно-серая палитра с минеральными сине-зелеными акцентами.

{
  "name": "Theme: Slate Mineral",
  "year": 1990,
  "month": 5,
  "day": 15,
  "hour": 14,
  "minute": 30,
  "city": "London",
  "lat": 51.5,
  "lng": -0.12,
  "tz_str": "UTC",
  "format": "png",
  "theme_type": "light",
  "chart_config": {
    "chart_background": "#E9EDF1",
    "custom_planet_color": "#22313F",
    "custom_sign_color": "#3F5D73",
    "custom_house_color": "#4D5B66",
    "custom_sign_bg_color": "#DCE4EA",
    "custom_house_bg_color": "#EEF2F6",
    "sign_line_color": "#2F3D49",
    "house_line_color": "#7D8C98",
    "aspect_conjunction_color": "#3A4955",
    "aspect_opposition_color": "#B04A3B",
    "aspect_trine_color": "#2B6F9C",
    "aspect_square_color": "#9A3E33",
    "aspect_sextile_color": "#3D7FAF",
    "aspect_quincunx_color": "#4A7A63"
  }
}

Классическая ясность

Базовая линия профессиональной консультации со сдержанной иерархией линий и более четкой сеткой аспектов.

{
  "name": "Theme: Classic Clarity",
  "year": 1990,
  "month": 5,
  "day": 15,
  "hour": 14,
  "minute": 30,
  "city": "London",
  "lat": 51.5,
  "lng": -0.12,
  "tz_str": "UTC",
  "format": "png",
  "theme_type": "light",
  "chart_config": {
    "sign_line_width": 1.6,
    "house_line_width": 0.9,
    "asc_line_width": 2.4,
    "dsc_line_width": 2.4,
    "mc_line_width": 2.4,
    "ic_line_width": 2.4,
    "sign_ring_inner_width": 1.2,
    "sign_ring_outer_width": 1.6,
    "house_ring_inner_width": 0.8,
    "house_ring_outer_width": 0.9,
    "sign_tick_width": 0.45,
    "aspect_conjunction_width": 2.2,
    "aspect_opposition_width": 2.2,
    "aspect_trine_width": 1.8,
    "aspect_square_width": 2.0,
    "aspect_sextile_width": 1.5,
    "aspect_quincunx_width": 1.3
  }
}

Плотный анализ

Усовершенствованный технический профиль с более сильными грузами по осям, кольцам и аспектам для более детального считывания.

{
  "name": "Theme: Dense Analysis",
  "year": 1990,
  "month": 5,
  "day": 15,
  "hour": 14,
  "minute": 30,
  "city": "London",
  "lat": 51.5,
  "lng": -0.12,
  "tz_str": "UTC",
  "format": "png",
  "theme_type": "light",
  "chart_config": {
    "sign_line_width": 2.6,
    "house_line_width": 1.35,
    "asc_line_width": 3.6,
    "dsc_line_width": 3.6,
    "mc_line_width": 3.6,
    "ic_line_width": 3.6,
    "sign_ring_inner_width": 1.9,
    "sign_ring_outer_width": 2.6,
    "house_ring_inner_width": 1.2,
    "house_ring_outer_width": 1.3,
    "sign_tick_width": 0.62,
    "aspect_conjunction_width": 3.2,
    "aspect_opposition_width": 3.2,
    "aspect_trine_width": 2.6,
    "aspect_square_width": 2.9,
    "aspect_sextile_width": 2.3,
    "aspect_quincunx_width": 2.0
  }
}

Полный URL

https://api.freeastroapi.com/api/v1/natal/chart/

Базовые параметры

Parameter
name
Type
string
Required
Да
Default
-
Description
Имя субъекта (отображается в метаданных)
Parameter
year
Type
integer
Required
Да
Default
-
Description
Год рождения (например, 1990)
Parameter
month
Type
integer
Required
Да
Default
-
Description
Месяц рождения (1-12)
Parameter
day
Type
integer
Required
Да
Default
-
Description
День рождения (1-31)
Parameter
hour
Type
integer
Required
Да
Default
-
Description
Час рождения (0-23, 24-часовой формат)
Parameter
minute
Type
integer
Required
Да
Default
-
Description
Минута рождения (0-59)
Parameter
time_known
Type
boolean
Required
Нет
Default
true
Description
Установите значение false, если время рождения неизвестно. В этом режиме дома и углы исключаются из диаграммы.
Parameter
city
Type
string
Required
Нет
Default
-
Description
Название города. Необязательно, если указаны широта и долгота; используются для поиска координат, когда они опущены.
Parameter
lat
Type
float
Required
Нет
Default
auto
Description
Широта (от -90 до 90). Требуется вместе с lng, если город не указан.
Parameter
lng
Type
float
Required
Нет
Default
auto
Description
Долгота (от -180 до 180). Требуется вместе с широтой, если город опущен.
Parameter
tz_str
Type
string
Required
Нет
Default
AUTO
Description
Часовой пояс (например, 'Europe/Paris' или 'AUTO').
Parameter
house_system
Type
string
Required
Нет
Default
placidus
Description
placidus, whole_sign, equal, koch и другие.
Parameter
zodiac_type
Type
string
Required
Нет
Default
tropical
Description
тропический или сидерический
Parameter
sidereal_ayanamsa
Type
string
Required
Нет
Default
lahiri
Description
лахири, раман, кп и т. д. (только сидерические)

Выходные параметры диаграммы

Parameter
format
Type
string
Required
Нет
Default
svg
Description
Формат вывода: 'svg' или 'png'.
Parameter
size
Type
integer
Required
Нет
Default
700
Description
Ширина/высота диаграммы в пикселях
Parameter
theme_type
Type
string
Required
Нет
Default
light
Description
Тема: 'light', 'dark' или 'mono'.
Parameter
png_quality_scale
Type
float
Required
Нет
Default
2.0
Description
Множитель разрешения PNG (1,0-5.0)
Parameter
show_metadata
Type
boolean
Required
Нет
Default
true
Description
Показать блок метаданных (имя, дата, местоположение)
Parameter
display_settings
Type
object
Required
Нет
Default
{}
Description
Переключатели видимости для каждого тела для планет, углов и дополнительных точек.
Parameter
chart_config
Type
object
Required
Нет
Default
{}
Description
Расширенные визуальные стили и переопределения макета. См. раздел «Конфигурация диаграммы» ниже, чтобы узнать о поддерживаемых полях.

Неподвижные звезды

Фиксированные звезды, запрошенные на SVG-картах, отображаются в том же телесном колесе, что и планеты и точки, с использованием трехбуквенной метки, например Reg или Ald. Линии аспектов выбираются через chart_config.show_fixed_star_aspects и по умолчанию используются только тесные соединения.

Parameter
fixed_stars
Type
array<string>
Required
Нет
Default
[]
Description
Селектор с фиксированной звездой отображается в колесе тела. Принимает идентификаторы пакетов, такие как royal_4 и behenian_20, точные имена с фиксированной звездой, такие как Spica или Regulus, или все для полного набора по умолчанию.
Parameter
chart_config.fixed_star_color
Type
string
Required
Нет
Default
theme points color
Description
Цвет меток с фиксированной звездой, разъемов и дополнительных линий аспекта с фиксированной звездой.
Parameter
chart_config.show_fixed_star_aspects
Type
boolean
Required
Нет
Default
false
Description
Включите аспектные линии с фиксированной звездой.
Parameter
chart_config.fixed_star_aspect_types
Type
array<string>
Required
Нет
Default
['conjunction']
Description
Типы аспектов для рисования неподвижных звезд. Поддерживает соединение, оппозицию, тригон, квадратуру, секстиль, квинконс.
Parameter
chart_config.fixed_star_aspect_orb
Type
float
Required
Нет
Default
1.0
Description
Орб в градусах для аспектов неподвижной звезды.

The 20 Classical/Behenian Stars

Полный список важных неподвижных звезд для традиционных рабочих процессов астрологии.

"fixed_stars": ["behenian_20"]

The 4 Royal Stars

Регул, Альдебаран, Антарес и Фомальгаут.

"fixed_stars": ["royal_4"]
{
  "name": "Natal Chart with Royal Fixed Stars",
  "year": 1990,
  "month": 5,
  "day": 15,
  "hour": 14,
  "minute": 30,
  "city": "London",
  "lat": 51.5,
  "lng": -0.12,
  "tz_str": "UTC",
  "format": "svg",
  "theme_type": "light",
  "fixed_stars": ["royal_4"],
  "chart_config": {
    "degree_label_format": "minutes",
    "show_planet_connectors": true,
    "show_fixed_star_aspects": true,
    "fixed_star_aspect_types": ["conjunction"],
    "fixed_star_aspect_orb": 1.0,
    "fixed_star_color": "#A16207"
  }
}

Настройки отображения (объект display_settings)

Управляйте тем, какие небесные тела появляются на карте:

Parameter
sun
Type
boolean
Required
Нет
Default
true
Description
Показать Солнце
Parameter
moon
Type
boolean
Required
Нет
Default
true
Description
Показать Moon
Parameter
mercury
Type
boolean
Required
Нет
Default
true
Description
Показать Меркурий
Parameter
venus
Type
boolean
Required
Нет
Default
true
Description
Показать Венеру
Parameter
mars
Type
boolean
Required
Нет
Default
true
Description
Показать Марс
Parameter
jupiter
Type
boolean
Required
Нет
Default
true
Description
Показать Юпитер
Parameter
saturn
Type
boolean
Required
Нет
Default
true
Description
Показать Сатурн
Parameter
uranus
Type
boolean
Required
Нет
Default
true
Description
Показать Уран
Parameter
neptune
Type
boolean
Required
Нет
Default
true
Description
Показать Нептун
Parameter
pluto
Type
boolean
Required
Нет
Default
true
Description
Показать Плутон
Parameter
north_node
Type
boolean
Required
Нет
Default
true
Description
Показать северный узел
Parameter
south_node
Type
boolean
Required
Нет
Default
false
Description
Показать южный узел
Parameter
chiron
Type
boolean
Required
Нет
Default
false
Description
Показать Хирона
Parameter
lilith
Type
boolean
Required
Нет
Default
false
Description
Show Mean Black Moon Лилит (предпочтительно; псевдоним: mean_lilith)
Parameter
true_lilith
Type
boolean
Required
Нет
Default
false
Description
Показать Истинный (колеблющийся) Черный Moon Лилит
Parameter
eris
Type
boolean
Required
Нет
Default
false
Description
Показать Эрис
Parameter
eros
Type
boolean
Required
Нет
Default
false
Description
Показать Эрос
Parameter
ceres
Type
boolean
Required
Нет
Default
false
Description
Показать Цереру
Parameter
pallas
Type
boolean
Required
Нет
Default
false
Description
Показать Палладу
Parameter
juno
Type
boolean
Required
Нет
Default
false
Description
Показать Юнону
Parameter
vesta
Type
boolean
Required
Нет
Default
false
Description
Показать Весту
Parameter
asc
Type
boolean
Required
Нет
Default
true
Description
Показать Асцендент
Parameter
ic
Type
boolean
Required
Нет
Default
false
Description
Показать IC
Parameter
dsc
Type
boolean
Required
Нет
Default
false
Description
Показать потомка
Parameter
mc
Type
boolean
Required
Нет
Default
true
Description
Показать МС
Parameter
part_of_fortune
Type
boolean
Required
Нет
Default
false
Description
Показать часть удачи (арабский лот)

Конфигурация диаграммы (объект chart_config)

Настройте внешний вид диаграммы:

Parameter
sign_ring_thickness_fraction
Type
float
Required
Нет
Default
0.16
Description
Толщина кольца знака (0,0-1,0)
Parameter
house_ring_thickness_fraction
Type
float
Required
Нет
Default
0.05
Description
Толщина кольца дома (0,0-1,0)
Parameter
center_disk_fraction
Type
float
Required
Нет
Default
0.45
Description
Радиус центрального диска (0,0-1,0)
Parameter
planet_symbol_scale
Type
float
Required
Нет
Default
0.35
Description
Множитель размера символа планеты
Parameter
planet_spacing_scale
Type
float
Required
Нет
Default
auto
Description
Множитель применяется к угловому расстоянию между глифами планет. Если этот параметр опущен, интервал увеличивается автоматически, когда planet_symbol_scale превышает значение по умолчанию.
Parameter
sign_symbol_scale
Type
float
Required
Нет
Default
0.6
Description
Множитель размера знака
Parameter
house_number_scale
Type
float
Required
Нет
Default
0.35
Description
Множитель размера номера дома
Parameter
chart_background
Type
string
Required
Нет
Default
null
Description
Переопределение цвета фона (шестнадцатеричное)
Parameter
aspect_circle_background
Type
string
Required
Нет
Default
null
Description
Цвет заливки центрального круга/диска. По умолчанию используется chart_background или фон активной темы.
Parameter
custom_planet_color
Type
string
Required
Нет
Default
null
Description
Переопределить все цвета планет (шестнадцатеричные)
Parameter
custom_sign_color
Type
string
Required
Нет
Default
null
Description
Переопределить все цвета символов знака (шестнадцатеричные)
Parameter
custom_house_color
Type
string
Required
Нет
Default
null
Description
Переопределить все цвета номеров домов (шестнадцатеричные)
Parameter
degree_label_color
Type
string
Required
Нет
Default
null
Description
Переопределить цвет текста метки градуса/минуты планеты (шестнадцатеричный или цвет CSS)
Parameter
angle_label_color
Type
string
Required
Нет
Default
null
Description
Резервный цвет для всех глифов ASC/DSC/MC/IC.
Parameter
asc_label_color
Type
string
Required
Нет
Default
null
Description
Цвет метки глифа ASC. Также доступно для dsc_label_color, mc_label_color и ic_label_color.
Parameter
angle_label_scale
Type
float
Required
Нет
Default
null
Description
Множитель резервного масштаба для всех глифов ASC/DSC/MC/IC.
Parameter
asc_label_scale
Type
float
Required
Нет
Default
null
Description
Множитель масштаба метки глифа ASC. Также доступно для dsc_label_scale, mc_label_scale и ic_label_scale.
Parameter
angle_marker_style
Type
string
Required
Нет
Default
glyph
Description
Отрисовка угловых маркеров: 'glyph' сохраняет глифы сокращений ASC/DSC/MC/IC; «french_arrow» рисует стрелки оси ASC/MC во французском стиле за пределами кольца знака.
Parameter
angle_line_span
Type
string
Required
Нет
Default
wheel
Description
Размах линии угловой оси: 'wheel' сохраняет линии ASC/DSC и MC/IC в области колеса по умолчанию; 'full' расширяет эти оси по всей диаграмме и останавливается на краю кольца знака. Используйте angle_marker_style «french_arrow», если вам нужны стрелки ASC/MC за пределами кольца.
Parameter
show_angle_labels_with_french_arrows
Type
boolean
Required
Нет
Default
true
Description
Если angle_marker_style равен french_arrow, включается рендеринг меток глифов ASC/DSC/MC/IC. Установите false, чтобы скрыть их.
Parameter
planet_connector_clearance
Type
float
Required
Нет
Default
auto
Description
Расстояние в SVG пикселей от центра глифа планеты/точки, где заканчивается соединительная линия. Увеличьте это значение, когда большим глифам требуется больше места для передышки.
Parameter
custom_sign_bg_color
Type
string
Required
Нет
Default
null
Description
Один шестнадцатеричный цвет применяется ко всем 12 фоновым знакам колец. Если этот параметр установлен, фон для знаков включается автоматически.
Parameter
custom_house_bg_color
Type
string
Required
Нет
Default
null
Description
Один шестнадцатеричный цвет применяется ко всем 12 фоновым кольцам домов. Если этот параметр установлен, фон дома включается автоматически.
Parameter
show_aspect_symbols
Type
boolean
Required
Нет
Default
auto
Description
Отобразите глифы аспекта средней точки и разделите линии аспекта вокруг них. По умолчанию включено во французском стиле и выключено в противном случае.
Parameter
show_pattern_overlays
Type
boolean
Required
Нет
Default
false
Description
Наложение обнаружило структуры и закономерности диаграммы на SVG. Поддерживаемые структуры включают grand_trine, t_square, йод, воздушный змей, grand_cross, minor_grand_trine, клин, mystic_rectangle, колыбель, замок, grand_sextile и стеллиум.
Parameter
pattern_overlay_types
Type
array
Required
Нет
Default
null
Description
Необязательный список разрешенных типов наложения для отображения, например ["grand_trine", "t_square", "stellium"]. Если этот параметр опущен, все обнаруженные поддерживаемые наложения могут отображаться до pattern_overlay_max_items.
Parameter
pattern_overlay_style
Type
string
Required
Нет
Default
subtle
Description
Интенсивность наложения: 'subtle' или 'strong'.
Parameter
pattern_overlay_labels
Type
boolean
Required
Нет
Default
false
Description
Покажите компактные метки для отображаемых наложений конфигурации.
Parameter
pattern_overlay_max_items
Type
integer
Required
Нет
Default
4
Description
Максимальное количество наложений конфигурации для рисования. Подсветка вывески/дома Stellium является отдельной и не учитывается в этом лимите.
Parameter
embed_pattern_metadata
Type
boolean
Required
Нет
Default
false
Description
Встроить обнаруженные данные наложения в элемент метаданных SVG для последующего наведения, легенды или выбора UI.
Parameter
show_horoscope_shape
Type
boolean
Required
Нет
Default
false
Description
Определите форму распределения карты, используя только планеты 10, и отобразите ее на центральном аспектном диске. При обнаружении формы обычные центральные линии/отметки скрываются для удобства чтения.
Parameter
horoscope_shape_style
Type
string
Required
Нет
Default
subtle
Description
Интенсивность наложения формы гороскопа: 'subtle' или 'strong'.
Parameter
horoscope_shape_color
Type
string
Required
Нет
Default
#D97706
Description
Цвет SVG, используемый для всех наложений фигур гороскопа.
Parameter
horoscope_shape_label
Type
boolean
Required
Нет
Default
true
Description
Покажите компактную метку обнаруженной формы, например «Ковш», «Чаша», «Локомотив», «Связка», «Всплеск» или «Качели».
Parameter
embed_horoscope_shape_metadata
Type
boolean
Required
Нет
Default
true
Description
Встроить обнаруженные данные о форме гороскопа в элемент метаданных SVG.
Parameter
show_retrograde_markers
Type
boolean
Required
Нет
Default
false
Description
Включите ретроградные маркеры на метках градусов планет.
Parameter
retrograde_marker_style
Type
string
Required
Нет
Default
R
Description
Стиль ретроградного маркера, если он включен: 'R' или 'rx' (℞).
Parameter
degree_label_format
Type
string
Required
Нет
Default
null
Description
Формат метки градуса планеты: 'degree' для целых градусов, 'decimal' для десятичных градусов или 'minutes' для сложенных меток минут + знаков + целых градусов. Если этот параметр опущен, degree_label_precision > 0 сохраняет устаревший формат минут.
Parameter
degree_label_precision
Type
integer
Required
Нет
Default
0
Description
Десятичные разряды для degree_label_format="decimal". Допустимый диапазон: 0-4. В целях обратной совместимости, если degree_label_format опущен, значения больше 0 включают расположение минут с накоплением.
Parameter
degree_label_scale
Type
float
Required
Нет
Default
0.6
Description
Текстовый масштаб метки градуса базовой планеты.
Parameter
degree_label_degree_scale
Type
float
Required
Нет
Default
1.0
Description
Точный масштаб текста метки в целых градусах относительно degree_label_scale.
Parameter
degree_label_minute_scale
Type
float
Required
Нет
Default
1.0
Description
Точная минутная шкала текста этикетки относительно degree_label_scale.
Parameter
degree_label_sign_scale
Type
float
Required
Нет
Default
1.25
Description
Точная шкала знаков зодиака метки относительно degree_label_scale.
Parameter
degree_label_row_gap
Type
float
Required
Нет
Default
1.55
Description
Точное расстояние между метками между строками градусов, знаков и минут относительно degree_label_scale.
Parameter
houses_inside_planets
Type
boolean
Required
Нет
Default
true
Description
Разместите дома внутри кольца планет.
Parameter
french_style
Type
boolean
Required
Нет
Default
false
Description
Схема французского гороскопа только для натала: аспектный диск внутри обода знака, дома снаружи знаков, планеты снаружи домов.
Parameter
french_planet_radius_offset
Type
float
Required
Нет
Default
0
Description
Только в режиме Natal French. Перемещает глифы планет радиально наружу или внутрь, не перемещая кольца домов/знаков.

Примеры формата этикетки степени

Используйте degree_label_format: "minutes" чтобы отображать каждую точную метку как отдельные градусы, знаки знаков и строки минут. В приведенных ниже примерах показаны выходные данные PNG, созданные из одной эндпоинта в стандартной и французской раскладках.

Стандартная натальная карта PNG с использованием degree_label_format минут.

Стандартная планировка

Дома остаются внутри планетарной полосы; точные метки располагаются ближе к центру диаграммы.

{
  "format": "png",
  "theme_type": "light",
  "chart_config": {
    "degree_label_format": "minutes",
    "degree_label_color": "#000000",
    "houses_inside_planets": true
  }
}
Натальная карта PNG во французском стиле с использованием degree_label_format минут.

Французский макет

Французский режим сохраняет метки, не являющиеся точными углами, за пределами глифов планет, в то время как метки углов остаются компактными.

{
  "format": "png",
  "theme_type": "light",
  "chart_config": {
    "degree_label_format": "minutes",
    "degree_label_color": "#000000",
    "french_style": true,
    "houses_inside_planets": false
  }
}

Пример кода

curl -X POST "https://api.freeastroapi.com/api/v1/natal/chart/" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
    "name": "John Doe",
    "year": 1990,
    "month": 5,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "time_known": false,
    "lat": 40.7128,
    "lng": -74.006,
    "tz_str": "AUTO",
    "house_system": "placidus",
    "zodiac_type": "tropical",
    "format": "svg",
    "size": 800,
    "theme_type": "light",
    "png_quality_scale": 2.0,
    "show_metadata": true,
    "display_settings": {
        "chiron": true,
        "lilith": true,
        "north_node": true
    },
    "chart_config": {
        "sign_ring_thickness_fraction": 0.16,
        "house_ring_thickness_fraction": 0.05,
        "planet_symbol_scale": 0.35,
        "sign_symbol_scale": 0.6,
        "angle_marker_style": "glyph",
        "angle_line_span": "wheel",
        "french_style": false,
        "french_planet_radius_offset": 0,
        "show_aspect_symbols": true,
        "show_retrograde_markers": true,
        "retrograde_marker_style": "R",
        "degree_label_format": "minutes",
        "custom_planet_color": "#FF5733",
        "aspect_circle_background": "#F8F2FF",
        "show_color_background": false
    }
}' --output chart.svg

Расширенный стиль

The chart_config Объект поддерживает детальный контроль над шириной линий, цветом и стилем аспекта. Дополнительные параметры включают в себя:

  • sign_line_width, sign_line_color
  • house_line_width, house_line_color
  • asc_line_width, asc_line_color (и dsc, mc, ic)
  • asc_label_color, asc_label_scale (и dsc, mc, ic)
  • angle_marker_style установлен на french_arrow для стрелок оси ASC/MC во французском стиле; метки включенных углов остаются видимыми, если show_angle_labels_with_french_arrows ложно
  • angle_line_span установлен на full продлить оси ASC/DSC и MC/IC до края знакового кольца; использовать angle_marker_style french_arrow для стрелок с внешним кольцом
  • planet_connector_clearance чтобы остановить соединительные линии перед глифами большого размера
  • aspect_circle_background раскрасить только центральный аспектный диск
  • aspect_conjunction_width, aspect_conjunction_color
  • aspect_opposition_width, aspect_trine_width, и т. д.

FAQ

Вы поддерживаете фиксированные звезды?

Да. Эндпоинт карты SVG может отображать поддерживаемые неподвижные звезды в том же колесе тела, что и планеты и точки. Используйте fixed_stars с идентификаторами пакетов, такими как royal_4 или behenian_20, точными именами с фиксированной звездой или всем для полного набора по умолчанию.

Какие пакеты с фиксированной звездой доступны?

Доступны два готовых пакета: behenian_20 для 20 классических звезд или звезд Бегена и royal_4 для Regulus, Альдебарана, Антареса и Фомальгаута.

Могу ли я выбрать отдельные неподвижные звезды?

Да. Передавайте точные поддерживаемые имена в массиве fixed_stars, например Spica или Regulus. Тот же массив fixed_stars также принимает идентификаторы пакетов, такие как royal_4 и behenian_20.

Могут ли неподвижные звезды иметь аспекты?

Да, но аспекты фиксированной звезды не являются обязательными. Включите chart_config.show_fixed_star_aspects, затем выберите fixed_star_aspect_types и fixed_star_aspect_orb, если вам нужно больше, чем рабочий процесс тесного соединения по умолчанию.

Могу ли я настроить цвет фиксированной звезды?

Да. Установите для chart_config.fixed_star_color цвет CSS или шестнадцатеричное значение. Этот цвет используется для меток с фиксированной звездой, разъемов и дополнительных линий аспекта с фиксированной звездой.

Обозначают ли неподвижные звезды градусы и знаки?

Да. Неподвижные звезды используют то же поведение размещения на диаграмме, что и другие визуализированные тела, и могут отображать метки градусов, знаков и минут, если этого требует конфигурация меток градусов на диаграмме.

Есть ли у вас инструмент для настройки диаграмм?

Да. Chart Designer позволяет настраивать цвета диаграммы, метки, толщину линий, темы и другие визуальные параметры перед копированием конфигурации запроса в API.

Открыть конструктор диаграмм

Могу ли я настроить цвета, метки, аспекты и макет диаграммы?

Да. Используйте chart_config для цветов, фона, геометрии кольца, масштаба глифов, стиля соединителя, цветов аспекта, ширины линий, меток градусов, ретроградных маркеров, макета во французском стиле и наложений узоров.

Могу ли я экспортировать PNG, а также SVG?

Да. Установите для format значение svg для векторного вывода или png для растрового вывода. Для PNG png_quality_scale управляет множителем выходного разрешения.

Могу ли я встроить SVG в свое приложение?

Да. Ответ SVG можно внедрить непосредственно в ваш интерфейс, сохранить как ресурс или преобразовать в ваш собственный конвейер рендеринга. Используйте ответ API в соответствии с правилами кэширования и безопасности вашего приложения.

Могу ли я создать мобильное приложение с визуальными диаграммами, используя этот API?

Да. Вы можете использовать эту эндпоинт для создания визуальных элементов диаграммы SVG или PNG для мобильного приложения, а затем отобразить возвращенный актив диаграммы в собственном или кроссплатформенном пользовательском интерфейсе. AstroLingo — это пример приложения, созданный с использованием возможностей визуальных диаграмм FreeAstroAPI.

См. пример AstroLingo

Могу ли я скрыть или показать планеты, точки и дома?

Да. Используйте display_settings для переключения планет, узлов, Lilith, Chiron, астероидов, углов и других поддерживаемых точек. Если time_known имеет значение false, дома и углы автоматически опускаются.

Можно ли показывать ретроградов?

Да. Установите для chart_config.show_retrograde_markers значение true. Вы также можете выбрать стиль маркера с помощью chart_config.retrograde_marker_style, используя R или rx.

Могу ли я использовать эту эндпоинт для карт с неизвестным временем рождения?

Да. Установите для time_known значение false. В карте по-прежнему отображаются положения планет, но дома и углы опущены, поскольку они зависят от времени рождения.

Поддерживаете ли вы шаблоны аспектов или наложения форм гороскопа?

Да. chart_config.show_pattern_overlays отображает обнаруженные структуры аспектов, а chart_config.show_horoscope_shape отображает форму распределения диаграммы на центральном диске.

Рендеринг с фиксированной звездой медленнее?

Фиксированные звезды рассчитываются и отображаются только по запросу. Используйте токен пакета, например royal_4, или короткий список fixed_stars для читаемых диаграмм и минимальных дополнительных затрат на рендеринг.

Как аутентифицировать запросы?

Отправьте ключ API в заголовке запроса x-api-key, указав для Content-Type значение application/json.

Прочтите документы по аутентификации

Куда мне обратиться за транзитными, синастрическими или составными диаграммами SVG?

Используйте выделенные эндпоинты SVG для этих типов диаграмм. Они документируются отдельно от SVG-эндпоинта натальной карты.

Документы по транзиту SVGДокументация Synastry SVGСоставные документы SVG

Связанные эндпоинты

Натальная карта (JSON)

Получить данные диаграммы в формате JSON.

Transits

Сравните текущее небо с натальной картой.