Napív irányok API
A napív egy számot előre viszi az egész diagramot: a Nap másodlagos progresszióval megtett távolságát. Minden bolygó, minden házcsúcs és mindkét szög ugyanazzal az ívával eltolódik, így egy születési aspektus, ami két fokra volt pontos, körülbelül két év múlva pontos lesz. Ez az endpoint visszaadja a módosított diagramot és az ívet, ami ezt létrehozta.
Napív irányok API
A születési adatok és egy céldátum alapján az endpoint először egy nap-az-évnek megfelelően progresszálja a chart-ot, megméri, milyen messze mozdult el a progresszált Nap a natal pozíciójától, és ezt a távolságot veszi ívnek. Ezután egyszerre hozzáadja az ívet minden natal hosszúsághoz: minden bolygóhoz, minden házcsúcshoz, az aszcendenchez és az MC-hez. A válasz a módosított pozíciókat a data.planets és data.houses alatt, az ívet fokban a data.arc alatt, és a kulcsot a data.key alatt tartalmazza. Mivel egyetlen ívet egyenletesen alkalmazzák, a natal chart geometriai felépítése megmarad, csak a natal fokokhoz viszonyított helyzete változik, ami miatt a technika olvasása annyira gazdaságos: egy szám elmondja az egész chart állapotát egy adott életkorban. Két további kulcs érhető el ugyanazon az endpoint-on. Állítsd a key-t naibod-ra a 59'08.3" per year átlagos napmozgásért, vagy hagyd ki az egyszerű egy fok per évért. Ha a converse true-t küldöd, visszafelé irányít a születés pillanatától, megfordítva az ív előjelét.
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
}
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment. Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
| targetDate | string (YYYY-MM-DD) | yes | The date the chart is directed to. |
| key | string | no | 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 | no | Direct backwards from the birth moment instead of forwards. Reverses the sign of the arc. |
When to use it
Használd a napívet, ha szimbolikus időzítésre van szükséged a csillagászati helyett, és ha olyan formában akarod, amit az olvasó könnyen követ. Mivel minden egy sebességgel mozog, egy irányított esemény egy konkrét évre esik, nem egy időablakra, ami jól illik egy élet-idővonal funkcióhoz, egy életkor-mérföldkő jelentéshez vagy egy AI narratívához, ami el kell mondja, miről szól egy adott év. Természetesen párosítható a másodlagos progressziókkal, mivel az ív ugyanabból a progresszált Napból származik: a progressziók a mozgó belső chart-ot adják, a napív a teljes chart-ot tolja előre. Hasonlítsd össze a három kulcsot, ha a pontosság fontos a közönségednek. A napív a valódi Napot követi, így születési dátumtól kissé változik, a Naibod a középértéket használja, az egy fok per év a kerek szám konvenció. Egy május közepi születésnél a három körülbelül 34,5, 35,5 és 36,0 fokot ad 36 év alatt, elég közel ahhoz, hogy egy évtizedet egyeztesünk, és elég távol, hogy különböző éveket nevezhessünk.
Notes
Az ív a másodlagos progresszióval mozgott Nap által megtett távolság, nap egy évért, ez a szabványos definíció; a Naibod kulcs a Nap átlagos napi mozgását használja, 59'08.3" per year. A napív esetén a progresszált chart előre számítódik, és az irány egyszer kerül alkalmazásra, így a converse irányok az ívet negatívként adják vissza, nem duplázzák. A pozíciók a Swiss Ephemeris motorból származnak a trópusi zodiákusban, ugyanazokon a testeken és házrendszeren, mint a natal endpointok.
Try the Napív irányok API
Grab a key and make your first call in under a minute.