Astrocartography API

出生年月日、時刻、UTC オフセット、出生座標から、エンドポイントはその瞬間の正確な空を決めて、地球を走査し、4つの角度のうちどれかに惑星が位置したすべての子午線と曲線を探すんだ。10 個の惑星とノードそれぞれについて、上昇線（アセンダント上）、下降線（ディセンダント上）、天頂線（ミッドヘブン上）、底部線（イム・コエリ上）の4 系列の線を描く。MC と IC の線はまっすぐな子午線として、AC と DC の線は緯度依存の曲線として曲がる。ある緯度で東に昇る天体は、別の緯度では北や南に大きくずれるからだ。すべては data.lines 以下のシリアライズ可能な線ジオメトリとして返され、マッピングライブラリにそのまま渡せる。これは Jim Lewis が Astro*Carto*Graphy として広めた再配置テクニックだ。

curl -X POST https://api.astroway.info/v1/astrocartography \
  -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": {
    "lines": [
      {
        "planet": "Venus",
        "type": "MC",
        "longitude": 14.2
      },
      {
        "planet": "Jupiter",
        "type": "AC",
        "points": [
          "…"
        ]
      }
    ]
  }
}

場所が変数で、チャートが地図上でどう変わるか知りたいときにこのエンドポイントを使うんだ - 移住アドバイス、旅行や住む場所のツール、あるいは人のチャートを地球に重ねる機能に最適だよ。インタラクティブマップの自然なバックエンドで、出生時刻に対して一度だけ線をリクエストし、ポリラインとして描画して、ユーザーが大陸をパンしながらどの惑星がどの回廊を支配しているか読める。出力がテキストじゃなくジオメトリだけだから、フロントエンドのスタイリングやクラスタリング、クリックで解釈レイヤーときれいに組み合わせられる。出生チャートの呼び出しと組み合わせれば、ホームチャートの構造と再配置された線を並べて表示できる。二つは同じ出生解像度を共有しているから、マップ上の惑星位置が正確に一致するんだ。

位置情報は Swiss Ephemeris (Astrodienst) から取得していて、出生エンドポイントと同じエンジンを使っているから、線は同一の惑星経度に固定されるんだ。角度はトロピカル黄道帯で計算される。レスポンスはジオメトリだけを返すので、世界地図の描画、投影、スタイリングはクライアント側でやってね。