Renderização de Mapas

Gera belas imagens de mapas em SVG e PNG.

Mapas SVG

Gera um mapa natal em SVG usando parâmetros de consulta:

curl -X GET "https://api.astroapi.cloud/api/chart/image.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=-0.1278&location.latitude=51.5074&location.timezone=Europe/London" \
  -H "X-Api-Key: your-api-key"

Mapas PNG

Converte para formato PNG:

curl -X GET "https://api.astroapi.cloud/api/chart/image.png?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=-0.1278&location.latitude=51.5074&location.timezone=Europe/London" \
  -H "X-Api-Key: your-api-key" \
  --output chart.png

Tipos de Mapa

Endpoint	Descrição
/api/chart/image.svg	Mapa natal em SVG
/api/chart/image.png	Mapa natal em PNG
/api/chart/image.svg com parâmetros transit.*	Mapa bi-roda de trânsito
/api/chart/composite.svg	Mapa composto (pontos médios)
/api/chart/composite.png	Mapa composto em PNG

Mapa Bi-roda de Trânsito

Adiciona parâmetros de trânsito para renderizar um mapa bi-roda com a roda natal (interior) e de trânsito (exterior):

curl -X GET "https://api.astroapi.cloud/api/chart/image.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=-0.1278&location.latitude=51.5074&location.timezone=Europe/London&transit.dateTime=2024-01-15T12:00&transit.timezone=Europe/London" \
  -H "X-Api-Key: your-api-key"

Parâmetros de Trânsito

Parâmetro	Obrigatório	Descrição
transit.dateTime	Sim	Data/hora do trânsito (YYYY-MM-DDTHH:mm)
transit.timezone	Sim	Fuso horário do trânsito
transit.longitude	Não	Longitude do local do trânsito (usa o natal por padrão)
transit.latitude	Não	Latitude do local do trânsito (usa o natal por padrão)

Mapa Composto

Gera um mapa composto mostrando os pontos médios entre dois mapas natais:

curl -X GET "https://api.astroapi.cloud/api/chart/composite.svg?width=800&height=800&person1.dateTime=1990-06-15T14:30&person1.timezone=Europe/London&person1.longitude=-0.1278&person1.latitude=51.5074&person2.dateTime=1988-03-22T09:15&person2.timezone=Europe/Paris&person2.longitude=2.3522&person2.latitude=48.8566" \
  -H "X-Api-Key: your-api-key"

Parâmetros de Consulta

Parâmetros do Mapa Natal

Parâmetro	Obrigatório	Descrição
width	Sim	Largura do mapa em píxeis
height	Sim	Altura do mapa em píxeis
dateTime	Sim	Data/hora de nascimento (YYYY-MM-DDTHH:mm)
location.longitude	Sim	Longitude do local de nascimento
location.latitude	Sim	Latitude do local de nascimento
location.timezone	Sim	Fuso horário do local de nascimento (formato IANA)

Parâmetros do Mapa Composto

Parâmetro	Obrigatório	Descrição
width	Sim	Largura do mapa em píxeis
height	Sim	Altura do mapa em píxeis
person1.dateTime	Sim	Data/hora de nascimento da pessoa 1
person1.timezone	Sim	Fuso horário da pessoa 1
person1.longitude	Sim	Longitude da pessoa 1
person1.latitude	Sim	Latitude da pessoa 1
person2.dateTime	Sim	Data/hora de nascimento da pessoa 2
person2.timezone	Sim	Fuso horário da pessoa 2
person2.longitude	Sim	Longitude da pessoa 2
person2.latitude	Sim	Latitude da pessoa 2

Cabeçalhos de Resposta

Os endpoints de mapas devolvem tipos de conteúdo adequados:

• SVG: image/svg+xml
• PNG: image/png

Incorporar Mapas

Usa o SVG devolvido directamente em HTML:

<div class="chart-container">
  <!-- Conteúdo SVG da API -->
</div>

Ou usa como fonte de imagem com URL de dados:

<img src="data:image/svg+xml;base64,..." alt="Natal Chart" />

Chart2 — Motor de Próxima Geração

A AstroAPI oferece um motor de renderização de mapas de próxima geração com suporte de temas e animações.

Endpoints

Endpoint	Descrição	Módulo Necessário
/api/chart2/natal.svg	Mapa natal (SVG)	module:natal-calc
/api/chart2/natal.png	Mapa natal (PNG)	module:natal-calc
/api/chart2/transit.svg	Bi-roda de trânsito (SVG)	module:transit-calc
/api/chart2/transit.png	Bi-roda de trânsito (PNG)	module:transit-calc
/api/chart2/synastry.svg	Mapa de sinastria (SVG)	module:synastry-calc
/api/chart2/synastry.png	Mapa de sinastria (PNG)	module:synastry-calc
/api/chart2/composite.svg	Mapa composto (SVG)	module:synastry-calc
/api/chart2/composite.png	Mapa composto (PNG)	module:synastry-calc
/api/chart2/animated-transit.svg	Trânsito animado (SVG)	module:transit-calc

Utilização Básica

curl -X GET "https://api.astroapi.cloud/api/chart2/natal.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=4.89&location.latitude=52.37&location.timezone=Europe/Amsterdam&theme=dark" \
  -H "X-Api-Key: your-api-key"

Temas Predefinidos

Tema	Descrição
default	Fundo branco clássico com elementos coloridos
classic	Aparência astrológica tradicional
dark	Tema escuro moderno com cores vivas
minimal	Limpo, com menos ruído visual
colorful	Cores planetárias vibrantes
nextgen	Moderno com linhas de aspectos curvas, efeitos de brilho e gradientes
vintage	Estilo pergaminho/manuscrito antigo com tons sépia
neon	Cyberpunk com cores néon brilhantes sobre preto
pastel	Cores pastel suaves e calmantes
print	Alto contraste preto/branco, optimizado para impressão

Substituições de Tema

Personaliza propriedades individuais do tema via parâmetros de consulta:

Parâmetro	Descrição
theme.background	Cor de fundo (hex)
theme.foreground	Cor de primeiro plano (hex)
theme.strokeOnly	Modo apenas contorno (true/false)
theme.symbolScale	Factor de escala dos símbolos
theme.showDegrees	Mostrar etiquetas de graus (true/false)
theme.showHouseNumbers	Mostrar números de casas (true/false)
theme.showRuler	Mostrar régua (true/false)
theme.signBackgroundOpacity	Opacidade do fundo do signo (0–1)

Mapas de Sinastria e Compostos

curl -X GET "https://api.astroapi.cloud/api/chart2/synastry.svg?width=800&height=800&person1.dateTime=1990-06-15T14:30&person1.timezone=Europe/Amsterdam&person1.longitude=4.89&person1.latitude=52.37&person2.dateTime=1992-03-20T09:15&person2.timezone=Europe/London&person2.longitude=-0.12&person2.latitude=51.50" \
  -H "X-Api-Key: your-api-key"

Trânsito Animado

Gera SVG animado mostrando a progressão do trânsito ao longo do tempo:

curl -X GET "https://api.astroapi.cloud/api/chart2/animated-transit.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=4.89&location.latitude=52.37&location.timezone=Europe/Amsterdam&transit.dateTime=2025-01-01T12:00&transit.timezone=Europe/Amsterdam&target.dateTime=2025-12-31T23:59&animation.duration=3000" \
  -H "X-Api-Key: your-api-key"

Parâmetro	Descrição
target.dateTime	Data de fim para a animação
animation.duration	Duração da animação em milissegundos
animation.easing	Função de easing (padrão: easeInOut)
animation.loop	Repetir animação em loop (padrão: false)