API de cartografía astrológica de retorno solar

El endpoint primero construye la carta natal, luego busca el instante en el año solicitado en que el Sol tránsito alcanza la longitud solar natal, con una precisión de menos de un segundo de arco. Calcula las posiciones planetarias para ese instante y traza las cuatro familias de líneas angulares en todo el mundo, exactamente como hace el endpoint de cartografía astrológica natal, devolviendo sesenta y tres líneas. Cada nombre de planeta lleva un sufijo SR para que un cliente que renderice ambos mapas a la vez no pueda confundir una línea de Júpiter natal con una de retorno solar. Las líneas se devuelven como pares de coordenadas en la misma forma que /acg, por lo que un renderizador existente no necesita cambios más allá de un estilo para la segunda capa.

curl -X POST https://api.astroway.info/v1/solar-acg \
  -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,
  "year": 2026
}'

{
  "ok": true,
  "data": {
    "year": 2026,
    "lines": [
      {
        "planet": "Sun (SR)",
        "planetId": 0,
        "type": "MC",
        "coordinates": [[-85, 110.4845], [-84.5, 110.4845], "…"]
      }
    ]
  }
}

Este es el endpoint detrás de la pregunta comercial más importante en la astrología de reubicación: ¿dónde debería pasar mi cumpleaños, y dónde debería estar radicado este año. Las cartas de retorno solar se calculan tradicionalmente para donde la persona físicamente se encuentra en el momento del retorno, lo que hace que la ubicación sea una decisión en lugar de un dato dado, y este mapa es lo que convierte esa decisión en algo que un usuario puede ver. Construye un informe de reubicación anual, un recomendador de viajes de cumpleaños, o una superposición anual en tu mapa de cartografía astrológica existente. Debido a que el momento subyacente del retorno cambia cada año, el resultado es contenido naturalmente re-comprable en lugar de un cálculo único, y se compone directamente con /solar-return cuando el usuario quiere tanto la carta como el mapa.

Las posiciones provienen de la Efeméride Suiza (Astrodienst). El instante del retorno se calcula con respecto a la longitud solar natal en el zodiaco tropical; los retornos solares siderales son una técnica diferente y no es lo que este endpoint calcula. El mapa se dibuja a partir de la carta de retorno sola, por lo que es un reemplazo completo de las líneas natales para ese año en lugar de una modificación de ellas. Algunas escuelas calculan el retorno para el lugar de nacimiento en lugar de la ubicación actual; esa elección pertenece a tu capa de interpretación, ya que la geometría de las líneas es idéntica de cualquier manera.