Rechenkern
Jede Zahl, die diese API liefert, stammt aus Ephemeriden – nicht aus einer Tabelle und nicht aus einem Modell. Hier erfährst du, was unter der Haube steckt und wo wir die Grenze ziehen: was wir bewusst nicht berechnen.
Die Ephemeriden
Die Positionen stammen aus den Planetenephemeriden von NASA JPL – denselben Daten, mit denen Raumsonden navigiert werden. Das sind 105 MB tabellierter Positionen für die Jahre 500–2999 n. Chr., dazu 735 Fixsterne.
Das ist wichtig, weil die Alternative eine Rechnung ist, die für eine Horoskopspalte in der Zeitung reicht, aber nicht für ein echtes Horoskop. Formeln mit mittleren Bewegungen weichen über Jahrhunderte um ganze Grade ab. Bei einer Geburt im Jahr 1890 oder 2090 fällt das auf, und in einem Teilhoroskop wird daraus nicht bloß eine leicht abweichende, sondern eine andere Antwort. In D60 rutscht ein Planet schon bei einem halben Grad in den nächsten Abschnitt.
Siderisch – aber welches Siderisch?
Die vedische Astrologie ist siderisch: Positionen werden von einem festen Punkt am Himmel aus gemessen, nicht vom wandernden Frühlingspunkt. Der Abstand zwischen beiden heißt Ayanamsa, liegt derzeit bei etwa 24° – und einen allgemein anerkannten Wert dafür gibt es nicht.
Deshalb ist das Ayanamsa ein Parameter. 48 Ayanamsas stehen zur Wahl – Lahiri, Raman, Krishnamurti, Fagan-Bradley, Yukteshwar, Suryasiddhanta und weitere. Lahiri ist voreingestellt, weil es der offizielle Standard der indischen Regierung ist, nicht weil es das einzig richtige wäre.
{
"date_time": "1990-08-15T10:30:00+05:30",
"latitude": 26.9124,
"longitude": 75.7873,
"timezone_as_float": 5.5,
"ayanamsa": "KRISHNAMURTI"
}Zwei Astrologen, die beim Ayanamsa unterschiedlicher Meinung sind, können beide diese API nutzen und bekommen jeweils das Horoskop, das sie erwarten. Eine API, die nur ein Ayanamsa fest einbaut, hat stillschweigend Partei ergriffen – in einem Streit, der nicht entschieden ist.
Was abgedeckt ist
299 Endpoints, gruppiert danach, was sie berechnen:
Geschwindigkeit
Die Serverzeit liegt im Median bei 62 ms, 76 % der Endpoints antworten in unter 100 ms – gemessen an allen veröffentlichten Beispielen in einem lokalen Durchlauf. Die Ephemeriden sind per Memory-Mapping eingebunden. Ein Horoskop kostet also Rechenzeit, nicht Festplattenzugriffe.
Wenn ein Aufruf länger dauert, dann weil wirklich mehr zu tun ist: Eine Transitsuche durchläuft einen ganzen Zeitraum, und ein PDF-Bericht setzt rund fünfundzwanzig Endpoints zu einem Dokument zusammen – abgerechnet als ein einziger Aufruf.
Determinismus
Dieselbe Eingabe liefert immer dieselbe Ausgabe. Es gibt kein Sampling und kein Modell in der Kette: Ein Horoskop, das du heute berechnest, ist nächstes Jahr byte-identisch. Genau deshalb lassen sich die Antworten cachen, und genau deshalb können 1.783 Testfunktionen exakte Werte prüfen statt nur Wertebereiche.
Außerdem lässt sich jede Abweichung überprüfen. Wenn unser Mond und der Mond deiner Software nicht übereinstimmen, ist einer von beiden falsch – und Ayanamsa oder Zeitzone verraten, welcher. Es sind nicht einfach beide „ungefähr richtig“.
Was wir nicht berechnen
Der Rechenkern kann für fast alles eine Zahl ausspucken. Manche dieser Zahlen würden aber nicht das bedeuten, was ein Leser darin sieht. Solche Endpoints gibt es bei uns nicht.
- Ahnenschulden nach Lal Kitab. Die acht Schulden heißen in allen Quellen gleich. Die Bedingungen, unter denen sie jeweils entstehen, aber nicht – schon die veröffentlichten Regeln für Pitra Rin liefern für dasselbe Horoskop unterschiedliche Ergebnisse. Ein Urteil über die Vorfahren eines Menschen, das nur davon abhängt, welches Buch wir zufällig gelesen haben, veröffentlichen wir nicht.
- Felder, für die wir keine Regel herleiten können. Wo ein Wettbewerber einen Wert liefert, den wir aus keiner Quelle belegen konnten, fehlt das Feld bei uns, und die Antwort sagt, warum. Eine plausible Vermutung, die der Aufrufer nicht überprüfen kann, liefern wir nicht.
- Alles, was als medizinische, rechtliche oder finanzielle Beratung daherkommt. Texte zu Abhilfemaßnahmen geben traditionelle Zuschreibungen wieder und sind entsprechend gekennzeichnet.
Wo zwei Schulen sich wirklich widersprechen und beide gut begründet sind, sagt die Antwort, welche sie angewendet hat. So lässt sich das Ergebnis überprüfen, statt es einfach glauben zu müssen.
Ausprobieren
curl -X POST https://api.occultapi.com/api/astro/planet-positions/ \
-H 'X-API-Key: yt_live_your_key_here' \
-H 'Content-Type: application/json' \
-d '{
"date_time": "1990-08-15T10:30:00+05:30",
"latitude": 26.9124,
"longitude": 75.7873,
"timezone_as_float": 5.5,
"ayanamsa": "LAHIRI"
}'Oder probier es im Playground aus, ganz ohne Code.