Parans API

このエンドポイントは出生時刻をユリウス日に変換し、完全なアストロカトグラフィーセット（天体ごとに4つのアングラーライン）を計算し、その後、異なる惑星に属するすべてのラインを互いに交差させます。各交差点は、両方の親惑星、両方のラインタイプ、そして交差が発生する緯度と経度と共に返されます。MCとICのラインは子午線であり、ACとDCのラインは緯度依存の曲線であるため、ほとんどの交差点は対称的ではなく幾何学的です：太陽-MCと月-ASCのペアは、半球ごとに正確に1箇所で会合し、共有帯上ではありません。典型的なチャートでは、世界中に400以上の交差点が生成され、それらは重要性の概念による事前フィルタリングではなく、フラットでソート可能なリストとして返される理由です。

curl -X POST https://api.astroway.info/v1/parans \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3
}'

{
  "ok": true,
  "data": {
    "count": 414,
    "parans": [
      {
        "planet1Id": 0,
        "planet1Name": "Sun",
        "line1Type": "MC",
        "planet2Id": 1,
        "planet2Name": "Moon",
        "line2Type": "ASC",
        "location": { "lat": -45.9153, "lng": 6.5735 }
      }
    ]
  }
}

アストロカトグラフィーラインだけでは粗すぎる場合にパランを使用してください。ラインはユーザーに特定の回廊が木星を運んでいることを伝えますが、パランはその回廊上の特定の場所で木星が金星と出会うことを伝えます。その区別こそが、移住コンサルタントが請求するものであり、ほとんどの地図ツールがスキップするレイヤーです。実際の応用では：ラインをポリラインとして描画し、パランをクリック可能なマーカーとして表示するか、リストをフィルタリングして製品が関心を持つ惑星ペアに絞り、近隣都市をそのポイントへの近接度でランク付けします。応答は座標のみなので、文章形式と戦うことなく、独自の都市や地域データセットと結合できます。このエンドポイントは出生地を必要としないことに注意してください。交差点は人がどこにいたかという性質ではなく、空自体の性質だからです。

位置情報は、ナタルエンドポイントと同じエンジンであるWASMにコンパイルされたスイス・エフェメリス（Astrodienst）から取得されるため、パランは派生するラインと同じ惑星の経度に固定されます。交差点は、緯度の近似ではなく、完全なライン幾何学から熱帯黄道で計算されます。Bernadette Bradyによって確立された古典的なパラン教義は、星から惑星へのパランも扱い、それを点ではなく緯度として報告します。そのケースは独自のエンドポイント[星-惑星パラン](/astrology-api/star-parans/)を持っています。このエンドポイントは、アストロカトグラフィーマップ自体が生成する惑星間のケースをカバーしています。