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.
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.
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
}' {
"ok": true,
"data": {
"lines": [
{
"planet": "Venus",
"type": "MC",
"longitude": 14.2
},
{
"planet": "Jupiter",
"type": "AC",
"points": [
"…"
]
}
]
}
} Parámetros
| name | type | Obligatorio | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | sí | Birth date. |
| time | string (HH:MM:SS) | sí | Local clock time at birth. |
| timezoneOffset | number (hours) | sí | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | sí | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | sí | Birth-place longitude, decimal degrees (east positive). |
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.
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.