AstroWay/api v2.296.1 · de
alle Systeme in Ordnung
// astrology api · POST /v1/solar-acg

Solar-Rückkehr-Astrocartographie-API

Die Geburtsastrocartographie beantwortet, wo ein Chart funktioniert. Die Solar-Rückkehr-Astrocartographie beantwortet, wo er dieses Jahr funktioniert. Der Endpunkt berechnet den genauen Zeitpunkt, an dem die Sonne in von Ihnen angegebenen Jahr zu ihrer Geburts-Längengrade zurückkehrt, und kartiert diesen Chart über den Globus als eigene Satz von Winkel-Linien.

Endpunkt
POST /v1/solar-acg
Kosten
100 Credits
Latenz
~346 ms
Stufe
Tier 4
// 01 / Was es berechnet

Solar-Rückkehr-Astrocartographie-API

Der Endpunkt erstellt zuerst das Geburts-Chart, dann sucht er nach dem Zeitpunkt im angefragten Jahr, an dem die Sonne die Geburts-Sonnengrade erreicht, mit einer Genauigkeit von weit unter einer Bogensekunde. Er berechnet die Planetenpositionen für diesen Zeitpunkt und zeichnet die vier Winkel-Linienfamilien über die Welt, genau wie der Geburtsastrocartographie-Endpunkt, und gibt dreiundsechzig Linien zurück. Jeder Planetenname trägt einen SR-Suffix, damit ein Client, der beide Karten gleichzeitig darstellt, eine Geburts-Jupiter-Linie nicht mit einer Solar-Rückkehr-Linie verwechseln kann. Die Linien werden als Koordinatenpaare in der gleichen Form wie /acg zurückgegeben, sodass ein bestehender Renderer keine Änderungen benötigt, außer einem Stil für die zweite Ebene.

// 02 / Live-Anfrage

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

Parameter

nametypeErforderlich
date string (YYYY-MM-DD) ja Birth date.
time string (HH:MM:SS) ja Local clock time at birth.
timezoneOffset number (hours) ja UTC offset in effect at the birth moment.
latitude number ja Birth-place latitude, decimal degrees.
longitude number ja Birth-place longitude, decimal degrees.
year number ja Calendar year of the solar return whose map you want.
// 04 / Wann verwenden

Wann verwenden

Dies ist der Endpunkt hinter der kommerziell wichtigsten Frage in der Umzugsastrologie: Wo soll ich meinen Geburtstag verbringen und wo soll ich dieses Jahr stationiert sein. Solar-Rückkehr-Charts werden traditionell für den Ort erstellt, an dem die Person sich physisch zur Rückkehr befindet, was den Ort zu einer Entscheidung statt eines gegebenen Faktors macht, und diese Karte ist es, die diese Entscheidung in etwas Sichtbares für den Benutzer umwandelt. Erstellen Sie einen jährlichen Umzugsbericht, einen Geburtstagsreise-Empfehlung oder eine jährliche Überlagerung auf Ihrer bestehenden Astrocartographie-Karte. Da der zugrundeliegende Rückkehrzeitpunkt sich jedes Jahr ändert, ist das Ergebnis natürlich wiederholbar kaufbarer Inhalt anstatt einer einmaligen Berechnung, und es setzt sich direkt mit /solar-return zusammen, wenn der Benutzer sowohl den Chart als auch die Karte möchte.

// 05 / Hinweise

Hinweise

Die Positionen stammen aus der Schweizer Ephemeris (Astrodienst). Der Rückkehrzeitpunkt wird anhand der Geburts-Sonnengrade im tropischen Tierkreis berechnet; siderale Solar-Rückkehr sind eine andere Technik und nicht das, was dieser Endpunkt berechnet. Die Karte wird allein aus dem Rückkehr-Chart erstellt, sodass sie eine vollständige Ersetzung für die Geburtslinien dieses Jahres ist und keine Modifikation davon. Einige Schulen erstellen den Rückkehr-Chart für den Geburtsort anstelle des aktuellen Ortes; diese Entscheidung gehört zu Ihrer Interpretationsebene, da die Liniengeometrie selbst in beiden Fällen identisch ist.

Solar-Rückkehr-Astrocartographie-API ausprobieren

Hol dir einen Key und mach deinen ersten Aufruf in unter einer Minute.

99,9% SLA · kostenpflichtige Tarife · 30 Tage Status →