Solar Arc Directions API
Solar arc przesuwa cały wykres do przodu o jedną liczbę: odległość, jaką Słońce przebyło w progresji wtórnej. Każda planeta, każdy cusp i oba kąty przesuwają się o ten sam łuk, więc natalny aspekt, który był dwa stopnie od dokładności, staje się dokładny po około dwóch latach. Ten endpoint zwraca skierowany wykres i łuk, który go wyprodukował.
Solar Arc Directions API
Z danych urodzenia i docelowej daty endpoint najpierw progresuje wykres dzień-za-rok, mierzy jak daleko przesunęło się progresujące Słońce od swojej pozycji natalnej i przyjmuje tę odległość jako łuk. Następnie dodaje łuk do każdej długości natalnej jednocześnie: wszystkie planety, wszystkie cuspy domów, ascendent i MC. Odpowiedź zawiera skierowane pozycje w data.planets i data.houses, sam łuk w stopniach w data.arc oraz klucz, który go wygenerował w data.key. Ponieważ jeden łuk jest stosowany jednolicie, geometria wykresu natalnego pozostaje zachowana, a zmienia się tylko jego relacja do stopni natalnych, co czyni tę technikę tak oszczędną w odczycie: jedna liczba mówi ci stan całego wykresu w danym wieku. Dwa inne klucze są dostępne w tym samym endpoint. Ustaw key na naibod dla średniej szybkości słonecznej 59'08.3" na rok, albo pomiń go dla prostego jednego stopnia na rok. Wysłanie converse true kieruje wstecz od momentu urodzenia zamiast do przodu, odwracając znak łuku.
POST/v1/symbolic-directions
curl -X POST https://api.astroway.info/v1/symbolic-directions \
-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,
"targetDate": "2026-05-15",
"key": "solar_arc"
}' {
"ok": true,
"data": {
"arc": 34.5083,
"key": "solar_arc",
"planets": [
{
"id": 0,
"name": "Sun",
"longitude": 88.8843,
"isRetrograde": false
}
],
"houses": {
"system": "P",
"ascendant": 204.4763,
"mc": 111.5826
}
}
} 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. 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). |
| targetDate | string (YYYY-MM-DD) | tak | The date the chart is directed to. |
| key | string | nie | Directional key: solar_arc (the arc of the progressed Sun), naibod (59'08.3" per year), or one_degree (the default, 1° per year). |
| converse | boolean | nie | Direct backwards from the birth moment instead of forwards. Reverses the sign of the arc. |
Kiedy używać
Użyj solar arc, gdy potrzebujesz timingu symbolicznego, a nie astronomicznego, i gdy chcesz go w formie, którą czytelnik może śledzić. Ponieważ wszystko porusza się jednym tempem, skierowany kontakt przypada na konkretny rok, a nie okno czasowe, co pasuje do funkcji osi życia, raportu kamieni milowych wieku lub narracji AI, która musi powiedzieć, o czym jest dany rok. Naturalnie łączy się z progresjami wtórnymi, bo łuk pochodzi z tego samego progresującego Słońca: progresje dają ruchomy wewnętrzny wykres, solar arc daje cały wykres przesunięty do przodu. Porównaj trzy klucze, gdy precyzja ma znaczenie dla twojej publiczności. Solar arc podąża za rzeczywistym Słońcem i więc nieco zmienia się w zależności od daty urodzenia, Naibod używa średniej szybkości, a jeden stopień na rok to konwencja zaokrąglona. Dla urodzenia w połowie maja trzy wyniki to około 34,5, 35,5 i 36,0 stopni w ciągu 36 lat, wystarczająco blisko, by zgodzić się co do dekady, i wystarczająco odległe, by nazwać różne lata.
Uwagi
Łuk to odległość przebyta przez Słońce progresowane wtórnie, dzień za rok, co jest standardową definicją; klucz Naibod używa średniego dziennego ruchu Słońca, 59'08.3" na rok. Dla solar arc wykres progresowany jest obliczany do przodu i kierunek podróży stosowany jednorazowo, więc converse directions zwracają łuk z odwróconym znakiem, a nie podwojony. Pozycje pochodzą z silnika Swiss Ephemeris w zodiaku troposferycznym, na tych samych ciałach i systemie domów co natal endpoints.
Wypróbuj API Solar Arc Directions
Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.