Rendering dei Temi

Genera splendide immagini SVG e PNG dei temi.

Temi SVG

Genera un tema natale SVG usando i parametri della query:

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"

Temi PNG

Converti in 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

Tipi di Tema

Endpoint	Descrizione
/api/chart/image.svg	Tema natale come SVG
/api/chart/image.png	Tema natale come PNG
/api/chart/image.svg con parametri transit.*	Tema biruota di transito
/api/chart/composite.svg	Tema composito (punti medi)
/api/chart/composite.png	Tema composito come PNG

Tema Biruota di Transito

Aggiungi parametri di transito per renderizzare un tema biruota con la ruota natale (interna) e quella di transito (esterna):

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"

Parametri di Transito

Parametro	Obbligatorio	Descrizione
transit.dateTime	Sì	Data/ora del transito (YYYY-MM-DDTHH:mm)
transit.timezone	Sì	Fuso orario del transito
transit.longitude	No	Longitudine della posizione di transito (predefinito: natale)
transit.latitude	No	Latitudine della posizione di transito (predefinito: natale)

Tema Composito

Genera un tema composito che mostra i punti medi tra due temi natali:

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"

Parametri della Query

Parametri del Tema Natale

Parametro	Obbligatorio	Descrizione
width	Sì	Larghezza del tema in pixel
height	Sì	Altezza del tema in pixel
dateTime	Sì	Data/ora di nascita (YYYY-MM-DDTHH:mm)
location.longitude	Sì	Longitudine del luogo di nascita
location.latitude	Sì	Latitudine del luogo di nascita
location.timezone	Sì	Fuso orario del luogo di nascita (formato IANA)

Parametri del Tema Composito

Parametro	Obbligatorio	Descrizione
width	Sì	Larghezza del tema in pixel
height	Sì	Altezza del tema in pixel
person1.dateTime	Sì	Data/ora di nascita della persona 1
person1.timezone	Sì	Fuso orario della persona 1
person1.longitude	Sì	Longitudine della persona 1
person1.latitude	Sì	Latitudine della persona 1
person2.dateTime	Sì	Data/ora di nascita della persona 2
person2.timezone	Sì	Fuso orario della persona 2
person2.longitude	Sì	Longitudine della persona 2
person2.latitude	Sì	Latitudine della persona 2

Intestazioni della Risposta

Gli endpoint dei temi restituiscono i tipi di contenuto appropriati:

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

Incorporare i Temi

Usa l'SVG restituito direttamente nell'HTML:

<div class="chart-container">
  <!-- SVG content from API -->
</div>

O come sorgente immagine con URL dati:

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

Chart2 - Temi di Nuova Generazione

AstroAPI offre un motore di rendering dei temi di nuova generazione con supporto per temi grafici e animazioni.

Endpoint

Endpoint	Descrizione	Modulo Richiesto
/api/chart2/natal.svg	Tema natale (SVG)	module:natal-calc
/api/chart2/natal.png	Tema natale (PNG)	module:natal-calc
/api/chart2/transit.svg	Biruota di transito (SVG)	module:transit-calc
/api/chart2/transit.png	Biruota di transito (PNG)	module:transit-calc
/api/chart2/synastry.svg	Tema di sinastria (SVG)	module:synastry-calc
/api/chart2/synastry.png	Tema di sinastria (PNG)	module:synastry-calc
/api/chart2/composite.svg	Tema composito (SVG)	module:synastry-calc
/api/chart2/composite.png	Tema composito (PNG)	module:synastry-calc
/api/chart2/animated-transit.svg	Transito animato (SVG)	module:transit-calc

Utilizzo di Base

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"

Temi Grafici Preimpostati

Tema	Descrizione
default	Sfondo bianco classico con elementi colorati
classic	Aspetto astrologico tradizionale
dark	Tema scuro moderno con colori vivaci
minimal	Pulito, con meno rumore visivo
colorful	Colori dei pianeti vivaci
nextgen	Moderno con linee degli aspetti curve, effetti bagliore e sfumature
vintage	Stile vecchia pergamena/manoscritto con tonalità seppia
neon	Cyberpunk con colori neon brillanti su sfondo nero
pastel	Colori pastello morbidi e rilassanti
print	Alto contrasto bianco/nero, ottimizzato per la stampa

Personalizzazione del Tema

Personalizza le proprietà individuali del tema tramite parametri della query:

Parametro	Descrizione
theme.background	Colore di sfondo (hex)
theme.foreground	Colore di primo piano (hex)
theme.strokeOnly	Modalità solo contorno (true/false)
theme.symbolScale	Fattore di scala dei simboli
theme.showDegrees	Mostra etichette dei gradi (true/false)
theme.showHouseNumbers	Mostra numeri delle case (true/false)
theme.showRuler	Mostra righello (true/false)
theme.signBackgroundOpacity	Opacità dello sfondo dei segni (0-1)

Temi di Sinastria & Composito

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"

Transito Animato

Genera un SVG animato che mostra la progressione del transito nel 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"

Parametro	Descrizione
target.dateTime	Data di fine per l'animazione
animation.duration	Durata dell'animazione in millisecondi
animation.easing	Funzione di easing (predefinito: easeInOut)
animation.loop	Ripeti l'animazione (predefinito: false)