AstroWay/api v2.95.1 · es
todos los sistemas funcionando con normalidad
// astrology api · POST /v1/astrocartography

API de astrocartografía

La astrocartografía toma un único momento de nacimiento y lo proyecta sobre todo el planeta: en lugar de preguntar dónde estaban los planetas en el cielo, pregunta dónde sobre la Tierra estaba angular cada planeta. El endpoint devuelve la geometría de líneas que trazas en un mapamundi para ver qué longitudes activan qué energía planetaria.

Endpoint
POST /v1/astrocartography
Coste
50 créditos
Latencia
~76 ms
Nivel
Tier 3
// 01 / Qué calcula

API de astrocartografía

A partir de la fecha de nacimiento, la hora del reloj, el desfase UTC y las coordenadas de nacimiento, el endpoint fija el cielo exacto de ese instante, y luego barre el globo para hallar cada meridiano y curva donde un planeta se situó en uno de los cuatro ángulos. Para cada uno de los diez planetas más los nodos traza cuatro familias de línea: la línea de salida donde el cuerpo estaba en el Ascendente, la línea de puesta en el Descendente, la línea de culminación en el Medio Cielo y la línea de anticulminación en el Imum Coeli. Las líneas del MC y el IC discurren como meridianos limpios; las líneas del AC y el DC se curvan dependiendo de la latitud, ya que un cuerpo que sale justo por el este en una latitud sale mucho más al norte o al sur en otra. Todo se devuelve como geometría de líneas serializable bajo data.lines, lista para alimentar directamente una biblioteca de mapas. Esta es la técnica relocacional popularizada por Jim Lewis como Astro*Carto*Graphy.

// 02 / Solicitud en vivo

POST/v1/astrocartography

curl -X POST https://api.astroway.info/v1/astrocartography \
  -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
}'
Respuesta (fragmento)
{
  "ok": true,
  "data": {
    "lines": [
      {
        "planet": "Venus",
        "type": "MC",
        "longitude": 14.2
      },
      {
        "planet": "Jupiter",
        "type": "AC",
        "points": [
          "…"
        ]
      }
    ]
  }
}
// 03 / Parámetros

Parámetros

nametypeObligatorio
date string (YYYY-MM-DD) Birth date.
time string (HH:MM:SS) Local clock time at birth.
timezoneOffset number (hours) UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones.
latitude number Birth-place latitude, decimal degrees (north positive).
longitude number Birth-place longitude, decimal degrees (east positive).
// 04 / Cuándo usarlo

Cuándo usarlo

Usa este endpoint cuando la ubicación sea la variable y quieras saber cómo una carta se reexpresa a lo largo del mapa: para asesoramiento de relocalización, herramientas de viaje y de dónde-vivir, o cualquier funcionalidad que superponga la carta de una persona sobre un globo. Es el backend natural para un mapa interactivo: solicita las líneas una vez para un momento de nacimiento, renderízalas como polilíneas y deja que el usuario se desplace por los continentes para leer qué planeta gobierna qué corredor. Como la salida es geometría pura en lugar de prosa, se compone limpiamente con tu propio estilizado de front-end, agrupamiento y capas de clic-para-interpretar. Combínalo con la llamada natal-chart cuando quieras tanto la estructura de la carta de origen como las líneas relocalizadas una al lado de la otra; ambas comparten la misma resolución de nacimiento, de modo que las posiciones planetarias detrás del mapa coinciden exactamente.

// 05 / Notas

Notas

Las posiciones provienen de Swiss Ephemeris (Astrodienst) compilado a WASM, el mismo motor detrás de los endpoints natales, de modo que las líneas se anclan a las longitudes planetarias idénticas. La angularidad se calcula en el zodíaco tropical. La respuesta lleva solo geometría: el dibujo, la proyección y el estilizado del mapamundi se dejan a tu cliente.

Prueba la API de Astrocartografía

Consigue una clave y haz tu primera llamada en menos de un minuto.

99.9% SLA · planes de pago · 30 días estado →