API di interpretazione di astrocartografia
La geometria delle sole linee non dice a un utente dove trasferirsi. Questo endpoint prende un'area della vita, seleziona le linee di astrocartografia che la governano effettivamente, le classifica per forza e pertinenza, e restituisce il testo di interpretazione per ciascuna. Una singola chiamata sostituisce la mappa pianeta-tema che ogni prodotto di rilocazione dovrebbe altrimenti inventare internamente.
API di interpretazione di astrocartografia
L'endpoint calcola l'intera serie di astrocartografia per il momento della nascita, poi la filtra attraverso una tassonomia di diciannove aree della vita costruita sulla letteratura fondante della tecnica: Jim Lewis per il significato dei pianeti sugli angoli, Erin Sullivan per ciò che ciascuno dei quattro angoli governa, e Martin Davis per il trattamento delle linee difficili. Ogni area nomina le linee che le appartengono con un peso da uno a tre, quindi un Sole al Medium Coeli prevale su un Mercurio sullo stesso angolo per la carriera. Ogni mappa porta anche una polarità, e le linee sfidanti vengono restituite insieme a quelle favorevoli anziché essere filtrate via, perché uno strumento di rilocuzione che mostra solo linee favorevoli rappresenta male la tecnica. Quando si supera un punto, le linee fuori raggio cadono e la forza restituita moltiplica il peso astrologico per la prossimità geografica, che è ciò che permette di classificare le città candidate anziché elencare semplicemente le linee. Il testo di interpretazione viene fornito da una knowledge base curata che copre tutte le quaranta combinazioni pianeta-angolo in undici lingue, con un fallback documentato quando una traduzione manca.
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"
}
}
]
}
} Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment. |
| latitude | number | yes | Birth-place latitude, decimal degrees. |
| longitude | number | yes | Birth-place longitude, decimal degrees. |
| category | string | yes | 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. |
When to use it
Usa questo quando il tuo prodotto risponde a una domanda formulata in linguaggio comune: dove dovrei trasferirmi per lavoro, quale di queste tre città è migliore per una relazione, cosa significa questa linea sopra la mia città. Tre forme coprono la maggior parte degli utilizzi. Classificazione, inviando una categoria e un punto per ogni città candidata e ordinando per forza. Spiegazione, chiamando /v1/acg/line-report per un singolo pianeta e angolo per ottenere il testo completo più ogni altra area della vita che quella linea tocca. Scoperta, recuperando GET /v1/acg/categories una volta a zero crediti e costruendo la tua UI dalla tassonomia restituita in modo che una nuova categoria appaia senza un rilascio client. Poiché il testo è curato anziché generato, le risposte sono deterministiche, non citano alcun modello e non costituiscono un costo aggiuntivo nell'inferenza: la stessa richiesta restituisce le stesse parole domani.
Notes
La tassonomia copre i dieci corpi tradizionali. Chirone, Lilith e i nodi lunari appaiono nella geometria /v1/acg ma sono deliberatamente fuori dalla mappa, poiché la tecnica come definita da Jim Lewis non assegna loro il governo di aree della vita angolari. Pesi e polarità sono giudizi editoriali espressi come dati, versionati nel repository e verificabili piuttosto che nascosti in un prompt. Il testo di interpretazione è una ricerca nella knowledge base, non una chiamata a un modello linguistico, quindi è stabile, riproducibile offline e privo delle avvertenze che richiede l'interpretazione generata.
Try the Interpretazioni di Astrocartografia API
Grab a key and make your first call in under a minute.