Transits

Bereken planetaire transits en hun aspecten naar een geboortehoroscoop over een opgegeven tijdsperiode.

Transits berekenen

Bereken transits voor een datumbereik:

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"
    }
  }'

Parameters

Parameter	Type	Verplicht	Beschrijving
birthDate	string	Ja	Geboortedatum/-tijd in YYYY-MM-DDTHH:mm formaat
birthLocation	object	Ja	Geboortelocatie met latitude, longitude en timezone
transitDateStart	string	Ja	Start transitperiode in YYYY-MM-DDTHH:mm formaat
transitDateEnd	string	Ja	Einde transitperiode in YYYY-MM-DDTHH:mm formaat
transitLocation	object	Ja	Transitlocatie met latitude, longitude en timezone
houseSystem	string	Nee	Huizensysteem (standaard: "placidus")
points	array	Nee	Hemellichamen om te berekenen
orbs	object	Nee	Aangepaste orbwaarden per aspecttype
language	string	Nee	Taalcode voor tekstinhoud (standaard: "en")
includeText	boolean	Nee	Interpretatietekst opnemen (standaard: false)
includeReadableEntities	boolean	Nee	Leesbare entiteitstitels opnemen (standaard: false)

Locatie-object

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

Response

De response bevat transitkruisingen (wanneer planeten tekens of huizen binnengaan/verlaten), transithuisposities, aspecten tussen transit- en natale planeten en horoscoop-URL's.

{
  "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": [...]
  }
}

Aangepaste orbs

Specificeer aangepaste orbwaarden voor verschillende aspecttypes:

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
    }
  }'

Met interpretatietekst

Voeg interpretatietekst toe aan uw transitberekeningen:

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"
  }'

iCal-export

Exporteer transitgebeurtenissen als een iCal (.ics) bestand dat kan worden geimporteerd in agendatoepassingen zoals Google Calendar, Apple Calendar of 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

De response is een text/calendar bestand met Content-Disposition: attachment; filename="transits.ics".

Parameters

De iCal-export accepteert dezelfde parameters als het standaard transit-endpoint, plus:

Parameter	Type	Verplicht	Beschrijving
aspects	array	Nee	Filteren op aspecttypes (bijv. ["conjunction", "trine"])

TIP

Importeer het gedownloade .ics-bestand in uw agenda-app om transitgebeurtenissen als agenda-items te zien met beschrijvingen van elk aspect.