AstroWay/api v2.296.1 · pl
wszystkie systemy w normie
// astrology api · POST /v1/parans

Parans API

Paran to punkt, w którym krzyżują się dwie linie astrocartografii: miejsce, w którym dwie planety były jednocześnie kątowe. Ten endpoint zwraca każde przecięcie dla momentu urodzenia, z współrzędnymi każdego z nich, tak abyś mógł zaznaczyć na mapie punkty, w których dwa tematy planetarne łączą się, a nie tylko biegną obok siebie.

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

Parans API

Endpoint przelicza moment urodzenia na Julian day, oblicza pełny zestaw astrocartografii (cztery linie kątowe na ciało), a potem przecina każdą linię z każdą linią należącą do innej planety. Każde przecięcie zwracane jest z obiema planetami rodzicami, oboma typami linii oraz szerokością i długością geograficzną, gdzie przecięcie występuje. Ponieważ linie MC i IC są południkami, a linie AC i DC są krzywymi zależnymi od szerokości, większość przecięć jest geometryczna, a nie symetryczna: para Sun-MC i Moon-ASC spotyka się w dokładnie jednym miejscu na półkuli, nie na wspólnej strefie. Typowy wykres daje ponad czterysta przecięć na całym świecie, dlatego zwracane są jako płaska, sortowalna lista, a nie wstępnie odfiltrowana pod kątem ważności.

// 02 / Zapytanie na żywo

POST/v1/parans

curl -X POST https://api.astroway.info/v1/parans \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3
}'
Odpowiedź (fragment)
{
  "ok": true,
  "data": {
    "count": 414,
    "parans": [
      {
        "planet1Id": 0,
        "planet1Name": "Sun",
        "line1Type": "MC",
        "planet2Id": 1,
        "planet2Name": "Moon",
        "line2Type": "ASC",
        "location": { "lat": -45.9153, "lng": 6.5735 }
      }
    ]
  }
}
// 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) nie UTC offset in effect at the birth moment. Defaults to 0. Decimal allowed for half-hour zones.
// 04 / Kiedy używać

Kiedy używać

Używaj parans, gdy same linie astrocartografii są zbyt ogólne. Linie mówią użytkownikowi, że korytarz niesie Jowisza; parans mówią, że w jednym konkretnym miejscu tego korytarza Jowisz spotyka Wenus. To rozróżnienie jest tym, za co konsultanci ds. relokacji pobierają opłatę, i jest warstwą, którą większość narzędzi mapowych pomija. Praktycznie: renderuj linie jako polilinie, a parans jako klikalne markery, albo przefiltruj listę do par planet, które są ważne dla twojego produktu i posortuj pobliskie miasta pod kątem odległości od tych punktów. Odpowiedź zawiera tylko współrzędne, więc możesz połączyć ją ze swoim własnym zestawem danych miast lub regionów bez walki z formatem tekstowym. Zauważ, że ten endpoint nie wymaga miejsca urodzenia, tylko moment, ponieważ przecięcia są własnościami nieba, a nie miejsca, w którym osoba się znajdowała.

// 05 / Uwagi

Uwagi

Pozycje pochodzą ze Swiss Ephemeris (Astrodienst), tego samego silnika co endpointy natalne, więc parans są zakotwiczone w tych samych długościach planetarnych co linie, z których pochodzą. Przecięcia obliczane są w tropikalnym zodiaku z pełnej geometrii linii, a nie z przybliżenia szerokości. Klasyczna doktryna parans, jaką przedstawiła Bernadette Brady, obejmuje także parans gwiazda-planeta i podaje je jako szerokość, a nie punkt; ten przypadek ma własny endpoint, [star-planet parans](/astrology-api/star-parans/). Ten opisuje przypadek planeta-planeta, który generuje sama mapa astrocartografii.

Wypróbuj API Parans

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

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