API aspektów deklinacyjnych
Większość pracy z aspektami odbywa się wzdłuż ekliptyki w długości, ale dwa ciała mogą też wiązać się przez deklinację — ich odległość na północ lub południe od równika niebieskiego. Ten endpoint pracuje w tym drugim wymiarze, znajdując paralele i kontraparalele, deklinacyjne odpowiedniki koniunkcji i opozycji, i odnotowując, kiedy ciało wybiega poza granice (out of bounds).
API aspektów deklinacyjnych
Na podstawie daty urodzenia, godziny, przesunięcia UTC i współrzędnych endpoint oblicza deklinację każdego ciała — jak daleko na północ lub południe od równika niebieskiego się znajduje, poza płaszczyzną ekliptyki, na której mierzona jest długość — a następnie porównuje te deklinacje między ciałami. Tam gdzie dwa ciała dzielą tę samą deklinację po tej samej stronie równika, zapisuje paralelę, deklinacyjny odpowiednik koniunkcji; tam gdzie dzielą tę samą deklinację po przeciwnych stronach, zapisuje kontraparalelę, odpowiednik opozycji. Każdy kontakt zwracany jest pod data.parallels wraz z zaangażowanymi ciałami. Endpoint wydobywa także kontekst out of bounds — gdy deklinacja ciała przekracza maksimum Słońca, wynosząc je poza pas, który Słońce kiedykolwiek osiąga, stan tradycyjnie odczytywany jako planeta działająca bez swojego zwykłego hamulca. Daje to warstwę kontaktu, którą czysta długość całkowicie pomija: dwie planety bez żadnego aspektu długościowego mogą być wciąż zwarte w ścisłej paraleli.
POST/v1/parallel-aspects
curl -X POST https://api.astroway.info/v1/parallel-aspects \
-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": {
"parallels": [
{
"planet1": "Sun",
"planet2": "Moon",
"type": "contra-parallel",
"orb": 0.49
}
]
}
}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 silnik aspektów nie powinien zatrzymywać się na ekliptyce — poważnego analizatora horoskopu, narzędzia synastrii lub tranzytów, które chce warstwy deklinacyjnej, lub raportu wyjaśniającego, dlaczego dwie planety wydają się połączone mimo braku aspektu długościowego. Paralele i kontraparalele to dokładnie te kontakty, które siatka wyłącznie długościowa pomija, więc ich dodanie wypełnia rzeczywistą lukę, a nie powiela wynik aspektów z natal-chart. Flaga out of bounds jest niezależnie użyteczna: oznacza planety, które tradycja traktuje jako działające bez ograniczeń, co tworzy czytelne wyróżnienie w raporcie horoskopu. Wyślij te same dane urodzeniowe, których użyłeś gdzie indziej, a kontakty deklinacyjne będą odnosić się do tych samych ciał co twoje aspekty długościowe, pozwalając ci zaprezentować obie siatki jako dwa odczyty jednego horoskopu.
Uwagi
Paralele i kontraparalele podążają za tradycyjną doktryną deklinacji, traktując kontakty równej deklinacji jako odpowiedniki koniunkcji i opozycji; odczyt out of bounds czerpie z pracy Kt Boehrer. Deklinacje obliczane są przez silnik WASM Swiss Ephemeris (Astrodienst) w układzie tropikalnym, na tych samych ciałach co endpointy natalne oparte na długości.
Wypróbuj API Aspekty deklinacyjne
Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.