API αστροκαρτογραφίας επιστροφής ήλιου

Το endpoint πρώτα δημιουργεί το γενέθλιο χάρτη, μετά ψάχνει τη στιγμή μέσα στο ζητούμενο έτος που ο διασχίζων Ήλιος φτάνει στη γενέθλια ηλιακή γεωγραφική θέση, με ακρίβεια πολύ κάτω από ένα δευτερόλεπτο τόξου. Υπολογίζει τις θέσεις των πλανητών για εκείνη τη στιγμή και σχεδιάζει τις τέσσερις οικογένειες γωνιακών γραμμών παγκοσμίως, ακριβώς όπως κάνει το endpoint γενέθλιας αστροκαρτογραφίας, επιστρέφοντας εξήντα τρεις γραμμές. Κάθε όνομα πλανήτη έχει επίθημα SR ώστε ένας client που αποδίδει και τους δύο χάρτες μαζί να μην μπερδέψει τη γενέθλια γραμμή του Δία με αυτήν της επιστροφής ήλιου. Οι γραμμές επιστρέφονται ως ζεύγη συντεταγμένων στην ίδια μορφή με το /acg, έτσι ένας υπάρχων renderer δεν χρειάζεται αλλαγές εκτός από ένα στυλ για το δεύτερο στρώμα.

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], "…"]
      }
    ]
  }
}

Αυτό είναι το endpoint πίσω από την πιο εμπορική ερώτηση στην αστρολογία μετεγκατάστασης: πού πρέπει να περάσω τα γενέθλιά μου, και πού πρέπει να βρίσκομαι φέτος. Οι χάρτες επιστροφής ήλιου συνήθως δημιουργούνται για το μέρος όπου βρίσκεται το άτομο τη στιγμή της επιστροφής, κάτι που κάνει την τοποθεσία απόφαση αντί για δεδομένο, και αυτός ο χάρτης μετατρέπει αυτήν την απόφαση σε κάτι που μπορεί να δει ο χρήστης. Φτιάξε ετήσια αναφορά μετεγκατάστασης, σύσταση ταξιδιού γενεθλίων, ή ετήσιο overlay στον υπάρχοντα χάρτη αστροκαρτογραφίας. Επειδή η βασική στιγμή της επιστροφής αλλάζει κάθε χρόνο, το αποτέλεσμα είναι φυσικά επαναγοραίο περιεχόμενο αντί για μια εφάπαξ υπολογισμό, και συνδυάζεται άμεσα με το /solar-return όταν ο χρήστης θέλει και το χάρτη και το χάρτη.

Οι θέσεις προέρχονται από το Swiss Ephemeris (Astrodienst) μεταγλωττισμένο σε WASM. Η στιγμή της επιστροφής λύνεται σε σχέση με τη γενέθλια ηλιακή γεωγραφική θέση στο τροπικό ζώδιο· οι σεληνιακές επιστροφές ήλιου είναι διαφορετική τεχνική και δεν υπολογίζει αυτό το endpoint. Ο χάρτης σχεδιάζεται μόνο από το χάρτη επιστροφής, έτσι είναι πλήρης αντικατάσταση των γενέθλιων γραμμών για εκείνο το έτος αντί για τροποποίηση. Κάποιες σχολές σχεδιάζουν την επιστροφή για τον τόπο γέννησης αντί για την τρέχουσα θέση· αυτή η επιλογή ανήκει στο επίπεδο ερμηνείας σου, αφού η γεωμετρία των γραμμών είναι ίδια και στις δύο περιπτώσεις.