Zonne-terugkeer astrocartografie API

Het endpoint bouwt eerst de geboortekaart, dan zoekt het naar het moment in het gevraagde jaar waarop de doorgaande Zon de geboortezonnelengtegraad bereikt, met een precisie van minder dan een boogseconde. Het berekent de planetaire posities voor dat moment en tekent de vier hoeklijnenfamilies over de wereld, precies zoals het geboorte-astrocartografie endpoint doet, en retourneert drieënzestig lijnen. Elke planeetnaam draagt een SR-suffix zodat een client die beide kaarten tegelijk rendert een geboorte-Jupiterlijn niet kan verwarren met een zonne-terugkeerlijn. De lijnen worden geretourneerd als coördinatenparen in dezelfde vorm als /acg, dus een bestaande renderer heeft geen wijzigingen nodig behalve een stijl voor de tweede laag.

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

Dit is het endpoint achter de meest commerciële vraag in verhuisastrologie: waar moet ik mijn verjaardag vieren, en waar moet ik dit jaar gevestigd zijn. Zonne-terugkeer kaarten worden traditioneel gemaakt voor waar de persoon fysiek is op het moment van terugkeer, wat locatie een beslissing maakt in plaats van een gegeven, en deze kaart is wat die beslissing omzet in iets dat een gebruiker kan zien. Bouw een jaarlijks verhuisrapport, een verjaardagstrip-adviseur, of een jaarlijkse overlay op uw bestaande astrocartografiekaart. Omdat de onderliggende terugkeermoment elk jaar verandert, is het resultaat van nature herkoopbare content in plaats van een eenmalige berekening, en het combineert direct met /solar-return wanneer de gebruiker zowel de kaart als de kaart wil.

Posities komen uit de Swiss Ephemeris (Astrodienst) gecompileerd naar WASM. Het terugkeermoment wordt berekend op basis van de geboortezonnelengtegraad in de tropische dierenriem; siderale zonne-terugkeers zijn een andere techniek en zijn niet wat dit endpoint berekent. De kaart wordt getekend op basis van de terugkeerkaart alleen, dus het is een volledige vervanging voor de geboortelijnen van dat jaar in plaats van een aanpassing ervan. Sommige scholen maken de terugkeer voor de geboorteplaats in plaats van de huidige locatie; die keuze behoort tot uw interpretatielaag, aangezien de lijngeometrie zelf identiek is in beide gevallen.