API astrocartography solar return

Endpoint pertama membangun chart natal, lalu mencari momen di tahun yang diminta saat Sun transiting mencapai longitude solar natal, dengan presisi jauh di bawah satu detik busur. Ia menghitung posisi planet untuk momen itu dan menelusuri empat keluarga garis angular di seluruh dunia, persis seperti endpoint astrocartography natal, mengembalikan enam puluh tiga garis. Setiap nama planet memiliki sufiks SR sehingga client yang menampilkan kedua peta sekaligus tidak akan bingung antara garis Jupiter natal dengan yang solar return. Garis-garis dikembalikan sebagai pasangan koordinat dengan bentuk yang sama seperti /acg, jadi renderer yang ada tidak perlu perubahan selain gaya untuk lapisan kedua.

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

Ini adalah endpoint di balik pertanyaan paling komersial dalam astrologi relokasi: di mana saya harus menghabiskan ulang tahun saya, dan di mana saya harus berada tahun ini. Chart solar return biasanya dibuat untuk lokasi fisik orang saat return, yang membuat lokasi menjadi keputusan bukan hal yang pasti, dan peta ini mengubah keputusan itu menjadi sesuatu yang bisa dilihat user. Bangun laporan relokasi tahunan, rekomendasi perjalanan ulang tahun, atau overlay tahunan pada peta astrocartography kamu yang sudah ada. Karena momen return yang mendasarinya berubah tiap tahun, hasilnya secara alami menjadi konten yang dapat dibeli kembali bukan perhitungan sekali pakai, dan ia dapat digabung langsung dengan /solar-return ketika user ingin chart sekaligus peta.

Posisi diambil dari Swiss Ephemeris (Astrodienst) yang dikompilasi ke WASM. Momen return diselesaikan terhadap longitude solar natal di tropical zodiac; sidereal solar returns adalah teknik berbeda dan bukan yang dihitung endpoint ini. Peta digambar hanya dari chart return, jadi ini menggantikan seluruh garis natal untuk tahun itu, bukan memodifikasi mereka. Beberapa aliran membuat return untuk birthplace alih-alih lokasi saat ini; pilihan itu menjadi lapisan interpretasimu, karena geometri garisnya identik keduanya.