API de astrología de espacio local

El endpoint construye el natal, convierte cada planeta de coordenadas eclípticas al horizonte del lugar de nacimiento, y devuelve su azimut en grados en el sentido de las agujas del reloj desde el norte verdadero junto con su altitud por encima o por debajo del horizonte. Luego proyecta cada azimut como un gran círculo hacia afuera desde el lugar de nacimiento y devuelve la trayectoria resultante como una serie de coordenadas, para que una línea dibujada en un mapa mundial mantenga una verdadera orientación en lugar de una línea recta en una proyección plana. Se cubren trece cuerpos, cada uno con un color estable para que un mapa renderizado mantenga la misma paleta que el resto de la suite. Aquí la altitud es tan importante como el azimut: un planeta por debajo del horizonte al nacer se interpreta diferente de uno alto en el cielo en la misma dirección.

curl -X POST https://api.astroway.info/v1/local-space \
  -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": {
    "birthplace": { "latitude": 50.45, "longitude": 30.52 },
    "count": 13,
    "lines": [
      {
        "planetId": 0,
        "planetName": "Sun",
        "azimuth": 219.8018,
        "altitude": 53.1309,
        "color": "#FFB300",
        "points": [{ "lat": 50.45, "lng": 30.52 }, "…"]
      }
    ]
  }
}

Usa el espacio local cuando el producto trata sobre dirección y distancia desde un hogar fijo en lugar de posición absoluta en el globo. Dos casos predominan. El primero es la reubicación a cualquier escala, desde elegir qué ciudad se encuentra a lo largo de una orientación favorable hasta decidir cómo moverse dentro de un país, porque un gran círculo desde el lugar de nacimiento cruza mucho más territorio utilizable que unas pocas meridianos de astrocartografía. El segundo es el trabajo interior y de sitio, donde las mismas direcciones se leen a escala de habitación dentro de una vivienda: el endpoint devuelve las orientaciones, y el compañero /local-space/influence-zone convierte una de ellas en un polígono de cono que puedes dibujar. Si ya renderizas astrocartografía, añadir espacio local es la forma más barata de duplicar la profundidad de una función de reubicación, ya que usa la misma entrada de nacimiento y la misma superficie de mapa.

Las posiciones provienen de la Efeméride Suiza (Astrodienst). El azimut se mide en el sentido de las agujas del reloj desde el norte verdadero, no el magnético, por lo que no se aplica ni se necesita corrección de declinación. La trayectoria del gran círculo se devuelve como coordenadas muestreadas en lugar de como fórmula, lo que mantiene al cliente libre de geometría esférica. La técnica en esta forma fue desarrollada por Michael Erlewine y está documentada en sus Direcciones Astrofísicas.