Temi Natali

Calcola temi natali completi con posizioni planetarie, cuspidi delle case e aspetti.

Calcolo di Base

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

Parametri

Parametro	Tipo	Obbligatorio	Descrizione
datetime	string	Sì	Data e ora in formato ISO 8601
latitude	number	Sì	Latitudine (da -90 a 90)
longitude	number	Sì	Longitudine (da -180 a 180)
timezone	string	Sì	Identificatore di fuso orario IANA
houseSystem	string	No	Sistema delle case (predefinito: "placidus")

Sistemi delle Case

• placidus - Placidus (predefinito)
• koch - Koch
• equal - Case Uguali
• whole - Segni Interi
• campanus - Campanus
• regiomontanus - Regiomontanus
• porphyry - Porfirio

Risposta

{
  "data": {
    "type": "natal-chart",
    "attributes": {
      "planets": {
        "sun": { "longitude": 84.5, "latitude": 0, "sign": "gemini", "house": 10 },
        "moon": { "longitude": 245.2, "latitude": -3.1, "sign": "sagittarius", "house": 4 }
      },
      "houses": {
        "1": { "cusp": 180.5, "sign": "libra" },
        "2": { "cusp": 210.3, "sign": "scorpio" }
      },
      "aspects": [
        { "planet1": "sun", "planet2": "moon", "aspect": "opposition", "orb": 0.7 }
      ]
    }
  }
}

Corpi Celesti Inclusi

Per impostazione predefinita, sono inclusi i seguenti corpi celesti:

• Sole, Luna
• Mercurio, Venere, Marte, Giove, Saturno, Urano, Nettuno, Plutone
• Nodo Nord, Nodo Sud
• Chirone, Lilith (Luna Nera)
• Parte di Fortuna

Luna & Sole

Calcola la fase lunare, l'illuminazione, gli orari di alba/tramonto e i dati sulla posizione del Sole.

POST /api/calc/moon-sun

curl -X POST "https://api.astroapi.cloud/api/calc/moon-sun" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "2024-06-15T12:00",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    }
  }'

Parametri

Parametro	Tipo	Obbligatorio	Descrizione
dateTime	string	Sì	Data/ora nel formato YYYY-MM-DDTHH:mm
location.latitude	number	Sì	Latitudine (da -90 a 90)
location.longitude	number	Sì	Longitudine (da -180 a 180)
location.timezone	string	Sì	Identificatore di fuso orario IANA

Modulo Richiesto

Questo endpoint richiede il modulo module:moon.

Risposta

{
  "data": {
    "moon": {
      "phaseName": "Waxing Gibbous",
      "phase": 0.62,
      "illumination": 0.78,
      "age": 9.2,
      "distance": 384400,
      "diameterDegrees": 0.52,
      "rise": "2024-06-15T14:23:00Z",
      "set": "2024-06-16T02:15:00Z"
    },
    "sun": {
      "rise": "2024-06-15T05:18:00Z",
      "set": "2024-06-15T22:03:00Z",
      "transit": "2024-06-15T13:40:00Z",
      "distance": 151820000,
      "diameterDegrees": 0.524,
      "twilight": {
        "civil": {
          "begin": "2024-06-15T04:38:00Z",
          "end": "2024-06-15T22:43:00Z"
        },
        "nautical": {
          "begin": "2024-06-15T03:32:00Z",
          "end": "2024-06-15T23:49:00Z"
        },
        "astronomical": {
          "begin": null,
          "end": null
        }
      }
    }
  }
}

Precisione dei Calcoli

AstroAPI utilizza lo Swiss Ephemeris per calcoli ad alta precisione. Tutte le posizioni vengono calcolate con una precisione al secondo d'arco.

Beta: Motore di Calcolo Alternativo

Funzionalità Sperimentale

Questa funzionalità è in beta e potrebbe avere problemi di precisione. Utilizzala con cautela negli ambienti di produzione.

AstroAPI offre un motore di calcolo alternativo (calc2) che utilizza un'implementazione personalizzata per leggere e valutare direttamente i file di dati SE1 dello Swiss Ephemeris, invece di utilizzare la libreria ufficiale Swiss Ephemeris. Questo motore è ottimizzato per la velocità e può fornire tempi di risposta più rapidi.

Per utilizzare il motore alternativo, includi l'intestazione X-Use-Calc2 nella tua richiesta:

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "X-Use-Calc2: true" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

Differenze Principali

Aspetto	Motore Standard	Motore Calc2 (Beta)
Implementazione	Swiss Ephemeris	Implementazione personalizzata
Fonte Dati	File effemeridi SE1	File effemeridi SE1 (stessi dati)
Velocità	Standard	Potenzialmente più veloce
Precisione	Precisione al secondo d'arco (riferimento)	Possibili lievi deviazioni
Stato	Pronto per la produzione	Beta

Quando Usare Calc2

• Consigliato per: Applicazioni ad alto volume dove la velocità è prioritaria rispetto alla precisione assoluta
• Non consigliato per: Applicazioni che richiedono la massima precisione astronomica

Limitazioni Note

• L'implementazione personalizzata potrebbe produrre risultati leggermente diversi rispetto alla libreria ufficiale Swiss Ephemeris
• È ancora in sviluppo e test attivo
• I risultati dovrebbero essere validati rispetto al motore standard per applicazioni critiche