Transiti

Calcola i transiti planetari e i loro aspetti rispetto a un tema natale in un periodo di tempo specificato.

Calcola i Transiti

Calcola i transiti per un intervallo di date:

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-01-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

Parametri

Parametro	Tipo	Obbligatorio	Descrizione
birthDate	string	Sì	Data/ora di nascita nel formato YYYY-MM-DDTHH:mm
birthLocation	object	Sì	Luogo di nascita con latitudine, longitudine e fuso orario
transitDateStart	string	Sì	Inizio del periodo di transito nel formato YYYY-MM-DDTHH:mm
transitDateEnd	string	Sì	Fine del periodo di transito nel formato YYYY-MM-DDTHH:mm
transitLocation	object	Sì	Luogo del transito con latitudine, longitudine e fuso orario
houseSystem	string	No	Sistema delle case (predefinito: "placidus")
points	array	No	Punti celesti da calcolare
orbs	object	No	Valori di orbo personalizzati per tipo di aspetto
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)

Oggetto Posizione

{
  "latitude": 51.5074,
  "longitude": -0.1278,
  "timezone": "Europe/London"
}

Risposta

La risposta include i passaggi di transito (quando i pianeti entrano/escono dai segni o dalle case), le posizioni nelle case di transito, gli aspetti tra i pianeti in transito e natali, e gli URL dei temi.

{
  "data": {
    "crossings": [...],
    "transitHouses": [...],
    "aspects": [
      {
        "point1": "saturn",
        "point2": "sun",
        "aspect": "conjunction",
        "orb": 1.2,
        "applying": true
      }
    ],
    "charts": {
      "transit": {
        "title": "Transit Chart (Bi-wheel)",
        "url": "..."
      },
      "natal": {
        "title": "Natal Chart",
        "url": "..."
      }
    },
    "natalPoints": [...],
    "natalHouses": [...],
    "transitPoints": [...]
  }
}

Orbi Personalizzati

Specifica valori di orbo personalizzati per diversi tipi di aspetto:

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-01-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "orbs": {
      "conjunction": 3,
      "opposition": 3,
      "trine": 2,
      "square": 2
    }
  }'

Con Testo Interpretativo

Includi il testo interpretativo nei tuoi calcoli dei transiti:

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-15T00:00",
    "transitDateEnd": "2024-01-15T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "includeText": true,
    "language": "en"
  }'

Esportazione iCal

Esporta gli eventi di transito come file iCal (.ics) importabile nelle applicazioni calendario come Google Calendar, Apple Calendar o Outlook.

POST /api/calc/transit/ical

curl -X POST "https://api.astroapi.cloud/api/calc/transit/ical" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-03-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }' --output transits.ics

La risposta è un file text/calendar con Content-Disposition: attachment; filename="transits.ics".

Parametri

L'esportazione iCal accetta gli stessi parametri dell'endpoint di transito standard, più:

Parametro	Tipo	Obbligatorio	Descrizione
aspects	array	No	Filtra per tipi di aspetto (es. ["conjunction", "trine"])

TIP

Importa il file .ics scaricato nella tua app calendario per vedere gli eventi di transito come voci del calendario con descrizioni di ogni aspetto.