API Întoarcere Solară
Generează harta pentru momentul exact când Sun revine la gradul natal într-un an ales – ziua de naștere astrologică. Trimite o hartă natală și un an, primești harta de solar return pentru acel ciclu. tropical, Sun-to-natal-Sun, Swiss Ephemeris precision, JSON out.
API Întoarcere Solară
Endpoint-ul solar-return citește mai întâi longitudinea zodiacală exactă a Sun natal din datele de naștere furnizate, apoi caută în anul dat momentul precis când Sun tranzitor revine la aceeași longitudine – de obicei în decurs de o zi de la ziua de naștere calendaristică. Transformă acel moment de întoarcere într-o zi Juliană, extrage pozițiile și vitezele geocentrice din motorul Swiss Ephemeris și generează o hartă completă: planetele de întoarcere cu semne și poziții în case, cuspidele caselor și grila completă de aspecte cu flaguri de aplicare și separare și orburi exacte. Potrivirea este tropicală și Sun-to-natal-Sun, fără corecție de precesiune implicit, așa că Sun de întoarcere stă pe gradul tropical al Sun natal. Harta rezultată este citită ca harta temei dominante pentru anul care curge de la o zi de naștere la alta.
POST/v1/solar-return
curl -X POST https://api.astroway.info/v1/solar-return \
-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": {
"input": {},
"planets": [
{
"name": "Sun",
"longitude": 54.23,
"sign": "Taurus",
"house": 9
}
],
"houses": {
"ascendant": 188.2,
"mc": 95,
"cusps": [
"…"
]
},
"aspects": [
"…"
]
}
}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). |
| year | number | yes | Required integer year in which to find the Sun's return to its natal longitude. |
When to use it
Folosește solar return pentru prognoze anuale – un raport „un an înainte”, o funcție de hartă de ziua de naștere, sau un flux AI care construiește o perspectivă de doisprezece luni dintr-o singură hartă datată. E motorul principal al predicției bazate pe întoarcere: unghiurile, casa în care cade Sun de întoarcere și cele mai strânse aspecte sunt citite ca temele principale ale anului solar. Combina-l cu tranzite și progresii pentru profunzime, dar solar return singur oferă o captură anuală curată, autonomă, legată de ziua de naștere a persoanei, nu de calendar. Pentru că trimiți doar date natal și un an, se potrivește perfect în declanșatoarele de aniversare și emailurile anuale programate – recalculează în fiecare an pentru a avansa prognoza.
Notes
Întoarcerea este potrivită tropical, Sun la Sun natal, și nu este corectată pentru precesiune implicit, așa că reflectă întoarcerea solară occidentală convențională, nu varianta corectată sidereal. Este generată pentru locația natală furnizată; întoarcerile solare relocate ar necesita recast la alt loc. Zodiac tropical și Swiss Ephemeris pe tot parcursul.
Try the Întoarcere Solară API
Grab a key and make your first call in under a minute.