API de carta heliocéntrica

El endpoint heliocentric resuelve la fecha, hora y desfase UTC suministrados a un día juliano, y luego solicita al motor Swiss Ephemeris las posiciones planetarias referidas al centro del Sol en lugar de la Tierra. En este marco la Tierra aparece como un cuerpo en órbita con su propia longitud, mientras que la Luna —que orbita la Tierra, no el Sol— y el Ascendente y el Medio Cielo geocéntricos carecen de sentido y se omiten. La respuesta devuelve las longitudes heliocéntricas de los planetas y la malla completa de aspectos calculada entre ellos, con indicadores de aplicación y separación y orbes exactos. Como el movimiento heliocéntrico es uniforme y libre de los bucles retrógrados y la paralaje que introduce la propia órbita de la Tierra, el espaciado planetario se lee de forma muy distinta al de una carta geocéntrica: las posiciones reflejan la verdadera geometría orbital alrededor del Sol.

curl -X POST https://api.astroway.info/v1/heliocentric \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52
}'

{
  "ok": true,
  "data": {
    "input": {},
    "planets": [
      {
        "name": "Earth",
        "longitude": 234.2
      },
      {
        "name": "Mars",
        "longitude": 9.1
      }
    ],
    "aspects": [
      {
        "planet1": "Earth",
        "planet2": "Jupiter",
        "type": "trine",
        "orb": 0.9
      }
    ]
  }
}

Recurre a la carta heliocéntrica en contextos de investigación, financieros y mundanos donde la vista centrada en el Sol es el estándar analítico: modelos de cómputo de fechas de mercado que rastrean ángulos planetarios heliocéntricos, estudios mundanos de ciclos planetarios, o cualquier análisis que quiera la geometría orbital sin las distorsiones de la retrogradación geocéntrica. También es útil como capa de contraste sobre una carta convencional, ya que un planeta que parece retrógrado desde la Tierra simplemente se mueve hacia adelante alrededor del Sol aquí. Como no hay Luna, ni Ascendente, ni casas en el sentido geocéntrico, trata la salida como un conjunto de datos de longitudes-y-aspectos planetarios más que como una carta natal personal: responde a preguntas sobre ciclos y configuraciones, no sobre el signo ascendente de un individuo.

Este es un marco centrado en el Sol: la Tierra se devuelve como un cuerpo, y la Luna, el Ascendente geocéntrico y el Medio Cielo están ausentes por construcción. El movimiento retrógrado desaparece porque es un artefacto de observar desde una Tierra en movimiento. La salida se lee mejor como longitudes heliocéntricas más su malla de aspectos para trabajo de ciclos y mundano, no como una carta personal. Longitudes tropicales y Swiss Ephemeris en todo momento.