API de interpretación de astrocartografía
La geometría de las líneas por sí sola no le dice a un usuario dónde mudarse. Este endpoint toma un área de la vida, selecciona las líneas de astrocartografía que realmente la gobiernan, las clasifica según su fuerza y proximidad aplicada, y devuelve el texto de interpretación para cada una. Una sola llamada reemplaza el mapeo planeta-tema que cada producto de reubicación tendría que inventar internamente.
API de interpretación de astrocartografía
El endpoint calcula el conjunto completo de astrocartografía para el momento del nacimiento, luego lo filtra a través de una taxonomía de diecinueve áreas de la vida construida a partir de la literatura fundacional de la técnica: Jim Lewis para el significado de planeta en ángulo, Erin Sullivan para lo que gobierna cada uno de los cuatro ángulos, y Martin Davis para el tratamiento de las líneas difíciles. Cada área nombra las líneas que le pertenecen con un peso de uno a tres, por lo que un Sol en el Mediocielo supera a un Mercurio en el mismo ángulo para la carrera. Cada mapeo también lleva una polaridad, y las líneas desafiantes se devuelven junto con las de apoyo en lugar de filtrarse, porque una herramienta de reubicación que muestra solo líneas favorables tergiversa la técnica. Cuando pasas por un punto, las líneas fuera del radio desaparecen y la fuerza devuelta multiplica el peso astrológico por la proximidad geográfica, lo que te permite clasificar ciudades candidatas en lugar de simplemente listar líneas. El texto de interpretación se sirve desde una base de conocimientos curada que cubre todas las cuarenta combinaciones planeta-ángulo en once idiomas, con un respaldo documentado cuando falta una traducción.
POST/v1/acg/by-category
curl -X POST https://api.astroway.info/v1/acg/by-category \
-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,
"category": "career",
"point": { "lat": 51.5074, "lng": -0.1278 },
"radiusDeg": 8,
"language": "en"
}' {
"ok": true,
"data": {
"category": { "id": "career", "name": "Career" },
"language": "en",
"count": 3,
"lines": [
{
"planet": "Jupiter",
"type": "MC",
"weight": 3,
"polarity": "supportive",
"strength": 2.31,
"distanceDeg": 1.84,
"pointCount": 341,
"segments": [
[[-85, 110.48], [-84.5, 110.48], "…"]
],
"interpretation": {
"title": "Jupiter - MC",
"text": "Expansion of professional opportunity…",
"lang": "en"
}
}
]
}
} 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. |
| latitude | number | sí | Birth-place latitude, decimal degrees. |
| longitude | number | sí | Birth-place longitude, decimal degrees. |
| category | string | sí | One of 19 life areas: career, love, money, health, home, learning, power, travel and more. Fetch the full list from GET /v1/acg/categories. |
| point | { lat, lng } | no | Optional geographic focus. With it, only lines running within radiusDeg of that point are returned and strength folds in proximity. |
| radiusDeg | number | no | Search radius in degrees around point. Default 4, range 0.5 to 20. |
| polarity | string | no | supportive, challenging, or all (default). Challenging lines are returned by default rather than hidden. |
| includeText | boolean | no | Attach the interpretation text for each line. Default true. |
| includeCoordinates | boolean | no | Attach the line geometry as `segments`, an array of `[lat, lng]` polylines. A rising or setting curve is several disjoint segments, so they are kept separate rather than concatenated. Default true; set false for a compact ranking response. |
| language | string | no | Interpretation language. Falls back to English then Ukrainian when a translation is missing, and the served language is reported per line. |
Cuándo usarlo
Usa esto cuando tu producto responde a una pregunta formulada en lenguaje ordinario: ¿a dónde debería mudarme para trabajar, ¿cuál de estas tres ciudades es mejor para una relación, ¿qué significa realmente esta línea sobre mi ciudad. Tres formas cubren la mayoría de las implementaciones. Clasificación, enviando una categoría y un punto por ciudad candidata y ordenando por fuerza. Explicación, llamando a /v1/acg/line-report para un planeta y ángulo únicos para obtener el texto completo más cada otra área de la vida que esa línea toca. Descubrimiento, obteniendo GET /v1/acg/categories una vez con c créditos y construyendo tu UI a partir de la taxonomía devuelta para que una nueva categoría aparezca sin una actualización del cliente. Como el texto está curado en lugar de generado, las respuestas son deterministas, no citan ningún modelo y no cuestan nada extra en inferencia: la misma solicitud devuelve las mismas palabras mañana.
Notas
La taxonomía cubre los diez cuerpos tradicionales. Quirón, Lilith y los nodos lunares aparecen en la geometría /v1/acg pero deliberadamente están fuera del mapeo, ya que la técnica tal como Jim Lewis la definió no les asigna el dominio de áreas de vida angulares. Los pesos y polaridades son juicios editoriales expresados como datos, versionados en el repositorio y auditables en lugar de estar ocultos dentro de un prompt. El texto de interpretación es una búsqueda en base de conocimientos, no una llamada a un modelo de lenguaje, por lo que es estable, reproducible sin conexión y libre de las advertencias que requiere la interpretación generada.
Prueba la API de Interpretaciones de Astrocartografía
Consigue una clave y haz tu primera llamada en menos de un minuto.