Local Space API astrologii

endpoint buduje wykres natalny, przekształca każdą planetę z współrzędnych ekliptycznych do ramki horyzontalnej miejsca urodzenia i zwraca jej azymut w stopniach zgodnie z ruchem wskazówek zegara od prawdziwej północy oraz jej wysokość nad lub pod horyzontem. Następnie projekcjonuje każdy azymut jako wielki okrąg wychodzący z miejsca urodzenia i zwraca powstałą ścieżkę jako serię współrzędnych, tak aby linia narysowana na mapie świata zachowała prawdziwy kierunek, a nie prostą na płaskiej projekcji. Pokryto trzynaście ciał, każde z stałym kolorem, więc renderowana mapa zachowuje tę samą paletę co reszta zestawu. Wysokość jest tak samo ważna jak azymut: planeta pod horyzontem przy narodzinach odczytywana jest inaczej niż ta wysoko na niebie w tym samym kierunku.

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

Używaj local space, gdy produkt dotyczy kierunku i odległości od stałego domu, a nie absolutnej pozycji na globie. Dwie sytuacje dominują. Pierwsza to przeprowadzka na dowolną skalę, od wyboru miasta leżącego w korzystnym kierunku po decyzję, w którą stronę się przemieścić w obrębie jednego kraju, ponieważ wielki okrąg z miejsca urodzenia przecina znacznie więcej użytecznego terenu niż garść linii astrocartografii. Druga to prace wewnętrzne i terenowe, gdzie te same azymuty odczytuje się w skali pokoju wewnątrz budynku: endpoint zwraca kierunki, a towarzysz /local-space/influence-zone zamienia jeden z nich w wielokąt stożkowy, który możesz narysować. Jeśli już renderujesz astrocartografię, dodanie local space to najtańszy sposób, by podwoić głębokość funkcji przeprowadzki, bo używa tych samych danych urodzeniowych i tej samej powierzchni mapy.

Pozycje pochodzą z Swiss Ephemeris (Astrodienst). Azymut jest mierzony zgodnie z ruchem wskazówek zegara od prawdziwej północy, nie od magnetycznej, więc nie stosuje się ani nie potrzebuje korekty deklinacji. Ścieżka wielkiego koła zwracana jest jako próbkowane współrzędne, a nie jako wzór, co utrzymuje klienta wolnym od geometrii sferycznej. Technika w tej formie została opracowana przez Michaela Erlewine i jest udokumentowana w jego Astrophysical Directions.