Geboortehoroscopen

Bereken volledige geboortehoroscopen met planetaire posities, huiscuspen en aspecten.

Basisberekening

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:00",
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  }'

Parameters

Parameter	Type	Verplicht	Beschrijving
datetime	string	Ja	ISO 8601 datetime
latitude	number	Ja	Breedtegraad (-90 tot 90)
longitude	number	Ja	Lengtegraad (-180 tot 180)
timezone	string	Ja	IANA tijdzone-identifier
houseSystem	string	Nee	Huizensysteem (standaard: "placidus")

Huizensystemen

• placidus - Placidus (standaard)
• koch - Koch
• equal - Gelijke Huizen
• whole - Heel Teken
• campanus - Campanus
• regiomontanus - Regiomontanus
• porphyry - Porphyrius

Response

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

Opgenomen hemellichamen

Standaard worden de volgende hemellichamen opgenomen:

• Zon, Maan
• Mercurius, Venus, Mars, Jupiter, Saturnus, Uranus, Neptunus, Pluto
• Noordknoop, Zuidknoop
• Chiron, Lilith (Zwarte Maan)
• Pars Fortunae

Maan & Zon

Bereken maanfase, illuminatie, opkomst-/ondergangstijden en zonpositiegegevens.

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

Parameters

Parameter	Type	Verplicht	Beschrijving
dateTime	string	Ja	Datum/tijd in YYYY-MM-DDTHH:mm formaat
location.latitude	number	Ja	Breedtegraad (-90 tot 90)
location.longitude	number	Ja	Lengtegraad (-180 tot 180)
location.timezone	string	Ja	IANA tijdzone-identifier

Vereiste module

Dit endpoint vereist de module:moon module.

Response

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

Berekeningsprecisie

AstroAPI gebruikt de Zwitserse Efemeride voor hoge-precisieberekeningen. Alle posities worden berekend met boogsecondenauwkeurigheid.

Beta: Alternatieve berekeningsengine

Experimentele functie

Deze functie is in beta en kan nauwkeurigheidsproblemen hebben. Gebruik met voorzichtigheid in productieomgevingen.

AstroAPI biedt een alternatieve berekeningsengine (calc2) die een eigen implementatie gebruikt om Swiss Ephemeris SE1-gegevensbestanden rechtstreeks te lezen en evalueren, in plaats van de officiele Swiss Ephemeris-bibliotheek te gebruiken. Deze engine is geoptimaliseerd voor snelheid en kan snellere responstijden bieden.

Om de alternatieve engine te gebruiken, voegt u de X-Use-Calc2 header toe aan uw verzoek:

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:00",
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  }'

Belangrijkste verschillen

Aspect	Standaard engine	Calc2 engine (beta)
Implementatie	Swiss Ephemeris	Eigen implementatie
Gegevensbron	SE1 efemeride-bestanden	SE1 efemeride-bestanden (dezelfde gegevens)
Snelheid	Standaard	Potentieel sneller
Nauwkeurigheid	Boogsecondeprecisie (referentie)	Kan kleine afwijkingen vertonen
Status	Productierijp	Beta

Wanneer Calc2 gebruiken

• Aanbevolen voor: Toepassingen met hoog volume waar snelheid prioriteit heeft boven absolute precisie
• Niet aanbevolen voor: Toepassingen die maximale astronomische nauwkeurigheid vereisen

Bekende beperkingen

• De eigen implementatie kan enigszins afwijkende resultaten produceren vergeleken met de officiele Swiss Ephemeris-bibliotheek
• Nog in actieve ontwikkeling en testing
• Resultaten dienen te worden gevalideerd tegen de standaard engine voor kritieke toepassingen