Local Space Astrologie-API

Der endpoint erstellt das Geburtshoroskop, wandelt jeden Planeten von ekliptischen Koordinaten in das Horizont-System des Geburtsortes um und gibt seinen Azimut in Grad im Uhrzeigersinn vom wahren Norden zusammen mit seiner Höhe über oder unter dem Horizont zurück. Dann projiziert er jeden Azimut als Großkreis vom Geburtsort aus und liefert den resultierenden Pfad als Reihe von Koordinaten, sodass eine Linie auf einer Weltkarte eine wahre Richtung bleibt und nicht eine gerade Linie auf einer flachen Projektion. Dreizehn Himmelskörper werden abgedeckt, jeder mit einer stabilen Farbe, sodass die gerenderte Karte dieselbe Palette wie der Rest der Suite behält. Hier ist die Höhe genauso wichtig wie der Azimut: Ein Planet unter dem Horizont bei der Geburt wird anders gelesen als einer hoch am Himmel in derselben Richtung.

curl -X POST https://api.astroway.info/v1/local-space \
  -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
}'

{
  "ok": true,
  "data": {
    "birthplace": { "latitude": 50.45, "longitude": 30.52 },
    "count": 13,
    "lines": [
      {
        "planetId": 0,
        "planetName": "Sun",
        "azimuth": 219.8018,
        "altitude": 53.1309,
        "color": "#FFB300",
        "points": [{ "lat": 50.45, "lng": 30.52 }, "…"]
      }
    ]
  }
}

Nutze Local Space, wenn dein Produkt über Richtung und Entfernung von einem festen Zuhause geht und nicht über die absolute Position auf dem Globus. Zwei Fälle dominieren. Der erste ist Umzug jeder Größe, von der Auswahl, welche Stadt entlang einer günstigen Richtung liegt, bis zur Entscheidung, in welche Richtung du innerhalb eines Landes ziehen willst, weil ein Großkreis vom Geburtsort viel mehr nutzbares Gebiet überquert als ein paar Astrocartografie-Meridiane. Der zweite ist Innen- und Standortarbeit, wo dieselben Azimute im Raummaßstab innerhalb einer Wohnung gelesen werden: Der endpoint liefert die Richtungen, und der /local-space/influence-zone Begleiter verwandelt eine davon in ein Kegel-Polygon, das du zeichnen kannst. Wenn du bereits Astrocartografie renderst, ist das Hinzufügen von Local Space der günstigste Weg, die Tiefe einer Umzugsfunktion zu verdoppeln, da dieselbe Geburtseingabe und dieselbe Kartenoberfläche verwendet werden.

Positionen stammen aus der Swiss Ephemeris (Astrodienst). Der Azimut wird im Uhrzeigersinn vom wahren Norden gemessen, nicht vom magnetischen Norden, sodass keine Deklinationskorrektur angewendet oder nötig ist. Der Großkreis-Pfad wird als gesampelte Koordinaten zurückgegeben, nicht als Formel, wodurch der Client von sphärischer Geometrie frei bleibt. Die Technik in dieser Form wurde von Michael Erlewine entwickelt und in seinen Astrophysical Directions dokumentiert.