AstroWay/api v2.201.6 · cs
všechny systémy jsou v pořádku
// astrology api · POST /v1/symbolic-directions

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.

Endpoint
POST /v1/symbolic-directions
Cost
50 credits
Latency
~50 ms
Tier
Tier 3
// 01 / What it computes

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í.

// 02 / Live request

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"
}'
Response (excerpt)
{
  "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
    }
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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.
// 04 / When to use it

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.

// 05 / Notes

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.

99,9% SLA · placené plány · 30 dní status →