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ą.
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.
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
}' {
"ok": true,
"data": {
"lines": [
{
"planet": "Venus",
"type": "MC",
"longitude": 14.2
},
{
"planet": "Jupiter",
"type": "AC",
"points": [
"…"
]
}
]
}
} Parametry
| name | type | Wymagane | |
|---|---|---|---|
| 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). |
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.
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ę.