赤緯アスペクト API

出生日時、UTC オフセット、座標を渡すと、endpoint は各天体の declination（天の赤道からどれだけ北か南か）を計算し、天体同士の declination を比較するんだ。同じ側で同じ declination なら parallel（結合の赤緯版）として、反対側で同じ declination なら contraparallel（対立の赤緯版）として記録する。結果は data.parallels に関わった天体と共に返すよ。さらに、天体の declination が Sun の最大値を超えてバンドを超えると out-of-bounds としてフラグを立てる。これで経度だけでは見逃す、2つの惑星が経度アスペクトなしで緊密な parallel に入るケースを捕まえられる。

curl -X POST https://api.astroway.info/v1/parallel-aspects \
  -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
}'

{
  "ok": true,
  "data": {
    "parallels": [
      {
        "planet1": "Sun",
        "planet2": "Moon",
        "type": "contra-parallel",
        "orb": 0.49
      }
    ]
  }
}

endpoint はアスペクトエンジンが黄道だけで止まっちゃいけないときに使うんだ。例えば本格的なチャート分析ツールや、シナストリー・トランジットで赤緯層が欲しいとき、あるいは2つの惑星が経度アスペクトなしで結びついている理由を説明したいレポートに最適だよ。parallel と contraparallel は経度だけのグリッドが落とす接点だから、追加すれば実際のギャップを埋められる。out-of-bounds フラグも便利で、伝統的に制限なしに動く惑星をハイライトできる。既に使っている出生データをそのまま送れば、declination の接点は経度アスペクトと同じ天体を指すから、2つのグリッドを同じチャートの別の読み取りとして提示できる。

parallel と contraparallel は伝統的な赤緯理論に従い、等しい declination の接点を conjunction と opposition のアナログとして扱うんだ。out-of-bounds の読み取りは Kt Boehrer の研究に基づく。declination は Swiss Ephemeris (Astrodienst) の エンジンで tropical フレームで計算され、経度ベースの natal endpoint と同じ天体に対して行われる。