アスペクトオーブ

オーブは、2つの天体がアスペクトを形成していると見なされる範囲を決定します。AstroAPIは各チャートタイプに慎重に調整されたデフォルトオーブを使用していますが、必要に応じてオーバーライドできます。

オーブとは？

オーブとは、正確なアスペクト角度からの許容偏差です。例えば、コンジャンクションは2つの惑星が0°離れたときに発生します。8°のオーブでは、0°〜8°離れた惑星はすべてコンジャンクションとみなされます。

チャートタイプ別デフォルトオーブ

AstroAPIは占星術のベストプラクティスを反映し、チャートタイプに応じて異なるデフォルトオーブを使用します：

ネイタルチャート

アスペクト	角度	デフォルトオーブ
コンジャンクション	0°	8°
オポジション	180°	8°
トライン	120°	8°
スクエア	90°	8°
セクスタイル	60°	6°
クインカンクス	150°	4°
セミセクスタイル	30°	3°
クインタイル	72°	2°
バイクインタイル	144°	2°
オクタイル	45°	2°
トライオクタイル	135°	2°

トランジットチャート

トランジットアスペクトはタイミングを示すため、より狭いオーブを使用します：

アスペクト	角度	デフォルトオーブ
コンジャンクション	0°	2.6°
オポジション	180°	2.5°
トライン	120°	2.3°
スクエア	90°	2.3°
セクスタイル	60°	2.3°
クインカンクス	150°	2°

シナストリーチャート

シナストリーは関係する惑星に基づいて可変オーブを使用します：

• 太陽・月のコンジャンクションとオポジション：最大5°
• その他の太陽・月のアスペクト（トライン、スクエア、セクスタイル）：最大3°
• その他すべての惑星の組み合わせ：最大3°

コンポジットチャート

コンポジットチャートは、すべての主要アスペクトに一貫した2.5°のオーブを使用します。

ソーラーリターンとルナーリターンチャート

リターンチャートはすべての主要アスペクトに6°のオーブを使用します。

セカンダリプログレッション

プログレッション惑星の動きが遅いため、プログレッションはすべてのアスペクトに非常に狭い1°のオーブを使用します。

カスタムオーブ

リクエストに orbs オブジェクトを含めることで、デフォルトオーブをオーバーライドできます。カスタマイズしたいアスペクトのみを指定してください。指定されていないアスペクトはデフォルト値を使用します。

例：ネイタルチャートのカスタムオーブ

{
  "dateTime": "1990-06-15T14:30",
  "location": {
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  },
  "orbs": {
    "conjunction": 10,
    "opposition": 10,
    "trine": 6,
    "square": 6
  }
}

例：精度のための狭いオーブ

{
  "dateTime": "1990-06-15T14:30",
  "location": {
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  },
  "orbs": {
    "conjunction": 3,
    "opposition": 3,
    "trine": 2,
    "square": 2,
    "sextile": 2
  }
}

利用可能なアスペクトタイプ

アスペクトID	名前	角度
conjunction	コンジャンクション	0°
opposition	オポジション	180°
trine	トライン	120°
square	スクエア	90°
sextile	セクスタイル	60°
quincunx	クインカンクス・インコンジャンクト	150°
semisextile	セミセクスタイル	30°
quintile	クインタイル	72°
biquintile	バイクインタイル	144°
octile	オクタイル・セミスクエア	45°
trioctile	トライオクタイル・セスキクアドレート	135°
decile	デシル	36°
tridecile	トライデシル	108°

ベストプラクティス

1. ほとんどのケースではデフォルトを使用する — デフォルトオーブは占星術の伝統に基づいて慎重に選択されており、ほとんどのアプリケーションに適しています。

2. 予測には狭いオーブを使用する — 正確なタイミング（トランジット、プログレッション）を求める場合は、狭いオーブを使用してください。

3. 関係分析には広いオーブを使用する — シナストリーとネイタルチャートは、すべての重要な繋がりを捉えるために若干広いオーブが有利なことがあります。

4. 光体にはより広いオーブを — 太陽と月は占星術的重要性から、伝統的に他の惑星よりも広いオーブが与えられます。

5. マイナーアスペクトには狭いオーブが必要 — クインタイル、セミセクスタイル、オクタイルなどのアスペクトは、有意性を確保するために2°以下のオーブを使用してください。

対応エンドポイント

カスタムオーブは以下のエンドポイントでサポートされています：

• /calc/natal - ネイタルチャート計算
• /calc/synastry - シナストリーチャート計算
• /calc/composite - コンポジットチャート計算
• /calc/solar-return - ソーラーリターン計算
• /calc/lunar-return - ルナーリターン計算