Astrocartography API
Astrocartography prend un instant de naissance unique et le projette sur toute la planète : au lieu de demander où étaient les planètes dans le ciel, il demande où chaque planète était angulaire sur Terre. L'endpoint renvoie la line geometry que tu traces sur une carte du monde pour voir quelles longitudes activent quelle énergie planétaire.
Astrocartography API
À partir de la date de naissance, de l'heure, du décalage UTC et des coordonnées de naissance, l'endpoint fixe le ciel exact pour cet instant, puis balaie le globe pour trouver chaque méridien et courbe où une planète se trouvait sur l'un des quatre angles. Pour chacune des dix planètes plus les nœuds, il trace quatre familles de lignes : la ligne de lever où le corps était sur l'Ascendant, la ligne de coucher sur le Descendant, la ligne culminante sur le Midheaven, et la ligne anti-culminante sur l'Imum Coeli. Les lignes MC et IC sont des méridiens nets ; les lignes AC et DC se courbent selon la latitude, car un corps qui se lève à l'est à une latitude se lève bien plus au nord ou au sud à une autre. Tout est renvoyé comme line geometry sérialisable sous data.lines, prêt à être injecté directement dans une bibliothèque de cartographie. C’est la technique de relocalisation popularisée par Jim Lewis sous le nom d’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": [
"…"
]
}
]
}
}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 (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
When to use it
Utilise cet endpoint quand la localisation est la variable et que tu veux savoir comment une carte se réexprime sur la carte – pour des conseils de relocalisation, des outils de voyage ou de choix de lieu de vie, ou toute fonctionnalité qui superpose la carte d’une personne sur un globe. C’est le backend naturel d’une carte interactive : demande les lignes une fois pour un instant de naissance, rends-les en polylines, et laisse l'utilisateur se déplacer sur les continents pour lire quelle planète gouverne quel couloir. Comme le résultat est de la pure géométrie plutôt que du texte, il s’intègre proprement à ton propre style front-end, au clustering et aux calques click-to-interpret. Combine-le avec l’appel natal-chart quand tu veux à la fois la structure de la carte d’origine et les lignes relocalisées côte à côte ; les deux partagent la même résolution de naissance, donc les positions planétaires derrière la carte concordent exactement.
Notes
Les positions proviennent du Swiss Ephemeris (Astrodienst), le même moteur derrière les endpoints natals, donc les lignes s’ancrent aux mêmes longitudes planétaires. L'angularité est calculée dans le tropical zodiac. La réponse ne transporte que de la géométrie – le dessin, la projection et le style de la carte du monde sont laissés à ton client.
Try the Astrocartography API
Grab a key and make your first call in under a minute.