AstroWay/api v2.95.1 · pl
wszystkie systemy w normie
// astrology api · POST /v1/astrocartography

API astrokartografii

Astrokartografia bierze pojedynczy moment narodzin i rzutuje go na całą planetę: zamiast pytać, gdzie planety były na niebie, pyta, gdzie na Ziemi każda planeta była kątowa. Endpoint zwraca geometrię linii, którą nanosisz na mapę świata, aby zobaczyć, które długości geograficzne aktywują którą energię planetarną.

Endpoint
POST /v1/astrocartography
Koszt
50 kredytów
Opóźnienie
~76 ms
Poziom
Tier 3
// 01 / Co oblicza

API astrokartografii

Na podstawie daty urodzenia, godziny zegarowej, przesunięcia UTC i współrzędnych urodzenia endpoint ustala dokładne niebo dla tej chwili, a następnie omiata kulę ziemską, aby znaleźć każdy południk i krzywą, gdzie planeta stała na jednym z czterech kątów. Dla każdej z dziesięciu planet plus węzłów wykreśla cztery rodziny linii: linię wschodzącą, gdzie ciało było na Ascendencie, linię zachodzącą na Descendencie, linię kulminującą na Medium Coeli oraz linię antykulminującą na Imum Coeli. Linie MC i IC biegną jako czyste południki; linie AC i DC wyginają się jako krzywe zależne od szerokości geograficznej, ponieważ ciało, które wschodzi dokładnie na wschodzie na jednej szerokości, na innej wschodzi daleko na północy lub południu. Wszystko jest zwracane jako serializowalna geometria linii pod data.lines, gotowa do bezpośredniego zasilenia biblioteki mapowej. To technika relokacyjna spopularyzowana przez Jima Lewisa jako Astro*Carto*Graphy.

// 02 / Zapytanie na żywo

POST/v1/astrocartography

curl -X POST https://api.astroway.info/v1/astrocartography \
  -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
}'
Odpowiedź (fragment)
{
  "ok": true,
  "data": {
    "lines": [
      {
        "planet": "Venus",
        "type": "MC",
        "longitude": 14.2
      },
      {
        "planet": "Jupiter",
        "type": "AC",
        "points": [
          "…"
        ]
      }
    ]
  }
}
// 03 / Parametry

Parametry

nametypeWymagane
date string (YYYY-MM-DD) tak Birth date.
time string (HH:MM:SS) tak Local clock time at birth.
timezoneOffset number (hours) tak UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones.
latitude number tak Birth-place latitude, decimal degrees (north positive).
longitude number tak Birth-place longitude, decimal degrees (east positive).
// 04 / Kiedy używać

Kiedy używać

Użyj tego endpointu, gdy lokalizacja jest zmienną i chcesz wiedzieć, jak horoskop wyraża się na nowo na całej mapie — do porad relokacyjnych, narzędzi podróżniczych i wyboru miejsca zamieszkania lub każdej funkcji nakładającej horoskop osoby na kulę ziemską. To naturalny backend dla interaktywnej mapy: zażądaj linii raz dla momentu narodzin, wyrenderuj je jako łamane i pozwól użytkownikowi przesuwać widok między kontynentami, aby odczytać, która planeta rządzi którym korytarzem. Ponieważ wynik to czysta geometria, a nie tekst, komponuje się czysto z twoim własnym stylowaniem front-endu, grupowaniem i warstwami kliknij-aby-zinterpretować. Połącz go z wywołaniem natal-chart, gdy chcesz mieć obok siebie zarówno strukturę horoskopu domowego, jak i linie relokowane; oba dzielą tę samą rozdzielczość narodzin, więc pozycje planetarne pod mapą zgadzają się dokładnie.

// 05 / Uwagi

Uwagi

Pozycje pochodzą ze Swiss Ephemeris (Astrodienst) skompilowanego do WASM, tego samego silnika, który stoi za endpointami natalnymi, więc linie zakotwiczają się na identycznych długościach planetarnych. Kątowość obliczana jest w zodiaku tropikalnym. Odpowiedź niesie wyłącznie geometrię — rysowanie, projekcja i stylowanie mapy świata pozostawione są twojemu klientowi.

Wypróbuj API Astrokartografia

Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.

99.9% SLA · plany płatne · 30d status →