Ηλιακή Επιστροφή API
Δημιούργησε το χάρτη για τη ακριβή στιγμή που ο Ήλιος επιστρέφει στο γενέθλιο βαθμό του σε μια επιλεγμένη χρονιά – το αστρολογικό γενέθλιο. Δώσε έναν γενέθλιο χάρτη και μια χρονιά, και πάρε το χάρτη ηλιακής επιστροφής για αυτόν τον κύκλο. Τροπικό, Ήλιος-προς-γενέθλιο-Ήλιο, ακρίβεια Swiss Ephemeris, JSON έξοδος.
Ηλιακή Επιστροφή API
Το solar-return endpoint πρώτα διαβάζει τη ακριβή ζωδιακή γεωγραφική θέση του γενέθλιου Ήλιου από τα παρεχόμενα δεδομένα γέννησης, μετά ψάχνει τη δεδομένη χρονιά για τη στιγμή που ο διασχίζων Ήλιος επιστρέφει στην ίδια γεωγραφική θέση – συνήθως μέσα σε μια ή δύο ημέρες από το ημερολογιακό γενέθλιο. Μετατρέπει αυτή τη στιγμή επιστροφής σε Julian day, αντλεί γεωκεντρικές θέσεις και ταχύτητες από τη μηχανή Swiss Ephemeris, και δημιουργεί πλήρη χάρτη: τους πλανήτες επιστροφής με ζώδια και θέσεις σε οίκους, τις κορυφές των οίκων, και το πλήρες πλέγμα όψεων με σημαίες εφαρμογής/διαχωρισμού και ακριβείς ορβές. Η αντιστοίχιση είναι tropical και Sun-to-natal-Sun, χωρίς προσαρμογή precession-corrected από προεπιλογή, έτσι ο επιστρεφόμενος Ήλιος βρίσκεται στο γενέθλιο tropical βαθμό του Ήλιου. Ο προκύπτων χάρτης διαβάζεται ως ο χάρτης κυρίαρχου θέματος για το έτος από το ένα γενέθλιο στο επόμενο.
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
Χρησιμοποίησε την ηλιακή επιστροφή για ετήσια πρόβλεψη – μια αναφορά «έτος μπροστά», μια λειτουργία γενεθλίου χάρτη, ή μια ροή AI που δημιουργεί προοπτική δώδεκα μηνών από έναν μόνο χρονολογημένο χάρτη. Είναι η κύρια μηχανή της πρόβλεψης βάσει επιστροφής: οι γωνίες, ο οίκος όπου πέφτει ο επιστρεφόμενος Ήλιος, και οι πιο στενές όψεις διαβάζονται ως τα κύρια θέματα του ηλιακού έτους. Συνδύασε το με transits και progressions για βάθος, αλλά η ηλιακή επιστροφή μόνη της δίνει ένα καθαρό, αυτόνομο ετήσιο στιγμιότυπο συνδεδεμένο με το δικό σου γενέθλιο αντί του ημερολογίου. Επειδή δίνεις μόνο γενέθλια δεδομένα και μια χρονιά, ταιριάζει τέλεια σε ενεργοποιητές επετείων και προγραμματισμένα ετήσια email – επανυπολόγισε κάθε χρόνο για να προωθήσεις την πρόβλεψη.
Notes
Η επιστροφή ταιριάζει tropically, Sun to natal Sun, και δεν είναι precession-corrected από προεπιλογή, έτσι αντικατοπτρίζει την συμβατική Δυτική ηλιακή επιστροφή αντί της sidereal-corrected παραλλαγής. Δημιουργείται για την παρεχόμενη γενέθλια τοποθεσία· οι μετακινημένες ηλιακές επιστροφές θα απαιτούν επαναδημιουργία σε διαφορετικό μέρος. Tropical zodiac και Swiss Ephemeris σε όλη τη διάρκεια.
Try the Ηλιακή Επιστροφή API
Grab a key and make your first call in under a minute.