API Ηλιακών Διαδρομών
Η ηλιακή διαδρομή μετακινεί ολόκληρο τον χάρτη μπροστά κατά έναν αριθμό: την απόσταση που ταξίδεψε ο Ήλιος με τη δευτερογενή προοδευτική κίνηση. Κάπλανη, κάθε κορυφή και και οι δύο γωνίες μετακινούνται κατά την ίδια διαδρομή, οπότε ένας γονιδιακός συνδυασμός που ήταν δύο μοίρες από την ακρίβεια φτάνει στην ακρίβεια περίπου δύο χρόνια αργότερα. Αυτό το endpoint επιστρέφει τον προοδευτικό χάρτη και τη διαδρομή που τον δημιούργησε.
API Ηλιακών Διαδρομών
Από τα δεδομένα γέννησης και μια ημερομηνία-στόχο, το endpoint προοδεύει πρώτα τον χάρτη μέρα προς έτος, μετρά πόσο έχει μετακινηθεί ο προοδευτικός Ήλιος από τη γονιδιακή του θέση, και παίρνει αυτή την απόσταση ως τη διαδρομή. Στη συνέχεια προσθέτει τη διαδρομή σε κάθε γονιδιακό μήκος ταυτόχρονα: όλα τα πλανήτες, όλες οι κορυφές των σπιτιών, το ανατολικό σημείο και τον Μεσημβρινό. Η απάντηση περιέχει τις προοδευτικές θέσεις σε data.planets και data.houses, τη διαδρομή σε μοίρες σε data.arc, και το κλειδί που την δημιούργησε σε data.key. Επειδή μια μόνο διαδρομή εφαρμόζεται ομοιόμορφα, η γεωμετρία του γονιδιακού χάρτη διατηρείται και μόνο η σχέση του με τις γονιδιακές μοίρες αλλάζει, κάτι που κάνει την τεχνική τόσο οικονομική στην ανάγνωση: ένας αριθμός σου λέει την κατάσταση ολόκληρου του χάρτη σε μια δεδομένη ηλικία. Δύο άλλα κλειδιά είναι διαθέσιμα στο ίδιο endpoint. Ορίστε το κλειδί σε naibod για τον μέσο ηλιακό ρυθμό 59'08.3" ανά έτος, ή παραλείψτε το για τον απλό ένα μοίρα ανά έτος. Στέλνοντας converse true, η κατεύθυνση γίνεται προς τα πίσω από τη στιγμή της γέννησης αντί προς τα μπροστά, αντιστρέφοντας το πρόσημο της διαδρομής.
POST/v1/symbolic-directions
curl -X POST https://api.astroway.info/v1/symbolic-directions \
-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,
"targetDate": "2026-05-15",
"key": "solar_arc"
}' {
"ok": true,
"data": {
"arc": 34.5083,
"key": "solar_arc",
"planets": [
{
"id": 0,
"name": "Sun",
"longitude": 88.8843,
"isRetrograde": false
}
],
"houses": {
"system": "P",
"ascendant": 204.4763,
"mc": 111.5826
}
}
} 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. 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). |
| targetDate | string (YYYY-MM-DD) | yes | The date the chart is directed to. |
| key | string | no | Directional key: solar_arc (the arc of the progressed Sun), naibod (59'08.3" per year), or one_degree (the default, 1° per year). |
| converse | boolean | no | Direct backwards from the birth moment instead of forwards. Reverses the sign of the arc. |
When to use it
Ανατρέξτε στην ηλιακή διαδρομή όταν χρειάζεστε χρονισμό που είναι συμβολικός και όχι αστρονομικός, και όταν θέλετε τη μορφή που μπορεί να ακολουθήσει ένας αναγνώστης. Επειδή όλα κινούνται με τον ίδιο ρυθμό, μια προοδευτική επαφή πέφτει σε μια συγκεκριμένη χρονιά αντί σε ένα παράθυρο, ταιριάζει σε μια λειτουργία χρονογραφήματος ζωής, μια αναφορά στα ορόσημα ηλικίας, ή μια αφήγηση AI που πρέπει να πει τι αφορά μια δεδομένη χρονιά. Συνδυάζεται φυσικά με τις δευτερογενείς προοδεύσεις, αφού η διαδρομή προέρχεται από τον ίδιο προοδευτικό Ήλιο: οι προοδεύσεις σου δίνουν τον κινούμενο εσωτερικό χάρτη, η ηλιακή διαδρομή σου δίνει τον ολόκληρο χάρτη μεταφρασμένο μπροστά. Συγκρίνετε τα τρία κλειδιά όταν η ακρίβεια έχει σημασία για το κοινό σας. Η ηλιακή διαδρομή ακολουθεί τον πραγματικό Ήλιο και επομένως διαφέρει ελαφρώς ανάλογα με την ημερομηνία γέννησης, το Naibod χρησιμοποιεί τον μέσο ρυθμό, και μια μοίρα ανά έτος είναι η συμβατική στρογγυλοποίηση. Για γέννηση μέσα στον Μάιο, τα τρία δίνουν περίπου 34.5, 35.5 και 36.0 μοίρες σε 36 χρόνια, αρκετά κοντά για να συμφωνήσουν στη δεκαετία και αρκετά μακριά για να ονομάσουν διαφορετικές χρονιές.
Notes
Η διαδρομή είναι η απόσταση που διανύει ο δευτερογενώς προοδευτικός Ήλιος, μέρα προς έτος, που είναι ο τυπικός ορισμός. Το κλειδί Naibod χρησιμοποιεί τη μέση ημερήσια κίνηση του Ήλιου, 59'08.3" ανά έτος. Για την ηλιακή διαδρομή, ο προοδευτικός χάρτης υπολογίζεται προς τα μπροστά και η κατεύθυνση ταξιδιού εφαρμόζεται μία φορά, οπότε οι αντίστροφες κατευθύνσεις επιστρέφουν τη διαδρομή με αρνητικό πρόσημο αντί διπλάσια. Οι θέσεις προέρχονται από τον μηχανισμό Swiss Ephemeris στον τροπικό ζωδιακό, στα ίδια σώματα και σύστημα σπιτιών με τα γονιδιακά endpoints.
Try the Ηλιακές Διαδρομές API
Grab a key and make your first call in under a minute.