API di astrocartografia del ritorno solare

L'endpoint prima costruisce la carta natale, poi cerca l'istante nell'anno richiesto in cui il Sole transitorio raggiunge la longitudine solare natale, con una precisione ben inferiore a un secondo d'arco. Calcola le posizioni planetarie per quell'istante e traccia le quattro famiglie di linee angolari nel mondo, esattamente come fa l'endpoint di astrocartografia natale, restituendo sessantatré linee. Ogni nome di pianeta porta il suffisso SR così un client che rende entrambe le mappe contemporaneamente non confonde una linea Giove natale con una di ritorno solare. Le linee sono restituite come coppie di coordinate nella stessa forma di /acg, così un renderer esistente non ha bisogno di cambiamenti oltre a uno stile per il secondo livello.

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

Questo è l'endpoint dietro la domanda più commerciale nell'astrologia della relocation: dove dovrei trascorrere il mio compleanno e dove dovrei stabilirmi quest'anno. Le carte di ritorno solare sono tradizionalmente calcolate per il luogo in cui la persona si trova fisicamente al ritorno, il che rende la posizione una decisione piuttosto che un dato, e questa mappa è ciò che trasforma quella decisione in qualcosa che l'utente può vedere. Costruisci un rapporto di relocation annuale, un consigliere per viaggi di compleanno, o una sovrapposizione annuale sulla tua mappa di astrocartografia esistente. Poiché il momento di ritorno sottostante cambia ogni anno, il risultato è naturalmente contenuto riacquistabile anziché un calcolo una tantum, e si compone direttamente con /solar-return quando l'utente vuole anche la carta oltre alla mappa.

Le posizioni provengono dalla Swiss Ephemeris (Astrodienst). L'istante di ritorno è risolto rispetto alla longitudine solare natale nello zodiaco tropicale; i ritorni solari siderei sono una tecnica diversa e non sono ciò che calcola questo endpoint. La mappa è disegnata solo dalla carta di ritorno, quindi è una sostituzione completa delle linee natali per quell'anno anziché una loro modifica. Alcune scuole calcolano il ritorno per il luogo di nascita invece che per la posizione attuale; quella scelta appartiene al tuo livello di interpretazione, poiché la geometria delle linee è identica in entrambi i casi.