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

API wykresu geodezyjnego równoważnego

Wykres geodezyjny wylicza cztery kąty wyłącznie z geografii. Zero stopni Barana jest przypięte do południka Greenwich, każdy stopień długości geograficznej staje się stopniem zodiaku, a każde miejsce na Ziemi zyskuje Midheaven i Ascendant bez potrzeby podawania czasu urodzenia.

Endpoint
POST /v1/geodetic
Koszt
10 kredytów
Opóźnienie
~121 ms
Poziom
Tier 1
// 01 / Co oblicza

API wykresu geodezyjnego równoważnego

Biorąc pod uwagę szerokość i długość geograficzną, endpoint zwraca geodezyjne Midheaven, Imum Coeli, Ascendant i Descendant w stopniach ekliptycznych, wraz z indeksem znaku i stopniem w znaku dla MC i Ascendantu. Obsługiwane są dwie szkoły. Sepharial, domyślna, mapuje długość geograficzną bezpośrednio na długość zodiakalną, więc 30,52 stopnia na wschód to 0 stopni 31 minut Byka. Johndro stosuje korektę nachylenia, która przesuwa Ascendant względem wartości Sepharial i wymaga albo roku, albo wyraźnego nachylenia w stopniach. Ponieważ w obliczeniach nie pojawia się żadna osoba, te same współrzędne zawsze zwracają te same kąty, co sprawia, że endpoint jest tani w cache i naturalnym kotwicą dla funkcji opartej na miejscu, a nie na osobie.

// 02 / Zapytanie na żywo

POST/v1/geodetic

curl -X POST https://api.astroway.info/v1/geodetic \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "latitude": 50.45,
  "longitude": 30.52,
  "method": "sepharial"
}'
Odpowiedź (fragment)
{
  "ok": true,
  "data": {
    "mc": 30.52,
    "ic": 210.52,
    "asc": 317.7269,
    "dsc": 137.7269,
    "mcSign": 1,
    "mcDegree": 0.52,
    "ascSign": 10,
    "ascDegree": 17.7269,
    "method": "sepharial"
  }
}
// 03 / Parametry

Parametry

nametypeWymagane
latitude number tak Place latitude, decimal degrees (north positive).
longitude number tak Place longitude, decimal degrees (east positive). This is what drives the geodetic MC.
method string nie sepharial (default) maps longitude directly onto the zodiac; johndro applies an obliquity correction.
year number nie Year used for the obliquity value in the johndro method. Ignored by sepharial.
obliquity number nie Explicit obliquity in degrees, overriding the year-derived value.
// 04 / Kiedy używać

Kiedy używać

Sięgnij po wykres geodezyjny w codziennej pracy, gdy przedmiotem jest kraj, miasto lub wydarzenie, a nie osoba. Typowe zastosowania to sprawdzanie, czy zaćmienie lub ingress przypada na geodezyjne kąty stolicy, budowanie strony profilu kraju, która potrzebuje wykresu, ale nie ma wiarygodnego czasu założenia, oraz weryfikacja astrocartografii przy użyciu całkowicie niezależnej metody. Rozwiązuje też praktyczny problem w produktach konsumenckich: gdy użytkownik nie ma czasu urodzenia, większość endpointów wykresów działa słabo, ale geodezyjny wykres dla jego bieżącego miasta jest w pełni określony i mówi coś konkretnego o miejscu. Odpowiedź jest mała i deterministyczna, więc kosztuje jedną tier-one wywołanie i jest bezpieczna do obliczenia dla całej listy miast jednorazowo.

// 05 / Uwagi

Uwagi

Sepharial i Johndro nie zgadzają się celowo, nie przez błąd; oba są zwracane na żądanie, a nie jeden przedstawiany jako kanoniczny. Technika pochodzi od Sephariala z początku XX wieku i została rozszerzona przez L. Edwarda Johndro. Ponieważ ramka geodezyjna jest ustalona względem południka Greenwich, wyniki są stabilne w czasie i nie wymagają wyszukiwania ephemeris, co czyni ten endpoint jedynym w rodzinie astro-geografii, który nie zależy od Swiss Ephemeris.

Wypróbuj API Wykres geodezyjny

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

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