AstroWay/api v2.173.1 · ro
toate sistemele sunt în stare normală
// astrology api · POST /v1/solar-acg

API de astrocartografie cu revenirea solară

Astrocartografia natală îți spune unde funcționează o hartă. Astrocartografia cu revenirea solară îți spune unde funcționează anul acesta. Endpoint-ul calculează momentul exact când Soarele revine la longitudinea natală în anul pe care îl specifici, apoi plasează acea hartă pe glob ca un set propriu de linii unghiulare.

Endpoint
POST /v1/solar-acg
Cost
100 credits
Latency
~346 ms
Tier
Tier 4
// 01 / What it computes

API de astrocartografie cu revenirea solară

Endpoint-ul construiește mai întâi harta natală, apoi caută instantul din anul cerut în care Soarele tranzitoriu atinge longitudinea solară natală, cu o precizie mult sub un arc-secundă. Calculează pozițiile planetare pentru acel instant și trasează cele patru familii de linii unghiulare pe glob, exact ca endpoint-ul de astrocartografie natală, returnând șaizeci-trei de linii. Fiecare nume de planetă poartă sufixul SR ca un client ce redă ambele hărți simultan să nu confunde o linie natală de Jupiter cu una de revenire solară. Liniile sunt returnate ca perechi de coordonate în același format ca /acg, așa că un renderer existent nu are nevoie de alte schimbări în afară de un stil pentru al doilea strat.

// 02 / Live request

POST/v1/solar-acg

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
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "year": 2026,
    "lines": [
      {
        "planet": "Sun (SR)",
        "planetId": 0,
        "type": "MC",
        "coordinates": [[-85, 110.4845], [-84.5, 110.4845], "…"]
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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.
latitude number yes Birth-place latitude, decimal degrees.
longitude number yes Birth-place longitude, decimal degrees.
year number yes Calendar year of the solar return whose map you want.
// 04 / When to use it

When to use it

Acesta e endpoint-ul din spatele celei mai comercializate întrebări în astrologia relocării: unde ar trebui să-mi petrec ziua de naștere și unde ar trebui să fiu stabilit anul acesta. Hărțile de revenire solară se calculează tradițional pentru locul în care persoana se află fizic la revenire, ceea ce face ca locația să fie o decizie, nu un dat, și această hartă transformă decizia în ceva ce utilizatorul poate vedea. Construiește un raport anual de relocare, un recomandator de călătorii de ziua de naștere sau un overlay anual pe harta ta de astrocartografie existentă. Pentru că momentul de revenire se schimbă în fiecare an, rezultatul devine conținut revândut în mod natural, nu un calcul unic, și se combină direct cu /solar-return când utilizatorul vrea atât diagrama, cât și harta.

// 05 / Notes

Notes

Pozițiile vin din Swiss Ephemeris (Astrodienst) compilat în WASM. Instantul de revenire este rezolvat față de longitudinea solară natală în zodiacul tropical; revenirea solară siderală este o tehnică diferită și nu e ceea ce calculează acest endpoint. Harta este trasată doar din harta de revenire, deci înlocuiește complet liniile natale pentru acel an, nu le modifică. Unele școli calculează revenirea pentru locul nașterii în loc de locația curentă; alegerea aparține stratului tău de interpretare, deoarece geometria liniei este identică în ambele cazuri.

Try the Astrocartografie cu revenirea solară API

Grab a key and make your first call in under a minute.

99,9% SLA · planuri plătite · 30 zile status →