ソーラーアーク・ディレクション API
Solar arc はチャート全体を 1 つの数だけ前に進めるんだ。これは二次進行で Sun が移動した距離だよ。すべての惑星、ハウスカスプ、そしてアセンダントと MC も同じアークだけシフトするから、出生時のアスペクトが 2 度ずれていたのが約 2 年後に正確になるんだ。この endpoint は方向付けされたチャートとそれを作ったアークを返すよ。
ソーラーアーク・ディレクション API
出生データと対象日付を受け取って、endpoint はまずチャートを 1 年につき 1 日進めて、進行した Sun が出生時の位置からどれだけ動いたか測定し、その距離をアークとして取るんだ。その後、そのアークをすべての出生経度に一括で加える。すべての惑星、すべてのハウスカスプ、アセンダントと MC も同様だよ。レスポンスは data.planets と data.houses に方向付けされた位置を、data.arc に度数でアークを、data.key にそれを生成したキーを入れて返す。単一のアークを均一に適用するので、出生チャートの幾何は保たれ、出生度数との関係だけが変わるんだ。これがこの手法がとても読みやすい理由で、1 つの数で特定の年齢のチャート全体の状態が分かるんだ。同じ endpoint で他に 2 つのキーが使える。key を naibod に設定すると年率 59'08.3" の平均太陽速度になるし、省略すると年 1 度のシンプルなものになる。converse を true にすると出生瞬間から逆方向に進めて、アークの符号が反転するんだ。
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
シンボリックなタイミングが欲しいとき、天文学的なものよりも、読者が追いやすい形が欲しいときに solar arc を使うんだ。すべてが同じ速度で動くから、方向付けされた接点はウィンドウではなく特定の年に着地する。だからライフタイムライン機能や年齢マイルストーンレポート、あるいは AI のナラティブで「この年は何か」を語るのにぴったりだ。secondary progressions と自然に組み合わせられるのは、アークが同じ進行した Sun から導かれるから。progressions は内部チャートを動かし、solar arc は全体チャートを前へずらすんだ。精度が重要なら 3 つのキーを比較しよう。solar arc は実際の Sun に従うので出生日で少し変わるし、Naibod は平均速度、年 1 度は丸めた慣例だ。5 月中旬生まれの場合、36 年でおおよそ 34.5°, 35.5°, 36.0° になるから、十年単位での合意は得やすく、年ごとの違いもはっきり出せるよ。
Notes
アークは二次進行した Sun が 1 年につき 1 日進んだ距離で、標準的な定義だよ。Naibod キーは Sun の平均日運動、59'08.3"/年 を使う。solar arc では進行したチャートを前方に計算し、移動方向は一度だけ適用するから、converse を指定するとアークが符号反転して返るんだ。位置情報は Swiss Ephemeris エンジンから取得していて、熱帯黄道帯で、出生 endpoint と同じ天体とハウスシステムを使用しているよ。
Try the ソーラーアーク・ディレクション API
Grab a key and make your first call in under a minute.