Що таке Cosmobiology Ебертіна?

Cosmobiology — це астрологічний метод XX століття, розроблений Райнгольдом Ебертіном у Німеччині. Він зводить інтерпретацію карти до жорстких аспектів (conjunction, opposition, square, semi-square, sesquiquadrate), що читаються на циферблаті 22.5° — 4-й гармоніці зодіаку. Мідпойнти й графічна ефемерида — центральні інструменти. Cosmobiology робить акцент на таймінгу й прогнозуванні подій, а не на психологічному читанні. Ендпоінт graphic-ephemeris дає вам візуалізацію, якою практики Cosmobiology користуються з часів Combination of Stellar Influences Ебертіна (1940).

Чому стандарт — 4-та гармоніка 22.5°?

360°, поділені на 16, дорівнюють 22.5°. 4-та гармоніка піднімає на поверхню кожен жорсткий аспект: conjunction (0°), semi-square (45°), square (90°), sesquiquadrate (135°) та opposition (180°) — усі сходяться на одній сітці 22.5°, бо кожен є кратним 22.5°. М'які аспекти (trine, sextile) — ні. Це робить циферблат 22.5° детектором жорстких аспектів — саме тому Cosmobiology прийняла його як де-факто стандарт для роботи з таймінгом. graphic-ephemeris дефолтиться на harmonic=4 саме з цієї причини.

Чи іменовані SVG-шари для стилізації на боці клієнта?

Так. Кожен ендпоінт /render/* групує SVG-елементи в іменовані шари: g id='axes', g id='aspects', g id='planets' на колесі; g id='bars', g id='ticks', g id='axis' на transit gantt; g id='planet-sun', g id='planet-moon' тощо на graphic-ephemeris. Ваш CSS або downstream SVG-процесор може націлитися на будь-який шар за id без парсингу геометрії — перефарбуйте планети, сховайте шар аспектів, перестилізуйте тики. Конвенція іменування стабільна між версіями.

Які теми карт доступні?

Чотири пресети: minimal (чиста світла), minimal-dark (чистий темний папір), astrocom (світла версія вигляду astro.com) та astrocom-dark (темна версія вигляду astro.com). Під ними також працюють чотири нативні CSS-теми Kerykeion: light, dark, dark-high-contrast, classic. Передайте theme=astrocom-dark — і отримаєте найпопулярніший темний професійний вигляд. Кожен пресет накладається поверх базової CSS-теми Kerykeion, тож кольори паперу й сектори зодіаку наслідуються чисто.

Чи можу я отримати карту в стилі Astrocom?

Так — встановіть theme=astrocom (світла) або theme=astrocom-dark. Це поєднує чотири патчі одразу: axis_stroke_width=3.0 для товстих ліній AC/MC/DC/IC, axes_labels_position='outside' для підписів одразу за колом, house_numbers_position='center' для розкладки номерів будинків у внутрішньому кільці та єдиний axis_color (#444444 для світлої, #6b7280 для темної). Вивід імітує еталонну карту astro.com (Astrodienst), яку традиційні астрологи читають уже 30+ років.

Як налаштувати товщину осей?

Передайте axis_stroke_width як float. 1.0 — за замовчуванням (поведінка Kerykeion до патча). 3.0 відповідає пресету astrocom і еталону astro.com. 5.0+ підходить для виводу настінного плаката. Параметр впливає лише на чотири куспіди осей (AC на індексі 0, IC на 3, DC на 6, MC на 9). Інші куспіди будинків лишаються 1px пунктиром з прозорістю 0.4. Лінії осей рендеряться суцільно з прозорістю 0.9, коли цей параметр встановлено.

Чи можна приховати конкретні планети з ліній аспектів?

Так — передайте hide_points_in_aspects як масив імен точок, напр. ['Chiron','Mean_Lilith','Mean_South_Node']. Ці точки залишаються видимими на колі, але постпроцесор прибирає їх з кожної лінії аспектів у SVG і видаляє їхній рядок із сітки аспектів. Корисно для вбудовок, де треба чистий вигляд аспектів без видалення мінорних тіл з карти повністю. Постпроцесор запускається після makeTemplate() Kerykeion, тож тайминг стабільний.

Чи рендерить API Part of Fortune?

Так. Додайте 'part_of_fortune' у active_points — і трапляються три речі: формула день/ніч обчислює позицію (ASC + Moon - Sun для денних карт, ASC + Sun - Moon для нічних), гліф хреста в колі рендериться через новий символ Part_of_Fortune у SVG defs, а рядок Part of Fortune з'являється в сітці аспектів. Аспекти Part of Fortune ми обчислюємо самі, бо апстрімна Kerykeion не знає, що це тіло існує. Сьогодні працює для типів natal і external-natal.

Чи підтримуєте ви планети Uranian / Hamburg School?

Так — усі вісім ураніанських гіпотетичних рендеряться нативно: Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulcanus, Poseidon. Додайте потрібні імена в active_points — і settings_builder інжектить конфіг гліфа й кольору для кожного. Вони з'являються на колі й у сітці аспектів, як і будь-яке інше тіло. Поєднайте з hide_points_in_aspects, щоб малювати гліфи без шуму аспектів — це відповідає нотації Hamburg School.

Чи можна рендерити synastry, transit і composite карти?

Так — один ендпоінт, чотири типи карт: Natal, Synastry, Transit, Composite. Система тем застосовується до всіх, тож theme=astrocom-dark дає темну синастрію в стилі astrocom з обома іменами в dual-chart заголовку. Вторинні суб'єкти синастрії й транзитів також отримують пропатчені номери будинків і (за конфігурації) власний гліф Part of Fortune. Крос-суб'єктні аспекти Part of Fortune — у роадмапі.

Чому ви вендорнули Kerykeion v4.26.3, а не просто імпортували її?

Імпорт pip Kerykeion означав, що ми не можемо змінити поведінку осей, додати Part of Fortune чи пропатчити логіку аспектів без форку. Ми скопіювали Kerykeion v4.26.3 у app/vendor/kerykeion_charts/, зберегли сумісні шляхи імпортів і додали PATCHES.md, що трекає кожну зміну. Тепер апгрейди апстріму — це свідоме код-рев'ю замість тихого breaking change у проді. У кожного патча є нумерований тег (PATCH-01 до PATCH-04 плюс PATCH-PartOfFortune) і відповідний inline-коментар у вихіднику.

Куди потрапляють номери будинків з house_numbers_position='center'?

Номери будинків рендеряться у внутрішньому кільці на 78% радіуса кола (r * 0.78), шрифтом 10px з fill-opacity 0.7. Це розкладка astro.com. Дефолт ('near_cusp' або null) тримає їх на оригінальному dropin-зсуві біля кожного куспіда зі шрифтом 14px і fill-opacity 0.6. Для карт synastry й transit те саме стиснення застосовується до номерів вторинного суб'єкта — специфічна для транзитів логіка fill-opacity (0 для транзиту, 0.4 інакше) зберігається.

Що робить hide_axes_visually?

Передайте масив імен осей (напр. ['IC','DC']) — і ці лінії осей прибираються з SVG, тоді як базові розрахунки лишаються цілими. Кути все ще в даних карти, тож розрахунки аспектів і позиції будинків лишаються коректними — зникає лише видима лінія. Корисно для мінімальних вбудовок, де треба показати планети й знаки без хреста кардинальних осей. Поки це постпроцесор рівня stub; повний контроль по кожній осі — у роадмапі.

Наскільки швидкий рендеринг?

Типовий час рендерингу — під 500ms, у найгіршому випадку під 1 секунду. Vendored-код Kerykeion додає мінімальний оверхед — патчі це здебільшого умовні гілки в існуючих функціях малювання плюс один прохід постпроцесора по SVG-рядку. Час холодного старту залежить від завантаження файлів Swiss Ephemeris. Edge-кешування покриває ідентичні запити, тож повторна генерація для тих самих даних народження повертається майже миттєво.

Які формати виводу я отримую?

SVG — основний вивід; усе, що робить рендерер, нативне для SVG. PNG, JPEG, WebP і PDF доступні через ендпоінти конвертації формату. SVG — те, що ви хочете для веб-вбудовок, бо масштабується без втрати якості й важить мало. Використовуйте PNG або JPEG, коли потрібна сумісність з email-клієнтами (Outlook). PDF зберігає векторну якість для друку. WebP приблизно на 30% менший за PNG при тій же візуальній якості.

Чи можу я перевизначати налаштування теми на запит?

Так — передайте dict custom_settings, щоб перевизначити будь-яке налаштування карти поверх теми. Злиття поверхневе: дефолти теми завантажуються першими, ваш dict custom_settings перевизначає зверху, результат іде в Kerykeion. Можна також передавати окремі параметри патчів (axis_stroke_width, axes_labels_position тощо) напряму — вони завжди виграють у дефолтів теми. Тема — це стартова точка, а не обмеження.

Скільки коштує Chart Rendering API?

Рендеринг карти коштує 10 кредитів на запит. План Ultra стартує з $37/місяць за 55,000 кредитів (близько 5,500 карт). План Business — $99/місяць за 220,000 кредитів (близько 22,000 карт). Безкоштовний рівень не включає рендеринг карт — лише дата-ендпоінти. Enterprise-плани отримують виділену інфраструктуру й необмежену генерацію.

Які системи будинків підтримуються?

23 системи будинків працюють з кожною темою й кожним типом карти: Placidus, Whole Sign, Equal House, Koch, Regiomontanus, Campanus, Morinus, Porphyry, Topocentric, Alcabitius, Krusinski, Sripati та ще 11. Вибір системи будинків незалежний від теми — можна рендерити Whole Sign-карту в темі astrocom-dark, і куспіди намалюються коректно. Розрахунки використовують Swiss Ephemeris (дані NASA JPL).

Наскільки точні базові розрахунки?

Точність до субдугової секунди для кожної планети, астероїда й гіпотетичного тіла. Рендерер — тонкий шар поверх Swiss Ephemeris, який використовує дані ефемерид NASA JPL — те саме джерело, на яке покладається професійний астрономічний софт. Тема й параметри кастомізації впливають лише на візуальний вивід; математика однакова, яку тему не обирай.

Чи є таймінг-колеса (age-bands, bi-wheel)?

Так — SVG-таймінг живе на /svg/timing/* як окремі ендпоінти. Колесо age-bands рендерить кільця життєвих фаз навколо натальної карти. Рендерер bi-wheel накладає одну карту на іншу (напр. транзит поверх натальної) з обома кільцями видимими. Вони ділять те саме vendored-ядро Kerykeion зі стандартним ендпоінтом chart_svg, тож пресети тем і параметри патчів застосовуються.

Як інтегрувати це з моїм застосунком?

Це REST API. Шліть дані народження (дата, час, локація) плюс тему й будь-які параметри кастомізації — отримуєте SVG-рядок назад. Працює з будь-якою мовою — curl, JavaScript, Python, Ruby, PHP, Go. Для веба вставте SVG прямо в сторінку. Для мобільних застосунків запитуйте PNG або WebP через ендпоінти конвертації формату. Та сама автентифікація, ті самі rate limits, та сама модель кредитів для всіх типів карт.

Чи є rate limiting на генерацію карт?

Rate limits залежать від плану. Ultra (55,000 кредитів/місяць) покриває більшість незалежних платформ. Business (220,000 кредитів) підходить для масштабованих застосунків. Enterprise-плани працюють на виділеній інфраструктурі без місячної межі. При 10 кредитах за карту Ultra дає вам ~5,500 карт/місяць, а Business — ~22,000; межа — це пул кредитів, а не per-second rate limit.

Налаштовувані SVG-карти

Chart Rendering API: SVG рівня Astrocom за вашими правилами

Ми вендорнули Kerykeion v4.26.3, щоб мати змогу її патчити.

Результат: 3 пресети тем, пресет у стилі Astrocom, 10+ параметрів карти, Part of Fortune, ураніанські планети та natal/synastry/transit/composite з одного ендпоінту.

Дивитись демо

Gantt

Смуги таймінгу транзитів

22.5°

4-та гармоніка Ебертіна

Astrocom

Пресети тем

10+

Кастомні параметри

2,1M+ карт рендериться щомісяця

Використовують 750+ платформ по світу

Точність Swiss Ephemeris гарантовано

Прогнозним дашбордам потрібні професійні таймінг-в'ю — Гантт-смуги та графічна ефемерида, а не лише натальні колеса
Готовий вивід Kerykeion фіксований: ті самі осі, ті самі шрифти, той самий вигляд на кожному сайті
Немає способу повторити естетику Astrocom (Astrodienst), яку очікують традиційні астрологи
Аспектні лінії накладаються — і ви не можете приховати конкретні точки без видалення їх із кола
Part of Fortune відсутній у вихідному рендерингу (немає гліфа, немає рядка в таблиці аспектів)
Лінії осей (AC, MC, DC, IC) рендеряться однаково — не можна потовщити чи змінити позицію підпису
Астрологи Hamburg School та Uranian не можуть показати свої гіпотетичні планети
Номери будинків застрягли в одному місці; немає опції внутрішнього кільця
Воркфлоу Cosmobiology потребують сітки 4-ї гармоніки Ебертіна; більшість API її не постачають

Трансформуйте з

/api/v3/render/* — консолідований неймспейс: колеса карт, транзитний Гантт, графічна ефемерида живуть як сіблінги
/render/transit-gantt: візуалізація горизонтальними смугами для вікон таймінгу аспектів у прогнозних дашбордах
/render/graphic-ephemeris: сітка 22.5° 4-ї гармоніки в стилі Ебертіна з планетами як неперервними лініями
Іменовані SVG-шари (g id='axes', g id='aspects', g id='planets') для стилізації через CSS на боці клієнта
3 пресети тем: minimal, minimal-dark, astrocom-dark — обирайте вигляд одним параметром
Пресет Astrocom: товщі осі, підписи AC/MC/DC/IC зовні, центровані номери будинків — з коробки
10+ параметрів карти: axis_stroke_width, axes_labels_position, house_numbers_position, axis_color та інші
hide_points_in_aspects: прибирайте обрані планети з ліній аспектів, залишаючи їх на колі
Part of Fortune + 8 ураніанських гіпотетичних рендеряться на сервері
Natal, synastry, transit, composite — той самий ендпоінт карти, та сама система тем

Продуктивність рендерингу карт

Vendored Kerykeion v4.26.3 з нашим шаром кастомізації

Пресети тем

10+

Параметри кастомізації

SVG (post-processed)

Основний вивід

<500ms

Час рендерингу

Wheel, Transit Gantt, Graphic Ephemeris

Render-ендпоінти

2,1M+

Рендерингів за місяць

Налаштовуваний SVG: від теми до окремої осі

3 пресети, 10+ параметрів, вивід рівня Astrocom

Transit Gantt SVG

/render/transit-gantt малює горизонтальні смуги для вікон таймінгу аспектів. Рядки — пари планет, колонки — дати, тики точного потрапляння всередині кожної смуги.

Ендпоінт: /api/v3/render/transit-gantt — розфарбовано за типом аспекту, іменовані SVG-шари

Graphic Ephemeris SVG

/render/graphic-ephemeris малює планети як неперервні лінії на сітці 22.5° 4-ї гармоніки Ебертіна. Зустрічі ліній позначають жорсткі аспекти за логікою Cosmobiology.

Ендпоінт: /api/v3/render/graphic-ephemeris — гармоніка 1/2/4/8/16, дефолтне вікно 12 місяців

Стандарт 4-ї гармоніки Ебертіна

Сітка 22.5° — це де-факто стандарт Cosmobiology з 1940-х. Ми постачаємо її як дефолтну гармоніку в graphic-ephemeris.

harmonic=4 за замовч.; перемикається на 1, 2, 8, 16 на запит

Іменовані SVG-шари

Кожен render-вивід групує елементи в іменовані SVG-шари (g id='axes', 'aspects', 'planets', 'bars', 'ticks'), тож CSS на боці клієнта може перестилізувати без парсингу геометрії.

Стабільна конвенція іменування id по всіх ендпоінтах /render/*

Неймспейс /render/*

Один неймспейс для візуалізацій: колеса карт, транзитний Гантт, графічна ефемерида. Старі шляхи /svg/timing/* продовжують працювати для зворотної сумісності.

Консолідовано під /api/v3/render/* — легасі /svg/timing/* як аліаси

Пресет теми Astrocom

Один параметр (theme=astrocom) дає вигляд карти astro.com — товсті осі, підписи AC/MC/DC/IC зовні, центровані номери будинків, єдиний колір осей.

Поєднує PATCH-01, PATCH-02, PATCH-03, PATCH-04 з кольором осей #444444

Тема Astrocom-Dark

Темний відповідник Astrocom — ті самі структурні патчі, темний папір, єдиний колір осей під темний UI.

axis_color=#6b7280, накладається на dark.css Kerykeion

Тема Minimal

Чиста світла тема з приглушеними лініями аспектів і простими секторами зодіаку — для вбудовок, що не сперечаються зі сторінкою.

Накладається на classic.css, без структурних патчів

Тема Minimal-Dark

Той самий мінімальний вигляд на темному папері — працює під темний UI без додаткового CSS.

Наслідує кольори паперу та секторів зодіаку з dark.css

Параметр axis_stroke_width

Контролюйте товщину куспідів осей AC/MC/DC/IC. 1.0 за замовчуванням, 3.0 імітує astro.com, 5.0 для настінних плакатів.

Float — застосовується лише до куспідів осей (індекси 0, 3, 6, 9), суцільна лінія прозорістю 0.9

Параметр axes_labels_position

Розміщуйте підписи AC/MC/DC/IC зовні кола (жирним), у малому внутрішньому кільці (середня вага) або повністю ховайте.

Приймає 'outside' | 'center' | null — координатна математика перевикористовує формулу зсуву куспіда

Параметр house_numbers_position

Рендерте номери будинків у внутрішньому кільці на 78% радіуса (стиль astro.com) або біля кожного куспіда (за замовчуванням).

Приймає 'center' | 'near_cusp' — застосовується і до вторинного суб'єкта в синастрії/транзитах

Гліф Part of Fortune

Додайте 'part_of_fortune' у active_points — гліф хреста в колі рендериться на колі, а рядок Part of Fortune з'являється в сітці аспектів.

Формула день/ніч, id=23 для стабільності індексованих доступів в апстрімі

hide_points_in_aspects

Передайте масив імен точок, щоб прибрати їх з ліній і сітки аспектів — не видаляючи гліфи з кола.

Постпроцесор по SVG-рядку — запускається після makeTemplate() Kerykeion

hide_axes_visually

Тримайте AC/MC/DC/IC у розрахунку, але ховайте лінії з SVG. Корисно для чистих embed-в'ю.

Постпроцесор рівня stub — приймає масив імен осей

Гіпотетичні планети

8 ураніанських / Hamburg School гіпотетичних — Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulcanus, Poseidon — рендеряться з власними гліфами.

Додайте в active_points; settings_builder інжектить конфіг гліфа й кольору

Dual-chart заголовок

Карти synastry й transit зберігають заголовок з двома суб'єктами через рефакторинг рендерера — обидва імена й обидві дати народження рендеряться над колом.

Збережено через фасад ChartRenderer у app/services/chart_renderer/renderer.py

Тип карти Composite

Композитні карти за серединою рендеряться через той самий ендпоінт з тією ж системою тем.

chart_type='Composite' на уніфікованому фасаді ChartRenderer

Точність Swiss Ephemeris

Дані ефемерид NASA JPL живлять кожну планетарну позицію незалежно від теми чи типу карти.

Точність до субдугової секунди для всіх небесних тіл

23 системи будинків

Placidus, Whole Sign, Equal House, Koch, Regiomontanus, Campanus, Morinus, Porphyry, Topocentric та ще 14.

Вибір системи будинків незалежний від теми

Перевизначення кастомних налаштувань

Передайте dict custom_settings, щоб перевизначити будь-яке поле карти на запит — кольори, кольори гліфів, кольори паперу, кольори зодіаку.

Зливається поверх дефолтів теми; виграє той, хто викликає

Що таке Chart Rendering API? Історія vendored-Kerykeion

3 пресети тем, 10+ параметрів кастомізації, вивід рівня Astrocom, Part of Fortune, ураніанські планети

Chart Rendering API перетворює дані народження на налаштовувану SVG-астрокарту. Ми вендорнули Kerykeion v4.26.3 у власну кодову базу, щоб мати змогу її патчити — це дало нам товщі осі, підписи осей за межами кільця, центровані номери будинків, гліф Part of Fortune, підтримку гіпотетичних планет та постпроцесор, який вміє приховувати обрані точки з ліній аспектів. Ви отримуєте три пресети тем з коробки (minimal, minimal-dark, astrocom-dark), 10+ параметрів карти й один ендпоінт, що обробляє natal, synastry, transit та composite. Час рендерингу тримається під 500ms.

Чому ми вендорнули Kerykeion v4.26.3, а не імпортували її?

Kerykeion — потужна open-source бібліотека для карт, але вихідний рендерер закритий: фіксована товщина осей, немає Part of Fortune, немає хуків для приховування точок з ліній аспектів і немає шляху для гіпотетичних планет Hamburg School.

Ми скопіювали потрібні модулі в app/vendor/kerykeion_charts/ на версії 4.26.3, зберегли сумісну поверхню імпортів і додали PATCHES.md, який трекає кожну зміну.

Чотири нумеровані патчі (PATCH-01 до PATCH-04) плюс ін'єкція Part of Fortune покривають нові параметри.

Дві теми, які постачаються з апстрімом (light, dark, dark-high-contrast, classic), все ще працюють як базові шари.

Наші пресети накладаються поверх цих базових CSS-змінних, тож кольори паперу в темному режимі, кольори секторів зодіаку й кольори гліфів наслідуються чисто.

Підхід з вендорингом означає, що кожне оновлення апстріму — це код-рев'ю, а не несподіване breaking change у проді.

Vendored Kerykeion v4.26.3 — ми тримаємо контроль над лінією патчів

1 min read

Яку тему обрати: minimal, minimal-dark чи astrocom-dark?

Три пресети покривають більшість випадків.

Minimal — чиста світла тема: приглушені лінії аспектів, прості сектори зодіаку, світлий папір.

Використовуйте для блог-вбудовок, соціальних карток і застосунків, які хочуть карту, що не сперечається з рештою сторінки.

Minimal-dark інвертує папір у темно-сірий, залишає кольори аспектів читабельними й працює для темних UI.

Astrocom-dark — темний відповідник пресету Astrocom: товщі осі, підписи AC/MC/DC/IC зовні кільця, центровані номери будинків, єдиний колір осей (#6b7280) — по суті вигляд карти Astrodienst у темній обгортці.

Передайте theme=astrocom для світлої версії, theme=astrocom-dark для темної, theme=minimal для чистого світлого вигляду або theme=minimal-dark для того ж на темному.

Ви все ще можете перевизначати будь-який з нижніх параметрів на кожен запит, тож тема — це стартова точка, а не клітка.

3 пресети: minimal, minimal-dark, astrocom-dark — плюс astrocom (світла)

1 min read

Що таке пресет Astrocom і чому він важливий?

Astrocom — це вигляд, який ви бачите на astro.com — карта Astrodienst, яку професійні астрологи читають з 90-х.

Це де-факто еталонний стиль західної традиції: товсті чорні лінії осей, підписи AC/MC/DC/IC одразу за межами кола, номери будинків у внутрішньому кільці замість позначення біля куспідів, і єдиний нейтральний колір осей, щоб чотири кардинальні напрямки не сперечалися між собою.

Пресет astrocom поєднує PATCH-01 (axis_stroke_width=3.0), PATCH-02 (axes_labels_position='outside'), PATCH-03 (house_numbers_position='center') та PATCH-04 (axis_color='#444444' для світлої, '#6b7280' для темної).

Встановіть theme=astrocom — і отримаєте всі чотири одразу.

Для платформ, націлених на традиційних астрологів, цей пресет часто є самою причиною, чому команди переходять.

Класична тема Kerykeion має кольори по осях (orange/black/blue/red), що конфліктує з більш стриманим лейаутом — astrocom їх уніфікує.

Пресет Astrocom = еталонний вигляд astro.com одним параметром

1 min read

Як працюють параметри на рівні елементів?

П'ять параметрів дозволяють перевизначити пресет на одному запиті.

axis_stroke_width приймає float — 1.0 за замовчуванням, 3.0 імітує astro.com, 5.0 — товщина для настінного плаката.

axes_labels_position приймає 'outside' (одразу за колом, жирним), 'center' (мале внутрішнє кільце, середня вага) або null (без підписів осей — поведінка Kerykeion до патча).

house_numbers_position приймає 'center' (мале внутрішнє кільце на 78% радіуса, шрифт 10px, прозорість 0.7) або 'near_cusp' (за замовчуванням, 14px, біля кожного куспіда).

hide_points_in_aspects приймає масив імен точок: передайте ['Chiron','Lilith'] — Chiron і Lilith залишаться на колі, але зникнуть з кожної лінії аспектів і з рядка таблиці аспектів.

hide_axes_visually приймає масив імен осей: AC залишається в розрахунку, але лінія не малюється — корисно для вбудовок, де треба чисте коло.

axis_color перевизначає CSS-змінні по осях одним єдиним кольором.

5 параметрів патчів: axis_stroke_width, axes_labels_position, house_numbers_position, hide_points_in_aspects, hide_axes_visually

1 min read

Що таке ендпоінт /render/transit-gantt?

/api/v3/render/transit-gantt — це SVG-рендерер для вікон таймінгу аспектів.

Замість колеса ви отримуєте діаграму горизонтальних смуг: рядки — пари планет (напр., транзитний Saturn до натального Sun), колонки — дати, а кожна смуга позначає вікно, коли аспект у орбі.

Дати точного потрапляння показуються вертикальними тиками всередині кожної смуги.

Вивід — це прогнозний дашборд-в'ю, який потрібен астрологам і таймінг-застосункам: коли цей транзит починається, коли пік, коли завершується.

Смуги розфарбовані за типом аспекту (conjunction, square, opposition, trine, sextile), а SVG постачається з іменованими шарами (g id='bars', g id='ticks', g id='axis'), тож CSS на боці клієнта може перестилізувати без парсингу геометрії.

Спека: docs/SPECS/06_timing_visualizations.md §A, рендерер: app/services/render/transit_gantt.py.

Часовий діапазон, включені аспекти й допуски орбу — параметри запиту.

/render/transit-gantt — SVG горизонтальних смуг для вікон таймінгу аспектів

1 min read

Що таке ендпоінт /render/graphic-ephemeris?

/api/v3/render/graphic-ephemeris — це графічна ефемерида 4-ї гармоніки в стилі Ебертіна — базовий інструмент Cosmobiology з 1940-х.

Вісь X — час.

Вісь Y — сітка 22.5° (360° / 16 — 4-та гармоніка, або четверте ділення базового циферблата 22.5°).

Кожна планета малюється як неперервна лінія, що завертається, коли перетинає 22.5°.

Коли дві лінії зустрічаються на сітці, це жорсткий аспект за логікою 4-ї гармоніки: conjunction, opposition, square або semi-square.

Практики Cosmobiology читають ці зустрічі як дати подій.

Опції гармоніки: 1 (сира довгота), 2, 4 (за замовчуванням Ебертіна), 8 або 16.

Дефолтне часове вікно — 12 місяців, налаштовується.

Вивід — SVG з іменованими шарами (g id='planet-sun', g id='planet-moon' тощо), тож кожна планетна лінія селектиться по CSS.

Спека: docs/SPECS/06_timing_visualizations.md §B.

Рендерер: app/services/render/graphic_ephemeris.py.

/render/graphic-ephemeris — сітка 22.5° 4-ї гармоніки Ебертіна

1 min read

Use Cases

Платформи для традиційних астрологів

theme=astrocom дає вигляд карти astro.com, якому професіонали вже довіряють

Сучасні застосунки в темному режимі

theme=minimal-dark або astrocom-dark підходять під темний UI без додаткового CSS

Еллінські карти з Part of Fortune

Додайте 'part_of_fortune' у active_points — гліф і рядок аспектів рендеряться автоматично

Uranian / Hamburg School

8 гіпотетичних планет (від Cupido до Poseidon) рендеряться з власними гліфами

Вбудовки з акцентом на аспекти

hide_points_in_aspects прибирає мінорні тіла з ліній, залишаючи коло цілим

Synastry, Transit, Composite

Один ендпоінт, та сама система тем, dual-chart заголовок зберігається між типами

Technical Specifications

Render-неймспейс	/api/v3/render/* (chart, transit-gantt, graphic-ephemeris)
Часовий діапазон Transit Gantt	За замовч. 12 місяців; налаштовуваний start/end
Гармоніка Graphic Ephemeris	1, 2, 4 (за замовч. Ебертіна), 8 або 16
Іменування SVG-шарів	g id='axes' \| 'aspects' \| 'planets' \| 'bars' \| 'ticks'
База рендерера	Vendored Kerykeion v4.26.3 + 4 нумеровані патчі
Пресети тем	minimal, minimal-dark, astrocom, astrocom-dark
Нативні теми Kerykeion	light, dark, dark-high-contrast, classic
axis_stroke_width	Float — 1.0 за замовч., 3.0 astrocom, до 5.0
axes_labels_position	outside \| center \| null (без підписів)
house_numbers_position	center (внутр. кільце r*0.78) \| near_cusp (за замовч.)
axis_color	Hex-рядок — перевизначає CSS-змінні по осях
hide_points_in_aspects	Масив імен точок — постпроцесор прибирає їх з ліній аспектів
hide_axes_visually	Масив імен осей — лишаються в розрахунку, прибираються з SVG
active_points	Включає part_of_fortune + 8 ураніанських гіпотетичних
Типи карт	Natal, Synastry, Transit, Composite (один ендпоінт)
Формати виводу	SVG основний; PNG, JPEG, WebP, PDF через конвертацію
Час рендерингу	<500ms типово, <1s у найгіршому випадку
Системи будинків	23 (Placidus, Whole Sign, Koch тощо)
Точність розрахунків	Swiss Ephemeris (дані NASA JPL)
Перевизначення кастомних налаштувань	dict custom_settings — будь-яке поле, на запит

Vendored Kerykeion + патчі проти стокової Kerykeion і закритих конкурентів

Feature	Astrology API	Others
Покриття візуалізацій	Wheel + transit gantt + graphic ephemeris (3 render-ендпоінти)	Лише натальні колеса
Базове джерело	Vendored Kerykeion v4.26.3 — ми тримаємо лінію патчів	Стоковий pip install АБО закритий SDK
Вивід у стилі Astrocom	theme=astrocom — один параметр	Недоступно; стиль карти зафіксований
Пресети тем	minimal, minimal-dark, astrocom, astrocom-dark	Фіксований вигляд або 1-2 теми
Товщина осей	Float параметр, від 1.0 до 5.0+	Хардкод 1px
Позиція номерів будинків	center \| near_cusp	Тільки near_cusp
Приховати точки з аспектів	Масив hide_points_in_aspects — постпроцесор	Все або нічого; видалення з карти повністю
Part of Fortune	Формула + гліф + рядок сітки аспектів	Не підтримується (Kerykeion); по-різному деінде
Гіпотетичні планети	8 ураніанських (від Cupido до Poseidon) нативно	Рідко підтримуються
Типи карт	Natal, Synastry, Transit, Composite — один ендпоінт	Часто окремі ендпоінти або бібліотеки
Шлях апгрейду апстріму	Код-рев'ю на кожен bump — PATCHES.md трекається	Тихі breaking changes при pip upgrade
Час рендерингу	<500ms типово	Зазвичай 1-3 секунди

Пов'язані астрологічні API

Transit Gantt SVG

Візуалізація горизонтальними смугами для вікон таймінгу аспектів

Graphic Ephemeris SVG

Сітка 22.5° 4-ї гармоніки в стилі Ебертіна

Natal API

Розрахунки натальної карти, що живлять рендерер

Part of Fortune

Еллінський жереб — формула, гліф, рядок аспектів

Hypothetical Planets

Hamburg School / Uranian — 8 гіпотетичних нативно

Synastry API

Карти стосунків з тією ж системою тем

Composite API

Композитні карти за серединою для пар

Timing API

SVG-таймінг age-bands і bi-wheel

Transit API

Живі транзити поверх натального кола

References & Standards

Swiss Ephemeris (DE431-based) — astronomical calculations source
NASA JPL Planetary Ephemerides — underlying ephemeris dataset
International Astronomical Union (IAU) — body designation and nomenclature standards
IANA Time Zone Database — timezone & DST resolution

Прості, Прозорі Тарифи

Почніть безкоштовно, масштабуйтеся по мірі росту. Ніяких прихованих платежів, ніяких сюрпризів.

Завжди Безкоштовно

Почніть безкоштовно

Ідеально для навчання, тестування та невеликих особистих проєктів

50 API-викликів/місяць

Базові натальні карти

5 систем будинків

Підтримка спільноти

Pro

$11/місяць

Для невеликих додатків та особистих проєктів

Всі базові ендпоінти
12 систем будинків
Підтримка email

Найкраща Ціна

Pro Plus

$21/місяць

Для зростаючих додатків та середнього трафіку

Всі розширені ендпоінти
18 систем будинків
AI-інтерпретації
Пріоритетна email підтримка

Ultra

$37/місяць

Для професійних астрологічних додатків

Credit math ↓

Всі преміум ендпоінти
23 системи будинків
Розширені AI-інтерпретації
Пріоритетна підтримка

Плани Великого Обсягу

Для корпоративних застосунків

Бізнес

$99/місяць

Для додатків з великим навантаженням

Credit math ↓

ВСІ ендпоінти
Готовий до white-label
Індивідуальне налаштування AI
Телефонна підтримка

НЕОБМЕЖЕНО

Корпоративний

$399+на місяць

Необмежені запити з виділеною інфраструктурою

Виділена серверна інфраструктура
Гарантовані <300мс
Цілодобова виділена підтримка
SLA 99.99% аптайму

Всі плани включають повну документацію та SDK

Питання? Поговоріть з нашою командою

Часті питання про Chart Rendering API

Теми, патчі, Part of Fortune, гіпотетичні планети — і все між ними

Пов'язані астрологічні API

Chart SVG API працює найкраще поряд з рештою стека. Додайте

transit gantt SVG graphic ephemeris SVG розрахунки натальної карти Part of Fortune гіпотетичні планети карти синастрії композитні карти таймінг-колеса живі транзити

Три SVG-рендерери, один неймспейс

Колеса карт, транзитні Гантт-смуги та графічна ефемерида на сітці 22.5° 4-ї гармоніки Ебертіна — все під /api/v3/render/*. Теми Astrocom, іменовані SVG-шари, Part of Fortune, ураніанські планети.

Старт безкоштовно Дивитись документацію

Transit gantt + graphic ephemeris SVG

Сітка 22.5° 4-ї гармоніки Ебертіна

Іменовані SVG-шари для стилізації через CSS

<500ms час рендерингу

Доступно на плані Ultra і вище

Chart Rendering API: SVG рівня Astrocom за вашими правилами

Самих натальних коліс мало для прогнозних дашбордів

Один render-неймспейс: колеса, Гантт-смуги, графічна ефемерида

Продуктивність рендерингу карт

Налаштовуваний SVG: від теми до окремої осі

Transit Gantt SVG

Graphic Ephemeris SVG

Стандарт 4-ї гармоніки Ебертіна

Іменовані SVG-шари

Неймспейс /render/*

Пресет теми Astrocom

Тема Astrocom-Dark

Тема Minimal

Тема Minimal-Dark

Параметр axis_stroke_width

Параметр axes_labels_position

Параметр house_numbers_position

Гліф Part of Fortune

hide_points_in_aspects

hide_axes_visually

Гіпотетичні планети

Dual-chart заголовок

Тип карти Composite

Точність Swiss Ephemeris

23 системи будинків

Перевизначення кастомних налаштувань

Що таке Chart Rendering API? Історія vendored-Kerykeion

Чому ми вендорнули Kerykeion v4.26.3, а не імпортували її?

Яку тему обрати: minimal, minimal-dark чи astrocom-dark?

Що таке пресет Astrocom і чому він важливий?

Як працюють параметри на рівні елементів?

Що таке ендпоінт /render/transit-gantt?

Що таке ендпоінт /render/graphic-ephemeris?

Use Cases

Платформи для традиційних астрологів

Сучасні застосунки в темному режимі

Еллінські карти з Part of Fortune

Uranian / Hamburg School

Вбудовки з акцентом на аспекти

Synastry, Transit, Composite

Technical Specifications

Vendored Kerykeion + патчі проти стокової Kerykeion і закритих конкурентів

Пов'язані астрологічні API

Transit Gantt SVG

Graphic Ephemeris SVG

Natal API

Part of Fortune

Hypothetical Planets

Synastry API

Composite API

Timing API

Transit API

References & Standards

Прості, Прозорі Тарифи

Завжди Безкоштовно

Pro

Pro Plus

Ultra

Плани Великого Обсягу

Бізнес

Корпоративний

Часті питання про Chart Rendering API

Що таке ендпоінт /render/transit-gantt?

Що таке ендпоінт /render/graphic-ephemeris?

Що таке Cosmobiology Ебертіна?

Чому стандарт — 4-та гармоніка 22.5°?

Чи іменовані SVG-шари для стилізації на боці клієнта?

Які теми карт доступні?

Чи можу я отримати карту в стилі Astrocom?

Як налаштувати товщину осей?

Чи можна приховати конкретні планети з ліній аспектів?

Чи рендерить API Part of Fortune?

Чи підтримуєте ви планети Uranian / Hamburg School?

Чи можна рендерити synastry, transit і composite карти?

Чому ви вендорнули Kerykeion v4.26.3, а не просто імпортували її?

Куди потрапляють номери будинків з house_numbers_position='center'?

Що робить hide_axes_visually?

Наскільки швидкий рендеринг?

Які формати виводу я отримую?

Чи можу я перевизначати налаштування теми на запит?