Motor de cálculo

Las posiciones salen de las efemérides planetarias de NASA JPL, el mismo conjunto de datos que se usa para navegar naves espaciales: 105 MB de posiciones tabuladas que cubren de 500 a 2999 d. C., más 735 estrellas fijas.

Importa porque la alternativa es una aritmética que vale para una columna de periódico, pero no para una carta. Las fórmulas de movimiento medio se desvían varios grados a lo largo de los siglos. Eso se nota en un nacimiento de 1890 o de 2090, y en una carta divisional se convierte en una respuesta distinta, no en una ligeramente distinta. En la D60, medio grado basta para que un planeta pase a la división siguiente.

La astrología védica es sideral: las posiciones se miden desde un punto fijo del cielo y no desde el equinoccio, que se desplaza. La diferencia entre ambos es el ayanamsa, que hoy ronda los 24°, y no existe un valor único aceptado por todos.

Por eso es un parámetro. Se admiten 48 ayanamsas (Lahiri, Raman, Krishnamurti, Fagan-Bradley, Yukteshwar, Suryasiddhanta y los demás), y Lahiri es el valor por defecto porque es el estándar oficial del Gobierno de la India, no porque sea el correcto.

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

Dos astrólogos que no se ponen de acuerdo sobre el ayanamsa pueden usar esta API y obtener cada uno la carta que espera. Una API que fija uno en el código ha tomado partido, sin decirlo, en un debate que no está cerrado.

299 endpoints, agrupados según lo que calculan:

El tiempo mediano en servidor es de 62 ms, y el 76 % de los endpoints responde en menos de 100 ms, medido sobre todos los ejemplos publicados en una ejecución local. Las efemérides se mapean en memoria, así que lo que cuesta una carta es la aritmética, no el disco.

Cuando una llamada es más lenta es porque el trabajo es realmente mayor: una búsqueda de tránsitos recorre un rango de fechas, y un informe en PDF reúne unos veinticinco endpoints en un solo documento y se cobra como una sola llamada.

La misma entrada devuelve siempre la misma salida. No hay muestreo ni ningún modelo de por medio, así que una carta calculada hoy y la misma carta calculada el año que viene son idénticas byte a byte. Por eso las respuestas se pueden guardar en caché, y por eso 1783 funciones de test pueden comprobar valores exactos en lugar de rangos.

También significa que cualquier discrepancia se puede comprobar. Si nuestra Luna y la de tu software no coinciden, una de las dos está mal, y el ayanamsa o la zona horaria dirán cuál, en lugar de que las dos estén «más o menos bien».

El motor puede sacar un número para casi cualquier cosa. Algunos de esos números no significarían lo que el lector cree, y esos endpoints no existen.

• Las deudas ancestrales del Lal Kitab. Las ocho deudas reciben el mismo nombre en todas las fuentes, pero las condiciones que activan cada una no coinciden: solo para el pitra rin, las reglas publicadas dan respuestas distintas para la misma carta. No vamos a publicar un veredicto sobre los antepasados de alguien que dependa de qué libro hayamos leído.
• Campos para los que no podemos derivar una regla. Cuando un competidor devuelve un valor que no hemos podido establecer a partir de una fuente, el campo no aparece y la respuesta explica por qué, en lugar de incluir una suposición creíble que quien llama no tendría forma de comprobar.
• Nada que se presente como consejo médico, jurídico o financiero. Los textos de remedios son atribuciones de la tradición y se indican como tales.

Cuando dos escuelas discrepan de verdad y ambas son defendibles, la respuesta indica cuál ha aplicado, para que puedas comprobarla en lugar de aceptarla sin más.

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

O ejecútalo en el Playground sin escribir código.