Geburtshoroskope

Berechnen Sie vollständige Geburtshoroskope mit Planetenpositionen, Hauskuppen und Aspekten.

Grundlegende Berechnung

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

Parameter

Parameter	Typ	Erforderlich	Beschreibung
datetime	string	Ja	ISO 8601-Datum/-Uhrzeit
latitude	number	Ja	Breitengrad (-90 bis 90)
longitude	number	Ja	Längengrad (-180 bis 180)
timezone	string	Ja	IANA-Zeitzonenkennung
houseSystem	string	Nein	Häusersystem (Standard: "placidus")

Häusersysteme

• placidus – Placidus (Standard)
• koch – Koch
• equal – Gleiche Häuser
• whole – Ganzzodiak
• campanus – Campanus
• regiomontanus – Regiomontanus
• porphyry – Porphyry

Antwort

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

Enthaltene Himmelskörper

Standardmäßig sind folgende Himmelskörper enthalten:

• Sonne, Mond
• Merkur, Venus, Mars, Jupiter, Saturn, Uranus, Neptun, Pluto
• Nordknoten, Südknoten
• Chiron, Lilith (Schwarzer Mond)
• Pars Fortunae

Mond & Sonne

Berechnen Sie Mondphase, Beleuchtung, Auf-/Untergangszeiten und Sonnenpositionsdaten.

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

Parameter

Parameter	Typ	Erforderlich	Beschreibung
dateTime	string	Ja	Datum/Uhrzeit im Format YYYY-MM-DDTHH:mm
location.latitude	number	Ja	Breitengrad (-90 bis 90)
location.longitude	number	Ja	Längengrad (-180 bis 180)
location.timezone	string	Ja	IANA-Zeitzonenkennung

Erforderliches Modul

Dieser Endpunkt erfordert das Modul module:moon.

Antwort

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

Berechnungsgenauigkeit

AstroAPI verwendet die Schweizer Ephemeride für hochpräzise Berechnungen. Alle Positionen werden mit Bogensekundengenauigkeit berechnet.

Beta: Alternativer Berechnungsmotor

Experimentelle Funktion

Diese Funktion befindet sich in der Beta-Phase und kann Genauigkeitsprobleme aufweisen. Verwenden Sie sie in Produktionsumgebungen mit Vorsicht.

AstroAPI bietet einen alternativen Berechnungsmotor (calc2), der eine eigene Implementierung verwendet, um Schweizer-Ephemeride-SE1-Datendateien direkt zu lesen und auszuwerten, anstatt die offizielle Schweizer-Ephemeride-Bibliothek zu nutzen. Dieser Motor ist auf Geschwindigkeit optimiert und kann schnellere Antwortzeiten liefern.

Um den alternativen Motor zu verwenden, fügen Sie den X-Use-Calc2-Header in Ihre Anfrage ein:

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

Wesentliche Unterschiede

Aspekt	Standard-Motor	Calc2-Motor (Beta)
Implementierung	Schweizer Ephemeride	Eigene Implementierung
Datenquelle	SE1-Ephemeridendateien	SE1-Ephemeridendateien (gleiche Daten)
Geschwindigkeit	Standard	Möglicherweise schneller
Genauigkeit	Bogensekundengenauigkeit (Referenz)	Kann geringfügige Abweichungen aufweisen
Status	Produktionsreif	Beta

Wann Calc2 verwenden

• Empfohlen für: Hochvolumen-Anwendungen, bei denen Geschwindigkeit Vorrang vor absoluter Präzision hat
• Nicht empfohlen für: Anwendungen, die maximale astronomische Genauigkeit erfordern

Bekannte Einschränkungen

• Die eigene Implementierung kann leicht abweichende Ergebnisse im Vergleich zur offiziellen Schweizer-Ephemeride-Bibliothek liefern
• Noch in aktiver Entwicklung und im Testbetrieb
• Ergebnisse sollten für kritische Anwendungen mit dem Standard-Motor abgeglichen werden