Solar Arc Directions API
Solar arc posouvá celý horoskop dopředu o jedno číslo: vzdálenost, kterou Slunce urazilo sekundární progresí. Každá planeta, každý cusp a oba úhly se posunou o stejný oblouk, takže natalní aspekt, který byl dva stupně od přesnosti, se přibližně po dvou letech stane přesným. Tento endpoint vrací nasměrovaný horoskop a oblouk, který ho vytvořil.
Solar Arc Directions API
Z narozeninových dat a cílového data endpoint nejprve progresuje horoskop den za rokem, změří, jak daleko se posunulo progresované Slunce od své natalní pozice, a tu vzdálenost použije jako oblouk. Pak přidá ten oblouk ke všem natalním délkám najednou: všechny planety, všechny house cuspy, ascendent i MC. Odpověď obsahuje nasměrované pozice pod data.planets a data.houses, samotný oblouk ve stupních pod data.arc a klíč, který ho vytvořil, pod data.key. Protože se jeden oblouk použije jednotně, geometrie natalního horoskopu zůstává zachována a mění se jen jeho vztah k natalním stupňům – to dělá techniku tak úspornou na čtení: jedno číslo ti řekne stav celého horoskopu v daném věku. Na stejném endpointu jsou k dispozici ještě dva další klíče. Nastav key na naibod pro průměrnou sluneční rychlost 59'08.3" za rok, nebo ho vynechej pro obyčejný jeden stupeň za rok. Když pošleš converse true, směr se otočí zpět od narození místo dopředu, čímž se znaménko oblouku obrá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
Použij solar arc, když potřebuješ načasování symbolické místo astronomického a chceš ho v podobě, kterou čtenář snadno pochopí. Protože se všechno pohybuje stejnou rychlostí, nasměrovaný kontakt dopadne na konkrétní rok místo časového okna, což se hodí pro funkci životní časová osa, zprávu o věkových milnících nebo AI příběh, který má říct, o čem daný rok je. Přirozeně se kombinuje se sekundární progresí, protože oblouk je odvozen od stejného progresovaného Slunce: progresie ti dávají pohybující se vnitřní horoskop, solar arc ti dává celý horoskop posunutý dopředu. Porovnej tři klíče, když je pro tvé publikum důležitá přesnost. Solar arc sleduje skutečné Slunce, takže se mírně liší podle data narození, Naibod používá průměrnou rychlost a jeden stupeň za rok je konvence zaokrouhleného čísla. Pro narození v polovině května jsou tři hodnoty přibližně 34,5°, 35,5° a 36,0° během 36 let – dostatečně blízko, aby se shodly na desetiletí, a dostatečně daleko, aby označily různé roky.
Notes
Oblouk je vzdálenost, kterou urazil sekundárně progresovaný Slunce, den za rokem, což je standardní definice; klíč Naibod používá průměrný denní pohyb Slunce, 59'08.3" za rok. Pro solar arc se progresovaný horoskop počítá dopředu a směr pohybu se použije jednou, takže converse směry vrátí oblouk opačný, ne dvojnásobný. Pozice pocházejí z enginu Swiss Ephemeris v tropickém zodiaku, na stejných tělesech a house systému jako natalní endpointy.
Try the Solar Arc Directions API
Grab a key and make your first call in under a minute.