Moteur de calcul

Les positions viennent des éphémérides planétaires NASA JPL, le jeu de données qui sert aussi à la navigation des sondes spatiales. Cela représente 105 Mo de positions tabulées couvrant les années 500 à 2999 apr. J.-C., plus 735 étoiles fixes.

C’est important, car l’alternative est un calcul assez précis pour une rubrique de journal, mais pas pour un thème. Les formules de mouvement moyen dérivent de plusieurs degrés au fil des siècles ; c’est sur une naissance en 1890 ou en 2090 que l’écart apparaît, et sur une carte divisionnaire qu’il donne une réponse différente, et non légèrement différente. En D60, un demi-degré fait passer une planète dans la division suivante.

L’astrologie védique est sidérale : les positions sont mesurées depuis un point de départ fixe dans le ciel, et non depuis l’équinoxe, qui se déplace. L’écart entre les deux est l’ayanamsa, actuellement d’environ 24°, et aucune valeur unique ne fait 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 tous deux utiliser cette API et obtenir chacun le thème qu’il attend. Une API qui en impose 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, et 76 % des endpoints répondent en moins de 100 ms, d’après tous les exemples publiés mesurés lors d’une exécution locale. Les éphémérides sont mappé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 renvoie 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 se vérifie. Si notre Lune et celle de votre logiciel diffèrent, 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 nombre pour presque tout. Certains de ces nombres ne voudraient pas dire ce qu’un lecteur croit y lire, 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. Pas les conditions qui déclenchent chacune d’elles : rien que pour pitra rin, les règles publiées donnent des réponses différentes pour le même thème. Nous ne publierons pas sur les ancêtres de quelqu’un un verdict qui dépendrait du livre que nous aurions lu.
• Les champs pour lesquels nous ne pouvons établir aucune règle. Quand un concurrent renvoie une valeur que nous n’avons pas pu établir à partir d’une source, le champ est absent et la réponse explique pourquoi, au lieu de contenir une supposition plausible que l’appelant n’aurait aucun moyen de vérifier.
• Tout ce qui se présenterait comme un avis 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 : on peut ainsi la vérifier plutôt que la croire sur parole.

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 de code.