API d'astrocartographie de retour solaire
L'astrocartographie natale répond à la question de l'endroit où une carte fonctionne. L'astrocartographie de retour solaire répond à la question de l'endroit où elle fonctionne cette année. L'endpoint calcule le moment exact où le Soleil revient à sa longitude natale dans l'année que tu spécifies, puis projette cette carte sur le globe sous forme de ses propres lignes angulaires.
API d'astrocartographie de retour solaire
L'endpoint construit d'abord la carte natale, puis recherche l'instant dans l'année demandée où le Soleil transitoire atteint la longitude solaire natale, avec une précision bien inférieure à une seconde d'arc. Il calcule les positions planétaires pour cet instant et trace les quatre familles de lignes angulaires à travers le monde, exactement comme le fait l'endpoint d'astrocartographie natale, en renvoyant soixante-trois lignes. Chaque nom de planète porte le suffixe SR afin qu'un client affichant les deux cartes simultanément ne confonde pas une ligne Jupiter natale avec une ligne de retour solaire. Les lignes sont renvoyées sous forme de paires de coordonnées dans le même format que /acg, ainsi un rendu existant n'a besoin d'aucune modification autre qu'un style pour la seconde couche.
POST/v1/solar-acg
curl -X POST https://api.astroway.info/v1/solar-acg \
-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,
"year": 2026
}'{
"ok": true,
"data": {
"year": 2026,
"lines": [
{
"planet": "Sun (SR)",
"planetId": 0,
"type": "MC",
"coordinates": [[-85, 110.4845], [-84.5, 110.4845], "…"]
}
]
}
}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. |
| year | number | yes | Calendar year of the solar return whose map you want. |
When to use it
C'est l'endpoint derrière la question la plus commerciale en astrologie de relocalisation : où passer ton anniversaire, et où être basé cette année. Les cartes de retour solaire sont traditionnellement dressées pour l'endroit où la personne se trouve physiquement au moment du retour, ce qui fait de la localisation une décision plutôt qu'un donné, et cette carte transforme cette décision en quelque chose que l'utilisateur peut voir. Crée un rapport de relocalisation annuel, un recommandateur de voyage d'anniversaire, ou une superposition annuelle sur ta carte d'astrocartographie existante. Comme le moment de retour sous-jacent change chaque année, le résultat est naturellement un contenu réachetable plutôt qu'un calcul ponctuel, et il se combine directement avec /solar-return quand l'utilisateur veut la carte ainsi que la carte.
Notes
Les positions proviennent du Swiss Ephemeris (Astrodienst) compilé en WASM. L'instant de retour est résolu par rapport à la longitude solaire natale dans le zodiaque tropical ; les retours solaires sidéraux sont une technique différente et ne sont pas ce que calcule cet endpoint. La carte est dessinée uniquement à partir de la carte de retour, elle remplace complètement les lignes natales pour cette année plutôt que de les modifier. Certaines écoles dressent le retour pour le lieu de naissance au lieu de l'emplacement actuel ; ce choix appartient à ta couche d'interprétation, puisque la géométrie des lignes est identique dans les deux cas.
Try the Solar Return Astrocartography API
Grab a key and make your first call in under a minute.