Local Space 占星 API

エンドポイントは出生図を作って、各惑星を黄道座標から出生地の地平フレームに変換し、真北から時計回りの度数で方位角と、地平線上または下の高度を返すんだ。その後、各方位角を出生地から外向きの大円として投影し、結果の経路を座標列として返す。だから世界地図に描く線は平面投影の直線じゃなく、正しい方位を保つよ。13個の天体が対象で、各々安定した色を持つから、描画した地図はスイート全体と同じパレットになる。ここでは高度も方位角と同じくらい重要で、出生時に地平線下にあった惑星は、同じ方向でも空高くにあるものとは違う読み取りになるんだ。

curl -X POST https://api.astroway.info/v1/local-space \
  -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": {
    "birthplace": { "latitude": 50.45, "longitude": 30.52 },
    "count": 13,
    "lines": [
      {
        "planetId": 0,
        "planetName": "Sun",
        "azimuth": 219.8018,
        "altitude": 53.1309,
        "color": "#FFB300",
        "points": [{ "lat": 50.45, "lng": 30.52 }, "…"]
      }
    ]
  }
}

ローカルスペースは、製品が地球上の絶対位置よりも、固定された拠点からの方向と距離に関するもののときに使うんだ。主に2つのケースがある。1つ目は規模を問わずの移転で、好ましい方位にある都市を選んだり、国内でどの方向に移動するか決めたりする時だ。出生地からの大円は、astrocartography の少数の子午線よりはるかに広い領域をカバーするからね。2つ目は室内やサイト作業で、同じ方位角を部屋のスケールで読み取る場合だ。エンドポイントは方位を返し、/local-space/influence-zone がそのうちの一つを描画できる円錐ポリゴンに変えるんだ。すでに astrocartography を描画しているなら、ローカルスペースを追加するのが、同じ出生入力と同じマップ表面を使うだけで、移転機能の深さを倍にする最も安い方法だよ。

位置情報は Swiss Ephemeris (Astrodienst) から取得し、WASM にコンパイルしたものだ。方位角は真北から時計回りに測定し、磁北は使わないから、磁気偏角の補正は不要だ。大円経路は数式ではなくサンプリングされた座標として返すので、クライアントは球面幾何を意識しなくて済むんだ。この手法は Michael Erlewine が開発し、彼のAstrophysical Directionsで文書化されているよ。