ソーラーリターン・アストロカートグラフィーAPI

エンドポイントはまず出生図を構築し、次に要求された年に通過する太陽が出生時の太陽経度に到達する瞬間を1秒未満の精度で検索します。その瞬間の惑星の位置を計算し、出生図アストロカートグラフィーエンドポイントと全く同じように、世界に4つの角度線の家族を描き、63本の線を返します。すべての惑星名にはSR接尾辞が付いているため、両方の地図を一度にレンダリングするクライアントは、出生木星線とソーラーリターン線を混同することはできません。線は/acgと同じ形状の座標ペアとして返されるため、既存のレンダラーは第2レイヤーのスタイル以外に変更を必要としません。

curl -X POST https://api.astroway.info/v1/solar-acg \
  -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,
  "year": 2026
}'

{
  "ok": true,
  "data": {
    "year": 2026,
    "lines": [
      {
        "planet": "Sun (SR)",
        "planetId": 0,
        "type": "MC",
        "coordinates": [[-85, 110.4845], [-84.5, 110.4845], "…"]
      }
    ]
  }
}

これは移住占星術における最も商業的な質問の背後にあるエンドポイントです：私の誕生日をどこで過ごし、今年どこに基盤を置くべきかです。ソーラーリターン図は伝統的に、人がリターン時に物理的にいる場所のために作成されるため、場所は与えられたものではなく決定事項となり、この地図はその決定をユーザーが見ることができる何かに変えます。年次移住レポート、誕生日旅行推薦システム、または既存のアストロカートグラフィー地図上の年次オーバーレイを構築してください。基礎となるリターン時刻は毎年変化するため、結果は一度きりの計算ではなく自然と再購入可能なコンテンツとなり、ユーザーが地図だけでなくチャートも望む場合は/solar-returnと直接組み合わせることができます。

位置情報はWASMにコンパイルされたスイス・エフェメリス（Astrodienst）から取得されます。リターン時刻は熱帯黄道における出生時の太陽経度に対して解決されます；恒星太陽リターンは異なる技術であり、このエンドポイントが計算するものではありません。地図はリターン図のみから描かれるため、それはその年の出生線の完全な代替品であり、それらの修正ではありません。一部の学派は現在の場所ではなく出生地のためにリターンを作成します；線の幾何学自体はどちらの場合も同一であるため、その選択はあなたの解釈層に属します。