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.
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.
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"
}' {
"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"
}
} Parametry
| name | type | Wymagane | |
|---|---|---|---|
| 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. |
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.
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ę.