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/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
houseSystem	string	No	Sistema delle case (predefinito: "placidus")
points	array	No	Punti celesti da calcolare (vedi Punti Disponibili sotto)
orbs	object	No	Valori di orbita personalizzati per tipo di aspetto (es. { "conjunction": 8, "opposition": 6 })
language	string	No	Codice lingua per il contenuto testuale (predefinito: "en")
includeText	boolean	No	Includi testo interpretativo (predefinito: false)
includeReadableEntities	boolean	No	Includi titoli leggibili delle entità (predefinito: false)

Sistemi delle Case

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

Risposta

{
  "data": {
    "dateTime": "1990-06-15T12:30:00.000Z",
    "points": {
      "sun": {
        "pointId": "sun",
        "longitude": 84.5,
        "sign": "gemini",
        "signTitle": "Gemini",
        "degreesInSign": 24.5,
        "degreesInSignDms": [24, 30, 0],
        "houseNumber": 10,
        "houseId": "house-10",
        "retrograde": false,
        "pointTitle": "Sun",
        "houseTitle": "10th House"
      },
      "moon": {
        "pointId": "moon",
        "longitude": 245.2,
        "sign": "sagittarius",
        "signTitle": "Sagittarius",
        "degreesInSign": 5.2,
        "degreesInSignDms": [5, 12, 0],
        "houseNumber": 4,
        "houseId": "house-4",
        "retrograde": false,
        "pointTitle": "Moon",
        "houseTitle": "4th House"
      }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": { "pointId": "descendant", "longitude": 0.5, "sign": "aries" },
      "midheaven": { "pointId": "midheaven", "longitude": 270.2, "sign": "capricorn" },
      "imumCoeli": { "pointId": "imumCoeli", "longitude": 90.2, "sign": "cancer" }
    },
    "houses": {
      "cusps": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 210.3, "longitudeDms": { "degrees": 210, "minutes": 18, "seconds": 0 }, "sign": "scorpio" }
      ],
      "ascmc": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 270.2, "longitudeDms": { "degrees": 270, "minutes": 12, "seconds": 0 }, "sign": "capricorn" }
      ]
    },
    "aspects": [
      {
        "pointA": "sun",
        "pointB": "moon",
        "aspect": "opposition",
        "angle": 160.7,
        "orb": 0.7,
        "applying": false,
        "pointATitle": "Sun",
        "pointBTitle": "Moon",
        "aspectTitle": "Opposition"
      }
    ],
    "chart": {
      "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..."
    }
  }
}

Cuspidi delle Case

Ogni oggetto cuspide include longitude (gradi eclittici), longitudeDms (gradi/minuti/secondi) e sign (ID del segno zodiacale). La prima cuspide (cusps[0]) è l'Ascendente. L'array ascmc contiene l'Ascendente, il MC, l'ARMC e il Vertex.

Punti Disponibili

Usa il parametro points per selezionare quali punti celesti calcolare. Se omesso, viene utilizzato il set predefinito.

Punti Predefiniti

sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, meanNode, trueNode, meanApogee, osculatingApog

Tutti i Punti Disponibili

Point ID	Descrizione
sun	Sole
moon	Luna
mercury	Mercurio
venus	Venere
mars	Marte
jupiter	Giove
saturn	Saturno
uranus	Urano
neptune	Nettuno
pluto	Plutone
meanNode	Nodo Nord Medio
trueNode	Nodo Nord Vero
meanApogee	Lilith Media (Luna Nera)
osculatingApog	Lilith Vera (Luna Nera)
chiron	Chirone
pholus	Folo
ceres	Cerere
pallas	Pallade
juno	Giunone
vesta	Vesta
interpolatedLunarApogee	Apogeo Lunare Interpolato
interpolatedLunarPerigee	Perigeo Lunare Interpolato (Priapo)
earth	Terra

Esempio: Calcola Solo Sole e Marte

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"
    },
    "points": ["sun", "mars"]
  }'

La risposta conterrà sun e mars nell'oggetto points, e tutti e quattro gli angoli nell'oggetto angles:

{
  "data": {
    "points": {
      "sun": { "pointId": "sun", "longitude": 84.5, "sign": "gemini", ... },
      "mars": { "pointId": "mars", "longitude": 12.3, "sign": "aries", ... }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": { "pointId": "descendant", "longitude": 0.5, "sign": "aries", ... },
      "midheaven": { "pointId": "midheaven", "longitude": 270.2, "sign": "capricorn", ... },
      "imumCoeli": { "pointId": "imumCoeli", "longitude": 90.2, "sign": "cancer", ... }
    },
    "houses": { ... },
    "aspects": [ ... ]
  }
}

Angoli

Tutti e quattro gli angoli (ascendant, descendant, midheaven, imumCoeli) sono sempre inclusi nell'oggetto angles, indipendentemente dal parametro points. Gli angoli sono derivati dai calcoli delle case, non dall'effemeride, e hanno quindi una struttura più semplice (nessun dato di velocità o retrogradazione). L'array ascmc nella risposta houses contiene sempre anche le longitudini grezze degli angoli.

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 legge direttamente l'effemeride JPL DE442 della NASA per posizioni planetarie con precisione sub-milliarcsecondo. Consulta la pagina Precisione dei Calcoli per tutti i dettagli sulle nostre fonti dati e correzioni.