Skip to content

Rendering dei Temi ​

Genera splendide immagini SVG e PNG dei temi.

Temi SVG ​

Genera un tema natale SVG usando i parametri della query:

bash
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"
javascript
const response = await fetch(
    "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",
    {
        headers: {
            "X-Api-Key": "your-api-key"
        }
    }
);

const svg = await response.text();
python
import requests

response = requests.get(
    "https://api.astroapi.cloud/api/chart/image.svg",
    headers={
        "X-Api-Key": "your-api-key"
    },
    params={
        "width": 800,
        "height": 800,
        "dateTime": "1990-06-15T14:30",
        "location.longitude": -0.1278,
        "location.latitude": 51.5074,
        "location.timezone": "Europe/London"
    }
)

svg = response.text

Temi PNG ​

Converti in formato PNG:

bash
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
javascript
const response = await fetch(
    "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",
    {
        headers: {
            "X-Api-Key": "your-api-key"
        }
    }
);

const png = await response.blob();
python
import requests

response = requests.get(
    "https://api.astroapi.cloud/api/chart/image.png",
    headers={
        "X-Api-Key": "your-api-key"
    },
    params={
        "width": 800,
        "height": 800,
        "dateTime": "1990-06-15T14:30",
        "location.longitude": -0.1278,
        "location.latitude": 51.5074,
        "location.timezone": "Europe/London"
    }
)

with open("chart.png", "wb") as f:
    f.write(response.content)

Tipi di Tema ​

EndpointDescrizione
/api/chart/image.svgTema natale come SVG
/api/chart/image.pngTema natale come PNG
/api/chart/image.svg con parametri transit.*Tema biruota di transito
/api/chart/composite.svgTema composito (punti medi)
/api/chart/composite.pngTema 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):

bash
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 ​

ParametroObbligatorioDescrizione
transit.dateTimeSìData/ora del transito (YYYY-MM-DDTHH:mm)
transit.timezoneSìFuso orario del transito
transit.longitudeNoLongitudine della posizione di transito (predefinito: natale)
transit.latitudeNoLatitudine della posizione di transito (predefinito: natale)

Tema Composito ​

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

bash
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 ​

ParametroObbligatorioDescrizione
widthSìLarghezza del tema in pixel
heightSìAltezza del tema in pixel
dateTimeSìData/ora di nascita (YYYY-MM-DDTHH:mm)
location.longitudeSìLongitudine del luogo di nascita
location.latitudeSìLatitudine del luogo di nascita
location.timezoneSìFuso orario del luogo di nascita (formato IANA)

Parametri del Tema Composito ​

ParametroObbligatorioDescrizione
widthSìLarghezza del tema in pixel
heightSìAltezza del tema in pixel
person1.dateTimeSìData/ora di nascita della persona 1
person1.timezoneSìFuso orario della persona 1
person1.longitudeSìLongitudine della persona 1
person1.latitudeSìLatitudine della persona 1
person2.dateTimeSìData/ora di nascita della persona 2
person2.timezoneSìFuso orario della persona 2
person2.longitudeSìLongitudine della persona 2
person2.latitudeSì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:

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

O come sorgente immagine con URL dati:

html
<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 ​

EndpointDescrizioneModulo Richiesto
/api/chart2/natal.svgTema natale (SVG)module:natal-calc
/api/chart2/natal.pngTema natale (PNG)module:natal-calc
/api/chart2/transit.svgBiruota di transito (SVG)module:transit-calc
/api/chart2/transit.pngBiruota di transito (PNG)module:transit-calc
/api/chart2/synastry.svgTema di sinastria (SVG)module:synastry-calc
/api/chart2/synastry.pngTema di sinastria (PNG)module:synastry-calc
/api/chart2/composite.svgTema composito (SVG)module:synastry-calc
/api/chart2/composite.pngTema composito (PNG)module:synastry-calc
/api/chart2/animated-transit.svgTransito animato (SVG)module:transit-calc

Utilizzo di Base ​

bash
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 ​

TemaDescrizione
defaultSfondo bianco classico con elementi colorati
classicAspetto astrologico tradizionale
darkTema scuro moderno con colori vivaci
minimalPulito, con meno rumore visivo
colorfulColori dei pianeti vivaci
nextgenModerno con linee degli aspetti curve, effetti bagliore e sfumature
vintageStile vecchia pergamena/manoscritto con tonalità seppia
neonCyberpunk con colori neon brillanti su sfondo nero
pastelColori pastello morbidi e rilassanti
printAlto contrasto bianco/nero, ottimizzato per la stampa

Personalizzazione del Tema ​

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

ParametroDescrizione
theme.backgroundColore di sfondo (hex)
theme.foregroundColore di primo piano (hex)
theme.strokeOnlyModalità solo contorno (true/false)
theme.symbolScaleFattore di scala dei simboli
theme.showDegreesMostra etichette dei gradi (true/false)
theme.showHouseNumbersMostra numeri delle case (true/false)
theme.showRulerMostra righello (true/false)
theme.signBackgroundOpacityOpacità dello sfondo dei segni (0-1)

Temi di Sinastria & Composito ​

bash
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:

bash
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"
ParametroDescrizione
target.dateTimeData di fine per l'animazione
animation.durationDurata dell'animazione in millisecondi
animation.easingFunzione di easing (predefinito: easeInOut)
animation.loopRipeti l'animazione (predefinito: false)

AstroAPI Documentation