O que é a cosmobiologia de Ebertin?

Cosmobiologia é um método astrológico do século 20 desenvolvido por Reinhold Ebertin na Alemanha. Reduz a interpretação do mapa a aspectos duros (conjunção, oposição, quadratura, semi-quadratura, sesquiquadratura) lidos num dial de 22.5° — a 4ª harmônica do zodíaco. Pontos médios e a efeméride gráfica são ferramentas centrais. A cosmobiologia enfatiza timing e predição de eventos sobre leitura psicológica. O endpoint graphic-ephemeris te dá a visualização que praticantes de cosmobiologia usam desde o Combination of Stellar Influences de Ebertin (1940).

Por que a 4ª harmônica 22.5° é o padrão?

360° divididos por 16 dão 22.5°. A 4ª harmônica revela todo aspecto duro: conjunção (0°), semi-quadratura (45°), quadratura (90°), sesquiquadratura (135°) e oposição (180°) colapsam na mesma grade 22.5° porque cada um é múltiplo de 22.5°. Aspectos suaves (trígono, sextil) não. Isso faz do dial 22.5° um detector de aspectos duros — por isso a cosmobiologia adotou como padrão de fato pra trabalho de timing. A graphic-ephemeris usa harmonic=4 como padrão por essa razão.

As camadas SVG são nomeadas pra estilização downstream?

Sim. Todo endpoint /render/* agrupa elementos SVG em camadas nomeadas: g id='axes', g id='aspects', g id='planets' na roda; g id='bars', g id='ticks', g id='axis' no Gantt de trânsitos; g id='planet-sun', g id='planet-moon', etc. na efeméride gráfica. Seu CSS ou processador SVG downstream pode mirar qualquer camada por id sem parsear geometria — recolora planetas, oculte a camada de aspectos, reestilize marcações. A convenção de nomeação se mantém estável entre versões.

Quais temas de mapa estão disponíveis?

Quatro presets: minimal (light limpo), minimal-dark (papel escuro limpo), astrocom (versão light do visual astro.com), e astrocom-dark (versão escura do visual astro.com). Por baixo, quatro temas CSS nativos do Kerykeion também funcionam: light, dark, dark-high-contrast, classic. Passe theme=astrocom-dark pro visual profissional escuro mais popular. Cada preset é camada sobre um tema CSS base do Kerykeion, então cores de papel e setores zodiacais herdam direitinho.

Posso obter um mapa estilo Astrocom?

Sim — defina theme=astrocom (light) ou theme=astrocom-dark. Isso combina quatro patches de uma vez: axis_stroke_width=3.0 pra linhas AC/MC/DC/IC grossas, axes_labels_position='outside' pra rótulos logo após a roda, house_numbers_position='center' pro layout de números de casas em anel interno, e um axis_color unificado (#444444 light, #6b7280 dark). A saída imita o mapa de referência astro.com (Astrodienst) que astrólogos tradicionais leem há mais de 30 anos.

Como customizo a espessura dos eixos?

Passe axis_stroke_width como float. 1.0 é o padrão (comportamento pré-patch do Kerykeion). 3.0 bate com o preset astrocom e a referência astro.com. 5.0+ funciona pra saída em pôster de parede. O parâmetro afeta só as quatro cúspides de eixo (AC no índice 0, IC no 3, DC no 6, MC no 9). Outras cúspides de casa ficam em 1px tracejado em opacidade 0.4. Linhas de eixo renderizam sólidas em opacidade 0.9 quando esse parâmetro está definido.

Posso ocultar planetas específicos das linhas de aspecto?

Sim — passe hide_points_in_aspects como array de nomes de pontos, ex. ['Chiron','Mean_Lilith','Mean_South_Node']. Esses pontos ficam visíveis na roda mas o pós-processador remove das linhas de aspecto no SVG e tira a linha deles da grade de aspectos. Útil pra embeds onde você quer uma visão de aspectos limpa sem remover corpos menores do mapa inteiro. O pós-processador roda depois do makeTemplate() do Kerykeion, então o timing é consistente.

A API renderiza Parte da Fortuna?

Sim. Adicione 'part_of_fortune' a active_points e três coisas acontecem: a fórmula diurna/noturna calcula a posição (ASC + Lua - Sol pra mapas diurnos, ASC + Sol - Lua pra noturnos), o glifo cruz-em-círculo renderiza na roda via o novo símbolo Part_of_Fortune nas defs do SVG, e uma linha de Parte da Fortuna aparece na grade de aspectos. Calculamos aspectos de Parte da Fortuna por conta própria porque o Kerykeion upstream não sabe que o corpo existe. Funciona pra tipos de mapa natal e external-natal hoje.

Vocês suportam planetas Uranianos / Escola de Hamburgo?

Sim — todos os oito hipotéticos Uranianos renderizam nativamente: Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulcanus, Poseidon. Adicione os nomes que você quer a active_points e o settings_builder injeta a config de glifo e cor de cada um. Aparecem na roda e na grade de aspectos como qualquer outro corpo. Combine com hide_points_in_aspects pra desenhar os glifos sem o ruído de aspectos, o que bate com o estilo de notação da Escola de Hamburgo.

Posso renderizar mapas de sinastria, trânsito e composto?

Sim — um endpoint, quatro tipos de mapa: Natal, Sinastria, Trânsito, Composto. O sistema de temas se aplica a todos, então theme=astrocom-dark te dá um mapa de sinastria estilo astrocom escuro com os nomes de ambos os sujeitos no cabeçalho duplo. Sujeitos secundários de sinastria e trânsito também recebem os números de casas patcheados e (quando configurado) sua própria Parte da Fortuna. Aspectos cruzados de Parte da Fortuna entre sujeitos estão no roadmap.

Por que vocês fizeram vendoring do Kerykeion v4.26.3 ao invés de só importar?

Importar o Kerykeion via pip significava que não podíamos mudar comportamento de eixo, adicionar Parte da Fortuna, ou aplicar patches na lógica de aspectos sem fork. Copiamos o Kerykeion v4.26.3 pra app/vendor/kerykeion_charts/, mantivemos os paths de import compatíveis, e adicionamos um PATCHES.md que rastreia cada mudança. Agora upgrades upstream são code review deliberado em vez de quebra silenciosa em produção. Cada patch tem uma tag numerada (PATCH-01 até PATCH-04 mais PATCH-PartOfFortune) e um comentário inline correspondente no código fonte.

Onde os números de casas vão com house_numbers_position='center'?

Números de casas renderizam num anel interno em 78% do raio da roda (r * 0.78), usando fonte 10px com fill-opacity 0.7. Esse é o layout astro.com. O padrão ('near_cusp' ou null) mantém eles no offset dropin original perto de cada cúspide com fonte 14px e fill-opacity 0.6. Pra mapas de sinastria e trânsito, o mesmo encolhimento se aplica aos números do sujeito secundário — a lógica de fill-opacity específica de trânsito (0 pra trânsito, 0.4 caso contrário) é preservada.

O que hide_axes_visually faz?

Passe um array de nomes de eixo (ex. ['IC','DC']) e essas linhas de eixo são removidas do SVG, enquanto os cálculos subjacentes ficam intactos. Os ângulos continuam nos dados do mapa, então cálculos de aspecto e posições de casas ficam corretos — só a linha visível some. Útil pra embeds minimalistas onde você quer mostrar planetas e signos sem a cruz dos eixos cardeais. Atualmente é um pós-processador em nível de stub; controle por eixo completo está no roadmap.

Quão rápida é a renderização?

Tempo típico de renderização fica abaixo de 500ms, pior caso abaixo de 1 segundo. O caminho de código do Kerykeion vendored adiciona overhead mínimo — os patches são na maioria branches condicionais em funções de desenho existentes mais uma passagem de pós-processador na string SVG. Tempo de cold-start depende do carregamento de arquivos Swiss Ephemeris. Cache de edge cobre requisições idênticas, então geração repetida de mapa pros mesmos dados de nascimento volta quase instantânea.

Quais formatos de saída eu recebo?

SVG é a saída principal — tudo que o renderer faz é nativamente SVG. PNG, JPEG, WebP e PDF estão disponíveis através de endpoints de conversão de formato. SVG é o que você quer pra embeds web porque escala sem perda de qualidade e é pequeno. Use PNG ou JPEG quando precisar de compatibilidade com client de email (Outlook). PDF preserva qualidade vetorial pra impressão. WebP é cerca de 30% menor que PNG pra mesma qualidade visual.

Posso sobrescrever configs de tema por requisição?

Sim — passe um dict custom_settings pra sobrescrever qualquer config de mapa em cima do tema. O merge é raso: defaults de tema carregam primeiro, seu dict custom_settings sobrescreve por cima, o resultado alimenta o Kerykeion. Você também pode passar parâmetros de patch individuais (axis_stroke_width, axes_labels_position, etc.) direto — esses sempre vencem sobre os defaults do tema. Um tema é ponto de partida, não restrição.

Quanto custa a API de Renderização de Mapas?

Renderização de mapa custa 10 créditos por requisição. O plano Ultra começa em $37/mês por 55.000 créditos (cerca de 5.500 mapas). O plano Business é $99/mês por 220.000 créditos (cerca de 22.000 mapas). O tier gratuito não inclui renderização de mapas — só endpoints de dados. Planos Enterprise recebem infraestrutura dedicada e geração ilimitada.

Quais sistemas de casas são suportados?

23 sistemas de casas funcionam com todo tema e todo tipo de mapa: Placidus, Whole Sign, Equal House, Koch, Regiomontanus, Campanus, Morinus, Porphyry, Topocentric, Alcabitius, Krusinski, Sripati, e mais 11. Escolha de sistema de casas é independente do tema — você pode renderizar um mapa Whole Sign no tema astrocom-dark e as cúspides desenham corretamente. Cálculos usam Swiss Ephemeris (dados NASA JPL).

Quão precisos são os cálculos subjacentes?

Precisão sub-arco-segundo pra todo planeta, asteroide e corpo hipotético. O renderer é uma camada fina sobre o Swiss Ephemeris, que usa dados de efemérides NASA JPL — a mesma fonte que software de astronomia profissional usa. Tema e parâmetros de customização afetam só saída visual; a matemática é idêntica independente do tema escolhido.

Existem rodas de timing (age-bands, bi-wheel)?

Sim — rodas de timing SVG ficam em /svg/timing/* como endpoints separados. A age-bands wheel renderiza anéis de fase de vida ao redor de um mapa natal. O renderer bi-wheel sobrepõe um mapa em outro (ex. trânsito sobre natal) com ambos os anéis visíveis. Compartilham o mesmo core Kerykeion vendored do endpoint chart_svg padrão, então presets de tema e parâmetros de patch se aplicam.

Como integro isso com meu app?

É uma API REST. Envie dados de nascimento (data, hora, local), mais tema e quaisquer params de customização, receba uma string SVG de volta. Funciona com qualquer linguagem — curl, JavaScript, Python, Ruby, PHP, Go. Pra web, jogue o SVG direto na página. Pra apps mobile, peça PNG ou WebP através dos endpoints de conversão de formato. Mesma auth, mesmos rate limits, mesmo modelo de créditos entre todos os tipos de mapa.

Existe rate limit na geração de mapas?

Rate limits dependem do plano. Ultra (55.000 créditos/mês) cobre a maioria das plataformas independentes. Business (220.000 créditos) serve apps em crescimento. Planos Enterprise rodam em infraestrutura dedicada sem cap mensal. A 10 créditos por mapa, Ultra te dá ~5.500 mapas/mês e Business te dá ~22.000 — o teto é o pool de créditos, não um rate limit por segundo.

Mapas SVG Customizáveis

API de Renderização de Mapas: SVG de Nível Astrocom, Suas Regras

Fizemos vendoring do Kerykeion v4.26.3 pra poder aplicar patches.

O resultado: 3 presets de tema, um preset estilo Astrocom, 10+ parâmetros de mapa, Parte da Fortuna, planetas uranianos, e natal/sinastria/trânsito/composto num só endpoint.

Ver Demo

Gantt

Barras de Timing de Trânsitos

22.5°

4ª Harmônica de Ebertin

Astrocom

Presets de Tema

10+

Params Customizáveis

2,1M+ mapas renderizados mensalmente

Usado por 750+ plataformas no mundo

Precisão Swiss Ephemeris garantida

Dashboards de previsão precisam de visões de timing de nível profissional — barras Gantt e efeméride gráfica — não só rodas natais
A saída padrão do Kerykeion é fixa: mesmos eixos, mesmas fontes, mesmo visual em todo site
Não dá pra imitar a estética Astrocom (Astrodienst) que astrólogos tradicionais esperam
Linhas de aspectos se acumulam — e você não consegue ocultar pontos específicos sem removê-los da roda
Parte da Fortuna ausente na renderização upstream (sem glifo, sem linha de aspectos)
Linhas de eixo (AC, MC, DC, IC) renderizam todas iguais — sem como engrossá-las ou mudar posição do rótulo
Astrólogos da Escola de Hamburgo e Uranianos não conseguem mostrar seus planetas hipotéticos
Números de casas presos num lugar; sem opção de layout em anel interno
Workflows de cosmobiologia precisam da grade da 4ª harmônica de Ebertin; a maioria das APIs não entrega

Transforme com

/api/v3/render/* é o namespace consolidado — rodas de mapa, Gantt de trânsitos e efeméride gráfica vivem como irmãos
/render/transit-gantt: visualização em barras horizontais das janelas de timing de aspectos pra dashboards de previsão
/render/graphic-ephemeris: grade 22.5° da 4ª harmônica estilo Ebertin plotando planetas como linhas contínuas
Camadas SVG nomeadas (g id='axes', g id='aspects', g id='planets') pra estilização CSS downstream
3 presets de tema: minimal, minimal-dark, astrocom-dark — escolha um visual num parâmetro
Preset Astrocom: eixos mais grossos, rótulos AC/MC/DC/IC externos, números de casas centralizados — direto da caixa
10+ params de mapa: axis_stroke_width, axes_labels_position, house_numbers_position, axis_color, e mais
hide_points_in_aspects: tire planetas selecionados das linhas de aspectos mantendo-os na roda
Parte da Fortuna + 8 hipotéticos Uranianos renderizam no servidor
Natal, sinastria, trânsito, composto — mesmo endpoint de mapa, mesmo sistema de temas

Performance da Renderização de Mapas

Kerykeion v4.26.3 vendored com nossa camada de customização

Presets de Tema

10+

Params de Customização

SVG (pós-processado)

Saída Principal

<500ms

Tempo de Renderização

Roda, Gantt de Trânsitos, Efeméride Gráfica

Endpoints de Render

2,1M+

Renderizações Mensais

SVG Customizável, do Tema ao Eixo Individual

3 presets, 10+ params, saída de nível Astrocom

SVG de Gantt de Trânsitos

/render/transit-gantt desenha barras horizontais pras janelas de timing de aspectos. Linhas são pares planetários, colunas são datas, marcações de hit exato dentro de cada barra.

Endpoint: /api/v3/render/transit-gantt — colorido por tipo de aspecto, camadas SVG nomeadas

SVG de Efeméride Gráfica

/render/graphic-ephemeris plota planetas como linhas contínuas na grade 22.5° da 4ª harmônica de Ebertin. Encontros de linhas marcam aspectos duros pela lógica da cosmobiologia.

Endpoint: /api/v3/render/graphic-ephemeris — harmônica 1/2/4/8/16, janela padrão de 12 meses

Padrão da 4ª Harmônica de Ebertin

A grade 22.5° é o padrão de fato da cosmobiologia desde os anos 1940. Entregamos ela como harmônica padrão na graphic-ephemeris.

harmonic=4 padrão; alternável pra 1, 2, 8, 16 por requisição

Camadas SVG Nomeadas

Toda saída de render agrupa elementos em camadas SVG nomeadas (g id='axes', 'aspects', 'planets', 'bars', 'ticks') pra que CSS downstream possa reestilizar sem parsear geometria.

Convenção de nomeação de id estável em todos os endpoints /render/*

Namespace /render/*

Um namespace pra visualizações: rodas de mapa, Gantt de trânsitos, efeméride gráfica. Caminhos antigos /svg/timing/* ainda funcionam pra compatibilidade reversa.

Consolidado sob /api/v3/render/* — legacy /svg/timing/* com alias

Preset de Tema Astrocom

Um parâmetro (theme=astrocom) te dá o visual do mapa astro.com — eixos grossos, rótulos AC/MC/DC/IC externos, números de casas centralizados, cor de eixo unificada.

Combina PATCH-01, PATCH-02, PATCH-03, PATCH-04 com cor de eixo #444444

Tema Astrocom-Dark

Contraparte escura do Astrocom — mesmos patches estruturais, papel escuro, cor de eixo unificada ajustada pra UIs escuras.

axis_color=#6b7280, camada sobre dark.css do Kerykeion

Tema Minimal

Tema light limpo com linhas de aspecto suaves e setores zodiacais planos — pra embeds que não devem brigar com a página.

Camada sobre classic.css, sem patches estruturais aplicados

Tema Minimal-Dark

Mesmo visual minimal em papel escuro — funciona pra UI escura sem escrever CSS extra.

Herda cores de papel e setores zodiacais de dark.css

Parâmetro axis_stroke_width

Controle a grossura das cúspides de eixo AC/MC/DC/IC. 1.0 padrão, 3.0 imita astro.com, 5.0 pra pôsteres de parede.

Float — aplica só nas cúspides de eixo (índices 0, 3, 6, 9), linha sólida em opacidade 0.9

Parâmetro axes_labels_position

Posicione rótulos AC/MC/DC/IC fora da roda (negrito), num anel interno pequeno (peso médio), ou oculte por completo.

Aceita 'outside' | 'center' | null — cálculo de coordenada reusa fórmula de offset de cúspide

Parâmetro house_numbers_position

Renderize números de casas num anel interno em 78% do raio (estilo astro.com) ou perto de cada cúspide (padrão).

Aceita 'center' | 'near_cusp' — também aplica ao sujeito secundário de sinastria/trânsito

Glifo de Parte da Fortuna

Adicione 'part_of_fortune' a active_points — o glifo cruz-em-círculo renderiza na roda e uma linha de Parte da Fortuna aparece na grade de aspectos.

Fórmula diurna/noturna, id=23 pra manter acessos indexados upstream estáveis

hide_points_in_aspects

Passe um array de nomes de pontos pra tirá-los das linhas de aspecto e da grade — sem remover os glifos da roda.

Pós-processador na string SVG — roda depois do makeTemplate() do Kerykeion

hide_axes_visually

Mantenha AC/MC/DC/IC no cálculo mas oculte as linhas do SVG. Útil pra visualizações de embed limpas.

Pós-processador em nível de stub — aceita array de nome de eixo

Planetas Hipotéticos

8 hipotéticos Uranianos / Escola de Hamburgo — Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulcanus, Poseidon — renderizam com seus próprios glifos.

Adicione a active_points; settings_builder injeta config de glifo + cor

Cabeçalho de Mapa Duplo

Mapas de sinastria e trânsito mantêm o cabeçalho de sujeito duplo através do refactor do renderer — ambos os nomes, ambas as datas de nascimento renderizam acima da roda.

Preservado através da fachada ChartRenderer em app/services/chart_renderer/renderer.py

Tipo de Mapa Composto

Mapas compostos por ponto médio renderizam através do mesmo endpoint com o mesmo sistema de temas.

chart_type='Composite' na fachada unificada ChartRenderer

Precisão Swiss Ephemeris

Dados de efemérides NASA JPL alimentam cada posição planetária independente do tema ou tipo de mapa.

Precisão sub-arco-segundo pra todos os corpos celestes

23 Sistemas de Casas

Placidus, Whole Sign, Equal House, Koch, Regiomontanus, Campanus, Morinus, Porphyry, Topocentric, e mais 14.

Seleção de sistema de casas independente do tema

Sobrescrita custom_settings

Passe um dict custom_settings pra sobrescrever qualquer campo do mapa por requisição — cores, cores de glifos, cores de papel, cores zodiacais.

Mesclado sobre os defaults do tema; o chamador vence

O Que é a API de Renderização de Mapas? A História do Kerykeion Vendored

3 presets de tema, 10+ params de customização, saída de nível Astrocom, Parte da Fortuna, planetas uranianos

A API de Renderização de Mapas transforma dados de nascimento num mapa astrológico SVG customizável. Fizemos vendoring do Kerykeion v4.26.3 na nossa própria base de código pra poder aplicar patches — e isso nos deu eixos mais grossos, rótulos externos, números de casas centralizados, um glifo de Parte da Fortuna, suporte a planetas hipotéticos, e um pós-processador que oculta pontos selecionados das linhas de aspectos. Você recebe três presets de tema na caixa (minimal, minimal-dark, astrocom-dark), 10+ parâmetros de mapa, e um endpoint que trata mapas natais, sinastrias, trânsitos e compostos. O tempo de renderização fica abaixo de 500ms.

Por que fizemos vendoring do Kerykeion v4.26.3 ao invés de importar?

Kerykeion é uma boa biblioteca open-source pra mapas, mas o renderer upstream é travado: larguras de eixo fixas, sem Parte da Fortuna, sem hooks pra ocultar pontos das linhas de aspectos, e sem caminho pros planetas hipotéticos da Escola de Hamburgo.

Copiamos os módulos relevantes pra app/vendor/kerykeion_charts/ na versão 4.26.3, mantivemos a superfície de import compatível, e adicionamos um PATCHES.md que rastreia cada mudança.

Quatro patches numerados (PATCH-01 até PATCH-04) mais uma injeção de Parte da Fortuna cobrem os novos parâmetros.

Dois temas que vêm com a biblioteca upstream (light, dark, dark-high-contrast, classic) ainda funcionam como camadas base.

Nossos presets ficam por cima dessas variáveis CSS base, então cores de papel em modo escuro, cores de setores zodiacais e cores de glifos herdam direitinho.

A abordagem vendor faz com que cada upgrade upstream vire um code review — não uma quebra surpresa em produção.

Kerykeion v4.26.3 vendored — somos donos da linha de patches

1 min read

Qual tema escolher: minimal, minimal-dark ou astrocom-dark?

Três presets cobrem a maioria dos casos.

Minimal é um tema light limpo: linhas de aspecto suaves, setores zodiacais planos, papel claro.

Use pra embeds em blogs, cards sociais e apps que querem um mapa que não brigue com o resto da página.

Minimal-dark inverte o papel pra cinza escuro, mantém as cores de aspectos legíveis, e funciona pra UIs escuras.

Astrocom-dark é a contraparte escura do preset Astrocom: eixos mais grossos, rótulos AC/MC/DC/IC externos, números de casas centralizados, cor de eixo unificada (#6b7280) — basicamente o visual do mapa Astrodienst num wrapper escuro.

Passe theme=astrocom pra versão light, theme=astrocom-dark pra escuro, theme=minimal pra um visual light limpo, ou theme=minimal-dark pro mesmo no escuro.

Você ainda pode sobrescrever qualquer parâmetro subjacente por requisição, então um tema é um ponto de partida — não uma jaula.

3 presets: minimal, minimal-dark, astrocom-dark — mais astrocom (light)

1 min read

O que é o preset Astrocom e por que ele importa?

Astrocom é o visual que você vê no astro.com — o mapa Astrodienst que astrólogos profissionais leem desde os anos 90.

É o estilo de referência de fato pra tradição ocidental: linhas de eixo pretas e grossas, rótulos AC/MC/DC/IC logo fora da roda, números de casas num anel interno em vez de perto das cúspides, e uma única cor neutra pros eixos pra que as quatro direções cardeais não briguem entre si.

O preset astrocom combina PATCH-01 (axis_stroke_width=3.0), PATCH-02 (axes_labels_position='outside'), PATCH-03 (house_numbers_position='center'), e PATCH-04 (axis_color='#444444' pra light, '#6b7280' pra dark).

Defina theme=astrocom e você recebe os quatro de uma vez.

Pra plataformas voltadas a astrólogos tradicionais, esse preset sozinho costuma ser o motivo dos times trocarem de fornecedor.

O tema classic do Kerykeion tem cores por eixo (laranja/preto/azul/vermelho) que chocam com um layout mais sóbrio — astrocom unifica tudo.

Preset Astrocom = visual de referência astro.com num parâmetro

1 min read

Como funcionam os parâmetros por elemento?

Cinco parâmetros deixam você sobrescrever o preset numa única requisição.

axis_stroke_width aceita um float — 1.0 é padrão, 3.0 imita astro.com, 5.0 é grossura de pôster de parede.

axes_labels_position aceita 'outside' (logo após a roda, negrito), 'center' (anel interno pequeno, peso médio), ou null (sem rótulos de eixo — comportamento pré-patch do Kerykeion).

house_numbers_position aceita 'center' (anel interno pequeno em 78% do raio, fonte 10px, opacidade 0.7) ou 'near_cusp' (padrão, 14px, ao lado de cada cúspide).

hide_points_in_aspects aceita um array de nomes de pontos: passe ['Chiron','Lilith'] e Quíron e Lilith ficam na roda mas somem de toda linha de aspecto e da linha na grade de aspectos.

hide_axes_visually aceita um array de nomes de eixo: o AC fica no cálculo, mas nenhuma linha é desenhada — útil pra embeds onde você quer uma roda limpa.

axis_color sobrescreve as variáveis CSS por eixo com uma única cor unificada.

5 parâmetros de patch: axis_stroke_width, axes_labels_position, house_numbers_position, hide_points_in_aspects, hide_axes_visually

1 min read

O que é o endpoint /render/transit-gantt?

/api/v3/render/transit-gantt é um renderer SVG pra janelas de timing de aspectos.

Em vez de uma roda, você recebe um gráfico de barras horizontais: as linhas são pares planetários (ex.

Saturno em trânsito sobre Sol natal), as colunas são datas, e cada barra marca a janela em que o aspecto está em orbe.

Datas de hit exato aparecem como marcações verticais dentro de cada barra.

A saída é a visão de dashboard de previsão que astrólogos e apps de timing precisam — quando esse trânsito começa, quando pega o pico, quando termina.

As barras são coloridas por tipo de aspecto (conjunção, quadratura, oposição, trígono, sextil) e o SVG vem com camadas nomeadas (g id='bars', g id='ticks', g id='axis') pra que CSS downstream possa reestilizar sem parsear geometria.

Spec em docs/SPECS/06_timing_visualizations.md §A, renderer em app/services/render/transit_gantt.py.

Intervalo de tempo, aspectos incluídos e tolerâncias de orbe são parâmetros da requisição.

/render/transit-gantt — SVG em barras horizontais pras janelas de timing de aspectos

1 min read

O que é o endpoint /render/graphic-ephemeris?

/api/v3/render/graphic-ephemeris é a efeméride gráfica estilo Ebertin com 4ª harmônica — um pilar da cosmobiologia desde os anos 1940.

O eixo X é tempo.

O eixo Y é a grade 22.5° (360° / 16 — a 4ª harmônica, ou quarta divisão do dial básico de 22.5°).

Cada planeta plota como uma linha contínua que volta ao topo quando cruza 22.5°.

Quando duas linhas se encontram na grade, isso é um aspecto duro pela lógica da 4ª harmônica: conjunção, oposição, quadratura ou semi-quadratura.

Praticantes de cosmobiologia leem esses encontros como datas de evento.

Opções de harmônica: 1 (longitude crua), 2, 4 (padrão Ebertin), 8 ou 16.

Janela de tempo padrão é 12 meses, configurável.

Saída é SVG com camadas nomeadas (g id='planet-sun', g id='planet-moon', etc.) pra que cada linha planetária seja selecionável por CSS.

Spec: docs/SPECS/06_timing_visualizations.md §B.

Renderer: app/services/render/graphic_ephemeris.py.

/render/graphic-ephemeris — grade 22.5° da 4ª harmônica de Ebertin

1 min read

Use Cases

Plataformas de Astrólogos Tradicionais

theme=astrocom entrega o visual do mapa astro.com no qual profissionais já confiam

Apps Modernos em Modo Escuro

theme=minimal-dark ou astrocom-dark combinam com UI escura sem trabalho extra de CSS

Mapas Helenísticos com Parte da Fortuna

Adicione 'part_of_fortune' a active_points — glifo e linha de aspectos renderizam automaticamente

Uraniana / Escola de Hamburgo

8 planetas hipotéticos (de Cupido a Poseidon) renderizam com seus próprios glifos

Embeds Focados em Aspectos

hide_points_in_aspects tira corpos menores das linhas mantendo a roda intacta

Sinastria, Trânsito, Composto

Um endpoint, mesmo sistema de temas, cabeçalho duplo preservado entre tipos

Technical Specifications

Namespace de Render	/api/v3/render/* (chart, transit-gantt, graphic-ephemeris)
Intervalo do Gantt de Trânsitos	12 meses padrão; start/end configuráveis
Harmônica da Efeméride Gráfica	1, 2, 4 (padrão Ebertin), 8 ou 16
Nomeação das Camadas SVG	g id='axes' \| 'aspects' \| 'planets' \| 'bars' \| 'ticks'
Base do Renderer	Kerykeion v4.26.3 vendored + 4 patches numerados
Presets de Tema	minimal, minimal-dark, astrocom, astrocom-dark
Temas Nativos Kerykeion	light, dark, dark-high-contrast, classic
axis_stroke_width	Float — 1.0 padrão, 3.0 astrocom, até 5.0
axes_labels_position	outside \| center \| null (sem rótulos)
house_numbers_position	center (anel interno em r*0.78) \| near_cusp (padrão)
axis_color	String hex — sobrescreve variáveis CSS por eixo
hide_points_in_aspects	Array de nomes de ponto — pós-processador remove das linhas de aspecto
hide_axes_visually	Array de nomes de eixo — mantido no cálculo, removido do SVG
active_points	Inclui part_of_fortune + 8 hipotéticos Uranianos
Tipos de Mapa	Natal, Sinastria, Trânsito, Composto (um endpoint)
Formatos de Saída	SVG principal; PNG, JPEG, WebP, PDF via conversão
Tempo de Renderização	<500ms típico, <1s pior caso
Sistemas de Casas	23 suportados (Placidus, Whole Sign, Koch, etc.)
Precisão de Cálculo	Swiss Ephemeris (dados NASA JPL)
Sobrescrita custom_settings	dict custom_settings — qualquer campo, por requisição

Kerykeion Vendored + Patches vs Kerykeion Padrão vs Concorrentes Fechados

Feature	Astrology API	Others
Cobertura de Visualização	Roda + Gantt de trânsitos + efeméride gráfica (3 endpoints de render)	Só rodas natais
Base de Código	Kerykeion v4.26.3 vendored — nossa linha de patches	pip install padrão OU SDK fechado
Saída Estilo Astrocom	theme=astrocom — um parâmetro	Indisponível; estilo de mapa travado
Presets de Tema	minimal, minimal-dark, astrocom, astrocom-dark	Visual fixo ou 1-2 temas
Espessura do Traço de Eixo	Param float, 1.0 a 5.0+	Fixo em 1px
Posição dos Números de Casas	center \| near_cusp	Apenas perto da cúspide
Ocultar Pontos dos Aspectos	Array hide_points_in_aspects — pós-processador	Tudo ou nada; remove do mapa inteiro
Parte da Fortuna	Fórmula + glifo + linha na grade de aspectos	Não suportado (Kerykeion); varia em outros
Planetas Hipotéticos	8 Uranianos (de Cupido a Poseidon) nativos	Raramente suportado
Tipos de Mapa	Natal, Sinastria, Trânsito, Composto — um endpoint	Frequentemente endpoints ou bibliotecas separadas
Caminho de Upgrade Upstream	Code review a cada bump — PATCHES.md rastreado	Quebras silenciosas em upgrade do pip
Tempo de Renderização	<500ms típico	1-3 segundos comum

APIs de Astrologia Relacionadas

SVG de Gantt de Trânsitos

Visualização em barras horizontais das janelas de timing de aspectos

SVG de Efeméride Gráfica

Grade 22.5° da 4ª harmônica estilo Ebertin

API Natal

Cálculos de mapa natal que alimentam o renderer

Parte da Fortuna

Lote helenístico — fórmula, glifo, linha de aspectos

Planetas Hipotéticos

Escola de Hamburgo / Uranianos — 8 hipotéticos nativos

API de Sinastria

Mapas de relacionamento com o mesmo sistema de temas

API de Composto

Mapas compostos por ponto médio pra casais

API de Timing

SVGs de age-bands e bi-wheel timing

API de Trânsitos

Trânsitos ao vivo sobre uma roda natal

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

Precos Simples e Transparentes

Comece gratis, escale conforme cresce. Sem taxas ocultas.

Sempre Gratis

Sem Cartao de Credito

Perfeito para aprender, testar e pequenos projetos pessoais

50 chamadas API/mes

Mapas natais basicos

5 sistemas de casas

Suporte da comunidade

Pro

$11/mes

Para apps pequenos e projetos pessoais

Todos os endpoints basicos
12 sistemas de casas
Suporte por email

Melhor Valor

Pro Plus

$21/mes

Para apps em crescimento e trafego medio

Todos os endpoints aprimorados
18 sistemas de casas
Interpretacoes com IA
Suporte email prioritario

Ultra

$37/mes

Para aplicacoes de astrologia profissionais

Credit math ↓

Todos os endpoints premium
23 sistemas de casas
Interpretacoes IA avancadas
Suporte prioritario

Planos de Alto Volume

Para aplicacoes em escala empresarial

Business

$99/mes

Para aplicacoes de alto volume

Credit math ↓

TODOS os endpoints
Pronto para marca branca
Ajuste fino de IA personalizado
Suporte telefonico

ILIMITADO

Enterprise

$399+por mes

Requisicoes ilimitadas com infraestrutura dedicada

Infraestrutura de servidor dedicado
Sub-300ms garantido
Suporte dedicado 24/7
99,99% uptime SLA

Todos os planos incluem documentacao completa e SDKs

Duvidas? Fale com nossa equipe

Perguntas Frequentes sobre a API de Renderização de Mapas

Temas, patches, Parte da Fortuna, planetas hipotéticos, e tudo no meio

APIs de Astrologia Relacionadas

A API de Renderização de Mapas funciona melhor junto com o resto do stack. Adicione

SVG de Gantt de trânsitos SVG de efeméride gráfica cálculos de mapa natal Parte da Fortuna planetas hipotéticos mapas de sinastria mapas compostos rodas de timing trânsitos ao vivo

Três Renderers SVG, Um Namespace

Rodas de mapa, barras Gantt de trânsitos e efeméride gráfica na grade 22.5° da 4ª harmônica de Ebertin — tudo sob /api/v3/render/*. Temas Astrocom, camadas SVG nomeadas, Parte da Fortuna, planetas Uranianos.

Começar Grátis Ver Documentação

Gantt de trânsitos + SVG de efeméride gráfica

Grade 22.5° da 4ª harmônica de Ebertin

Camadas SVG nomeadas pra estilização CSS

<500ms tempo de renderização

Disponível no plano Ultra e acima

API de Renderização de Mapas: SVG de Nível Astrocom, Suas Regras

Rodas Natais Sozinhas Não Sustentam Dashboards de Previsão

Um Namespace Render: Rodas, Barras Gantt, Efeméride Gráfica

Performance da Renderização de Mapas

SVG Customizável, do Tema ao Eixo Individual

SVG de Gantt de Trânsitos

SVG de Efeméride Gráfica

Padrão da 4ª Harmônica de Ebertin

Camadas SVG Nomeadas

Namespace /render/*

Preset de Tema Astrocom

Tema Astrocom-Dark

Tema Minimal

Tema Minimal-Dark

Parâmetro axis_stroke_width

Parâmetro axes_labels_position

Parâmetro house_numbers_position

Glifo de Parte da Fortuna

hide_points_in_aspects

hide_axes_visually

Planetas Hipotéticos

Cabeçalho de Mapa Duplo

Tipo de Mapa Composto

Precisão Swiss Ephemeris

23 Sistemas de Casas

Sobrescrita custom_settings

O Que é a API de Renderização de Mapas? A História do Kerykeion Vendored

Por que fizemos vendoring do Kerykeion v4.26.3 ao invés de importar?

Qual tema escolher: minimal, minimal-dark ou astrocom-dark?

O que é o preset Astrocom e por que ele importa?

Como funcionam os parâmetros por elemento?

O que é o endpoint /render/transit-gantt?

O que é o endpoint /render/graphic-ephemeris?

Use Cases

Plataformas de Astrólogos Tradicionais

Apps Modernos em Modo Escuro

Mapas Helenísticos com Parte da Fortuna

Uraniana / Escola de Hamburgo

Embeds Focados em Aspectos

Sinastria, Trânsito, Composto

Technical Specifications

Kerykeion Vendored + Patches vs Kerykeion Padrão vs Concorrentes Fechados

APIs de Astrologia Relacionadas

SVG de Gantt de Trânsitos

SVG de Efeméride Gráfica

API Natal

Parte da Fortuna

Planetas Hipotéticos

API de Sinastria

API de Composto

API de Timing

API de Trânsitos

References & Standards

Precos Simples e Transparentes

Sempre Gratis

Pro

Pro Plus

Ultra

Planos de Alto Volume

Business

Enterprise

Perguntas Frequentes sobre a API de Renderização de Mapas

O que é o endpoint /render/transit-gantt?

O que é o endpoint /render/graphic-ephemeris?

O que é a cosmobiologia de Ebertin?

Por que a 4ª harmônica 22.5° é o padrão?

As camadas SVG são nomeadas pra estilização downstream?

Quais temas de mapa estão disponíveis?

Posso obter um mapa estilo Astrocom?

Como customizo a espessura dos eixos?

Posso ocultar planetas específicos das linhas de aspecto?

A API renderiza Parte da Fortuna?

Vocês suportam planetas Uranianos / Escola de Hamburgo?

Posso renderizar mapas de sinastria, trânsito e composto?

Por que vocês fizeram vendoring do Kerykeion v4.26.3 ao invés de só importar?

Onde os números de casas vão com house_numbers_position='center'?

O que hide_axes_visually faz?

Quão rápida é a renderização?

Quais formatos de saída eu recebo?

Posso sobrescrever configs de tema por requisição?