API d'interprétation d'Astrocartographie
La géométrie des lignes ne suffit pas à dire à l'utilisateur où se déplacer. Ce endpoint prend une zone de vie, sélectionne les lignes d'astrocartographie qui la gouvernent réellement, les classe selon leur force et leur proximité d'application, et renvoie le texte d'interprétation pour chacune. Un appel remplace la correspondance planète-thème que chaque produit de relocalisation doit sinon créer en interne.
API d'interprétation d'Astrocartographie
Le endpoint calcule l'ensemble complet d'astrocartographie pour le moment de naissance, puis le filtre à travers une taxonomie de dix-neuf domaines de vie construite à partir de la littérature fondatrice de la technique : Jim Lewis pour la signification planète-angle, Erin Sullivan pour ce que chaque angle gouverne, et Martin Davis pour le traitement des lignes difficiles. Chaque domaine nomme les lignes qui lui appartiennent avec un poids de un à trois, ainsi un Soleil sur le Milieu du Ciel prime sur un Mercure sur le même angle pour la carrière. Chaque correspondance porte aussi une polarité, et les lignes difficiles sont renvoyées avec les lignes favorables plutôt que filtrées, car un outil de relocalisation qui ne montre que les lignes favorables déforme la technique. Quand tu fournis un point, les lignes hors du rayon disparaissent et la force renvoyée multiplie le poids astrologique par la proximité géographique, ce qui te permet de classer les villes candidates plutôt que de simplement lister les lignes. Le texte d'interprétation provient d'une base de connaissances curée couvrant les quarante combinaisons planète-angle en onze langues, avec un fallback documenté lorsqu'une traduction manque.
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
Utilise ça quand ton produit répond à une question en langage ordinaire : où devrais-je aller pour travailler, quelle de ces trois villes est la meilleure pour une relation, que signifie réellement cette ligne au-dessus de ma ville. Trois formes couvrent la plupart des implémentations. Classement, en envoyant une catégorie et un point par ville candidate puis en triant par force. Explication, en appelant /v1/acg/line-report pour une seule planète et un angle afin d’obtenir le texte complet plus chaque autre domaine de vie que la ligne touche. Découverte, en récupérant GET /v1/acg/categories une fois avec zéro crédit et en construisant ton UI à partir de la taxonomie renvoyée, ainsi une nouvelle catégorie apparaît sans mise à jour du client. Parce que le texte est curé plutôt que généré, les réponses sont déterministes, ne citent aucun modèle, et ne coûtent rien de plus en inférence : la même requête renvoie les mêmes mots demain.
Notes
La taxonomie couvre les dix corps traditionnels. Chiron, Lilith et les nœuds lunaires apparaissent dans la géométrie /v1/acg mais sont délibérément hors de la correspondance, car la technique telle que définie par Jim Lewis ne leur attribue pas de domination angulaire de domaine de vie. Les poids et les polarités sont un jugement éditorial exprimé comme données, versionnées dans le dépôt et auditable plutôt que cachées dans un prompt. Le texte d'interprétation est une recherche dans une base de connaissances, pas un appel à un modèle de langage, il est donc stable, reproductible hors ligne et exempt des avertissements que nécessite une interprétation générée.
Try the Interprétations d'Astrocartographie API
Grab a key and make your first call in under a minute.