Moteur de calcul

Les positions proviennent des éphémérides planétaires NASA JPL, les mêmes données que pour la navigation des sondes spatiales : 105 Mo de positions tabulées couvrant la période 500–2999 apr. J.-C., plus 735 étoiles fixes.

C’est important, car l’alternative est un calcul assez juste pour une rubrique de journal, mais pas pour un thème. Les formules de mouvement moyen dérivent de plusieurs degrés en quelques siècles. Cela se voit sur une naissance en 1890 ou en 2090, et sur une carte divisionnaire, cela donne une réponse différente, pas seulement légèrement décalée. En D60, un demi-degré suffit à faire passer une planète dans la division suivante.

L’astrologie védique est sidérale : les positions sont mesurées à partir d’un point fixe du ciel, et non de l’équinoxe, qui se déplace. Le décalage entre les deux est l’ayanamsa, d’environ 24° aujourd’hui, et il n’existe pas de valeur unique qui fasse consensus.

C’est donc un paramètre. 48 ayanamsas sont acceptés (Lahiri, Raman, Krishnamurti, Fagan-Bradley, Yukteshwar, Suryasiddhanta et les autres), et Lahiri est la valeur par défaut parce que c’est la norme du gouvernement indien, pas parce que ce serait la bonne.

{
  "date_time": "1990-08-15T10:30:00+05:30",
  "latitude": 26.9124,
  "longitude": 75.7873,
  "timezone_as_float": 5.5,
  "ayanamsa": "KRISHNAMURTI"
}

Deux praticiens en désaccord sur l’ayanamsa peuvent utiliser tous deux cette API et obtenir chacun le thème qu’ils attendent. Une API qui en fige un seul a discrètement pris parti dans un débat qui n’est pas tranché.

299 endpoints, regroupés selon ce qu’ils calculent :

Le temps serveur médian est de 62 ms, avec 76 % des endpoints sous les 100 ms, mesurés sur tous les exemples publiés lors d’une exécution locale. Les éphémérides sont projetées en mémoire : le coût d’un thème tient au calcul, pas aux accès disque.

Quand un appel est plus lent, c’est que le travail est réellement plus lourd : une recherche de transits parcourt une plage de dates, et un rapport PDF assemble environ vingt-cinq endpoints en un seul document, facturé comme un seul appel.

La même entrée donne toujours la même sortie. Il n’y a ni échantillonnage ni modèle dans la chaîne : un thème calculé aujourd’hui et le même thème calculé l’an prochain sont identiques à l’octet près. C’est ce qui permet de mettre les réponses en cache, et ce qui permet à 1 783 fonctions de test de vérifier des valeurs exactes plutôt que des plages.

Cela signifie aussi qu’un désaccord est vérifiable. Si notre Lune diffère de celle de votre logiciel, l’une des deux est fausse, et l’ayanamsa ou le fuseau horaire dira laquelle, au lieu que les deux soient « à peu près justes ».

Le moteur peut produire un chiffre pour presque tout. Certains de ces chiffres ne voudraient pas dire ce que le lecteur croit, et les endpoints correspondants n’existent pas.

• Les dettes ancestrales du Lal Kitab. Les huit dettes portent les mêmes noms d’une source à l’autre. Les conditions qui déclenchent chacune d’elles, non : les règles publiées pour le seul pitra rin donnent des réponses différentes pour un même thème. Nous ne publierons pas un verdict sur les ancêtres de quelqu’un qui dépendrait du livre que nous avons lu par hasard.
• Les champs pour lesquels nous ne pouvons pas établir de règle. Quand un concurrent renvoie une valeur que nous n’avons pu établir à partir d’aucune source, le champ est absent et la réponse explique pourquoi, au lieu de contenir une estimation plausible que l’appelant n’aurait aucun moyen de vérifier.
• Tout ce qui serait présenté comme un conseil médical, juridique ou financier. Les textes de remèdes relèvent de l’attribution traditionnelle et sont signalés comme tels.

Quand deux écoles divergent réellement et que les deux se défendent, la réponse indique celle qui a été appliquée : le résultat peut ainsi être vérifié, au lieu d’être pris pour argent comptant.

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

Ou lancez-le dans le Playground sans écrire une ligne de code.