ネイタルチャート

惑星位置、ハウスカスプ、アスペクトを含む完全なネイタルチャートを計算します。

基本的な計算

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  }'

パラメータ

パラメータ	型	必須	説明
datetime	string	はい	ISO 8601形式の日時
latitude	number	はい	緯度（-90〜90）
longitude	number	はい	経度（-180〜180）
timezone	string	はい	IANAタイムゾーン識別子
houseSystem	string	いいえ	ハウスシステム（デフォルト："placidus"）

ハウスシステム

• placidus - プラシダス（デフォルト）
• koch - コッホ
• equal - イコールハウス
• whole - ホールサイン
• campanus - カンパナス
• regiomontanus - レジオモンタヌス
• porphyry - ポルフィリー

レスポンス

{
  "data": {
    "type": "natal-chart",
    "attributes": {
      "planets": {
        "sun": { "longitude": 84.5, "latitude": 0, "sign": "gemini", "house": 10 },
        "moon": { "longitude": 245.2, "latitude": -3.1, "sign": "sagittarius", "house": 4 }
      },
      "houses": {
        "1": { "cusp": 180.5, "sign": "libra" },
        "2": { "cusp": 210.3, "sign": "scorpio" }
      },
      "aspects": [
        { "planet1": "sun", "planet2": "moon", "aspect": "opposition", "orb": 0.7 }
      ]
    }
  }
}

含まれる天体

デフォルトでは、以下の天体が含まれます：

• 太陽、月
• 水星、金星、火星、木星、土星、天王星、海王星、冥王星
• ノースノード、サウスノード
• カイロン、リリス（ブラックムーン）
• フォーチュンのパート

月と太陽

月の満ち欠け、照度、出没時刻、太陽位置データを計算します。

POST /api/calc/moon-sun

curl -X POST "https://api.astroapi.cloud/api/calc/moon-sun" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "2024-06-15T12:00",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    }
  }'

パラメータ

パラメータ	型	必須	説明
dateTime	string	はい	YYYY-MM-DDTHH:mm形式の日時
location.latitude	number	はい	緯度（-90〜90）
location.longitude	number	はい	経度（-180〜180）
location.timezone	string	はい	IANAタイムゾーン識別子

必要なモジュール

このエンドポイントには module:moon モジュールが必要です。

レスポンス

{
  "data": {
    "moon": {
      "phaseName": "Waxing Gibbous",
      "phase": 0.62,
      "illumination": 0.78,
      "age": 9.2,
      "distance": 384400,
      "diameterDegrees": 0.52,
      "rise": "2024-06-15T14:23:00Z",
      "set": "2024-06-16T02:15:00Z"
    },
    "sun": {
      "rise": "2024-06-15T05:18:00Z",
      "set": "2024-06-15T22:03:00Z",
      "transit": "2024-06-15T13:40:00Z",
      "distance": 151820000,
      "diameterDegrees": 0.524,
      "twilight": {
        "civil": {
          "begin": "2024-06-15T04:38:00Z",
          "end": "2024-06-15T22:43:00Z"
        },
        "nautical": {
          "begin": "2024-06-15T03:32:00Z",
          "end": "2024-06-15T23:49:00Z"
        },
        "astronomical": {
          "begin": null,
          "end": null
        }
      }
    }
  }
}

計算精度

AstroAPIは高精度計算にスイスエフェメリスを使用しています。すべての位置は秒角精度で計算されます。

ベータ版：代替計算エンジン

実験的な機能

この機能はベータ版であり、精度の問題が発生する可能性があります。本番環境では注意して使用してください。

AstroAPIは、公式のスイスエフェメリスライブラリを使用する代わりに、スイスエフェメリスのSE1データファイルを直接読み取り評価するカスタム実装を使用する代替計算エンジン（calc2）を提供しています。このエンジンは速度のために最適化されており、より高速なレスポンス時間を提供する場合があります。

代替エンジンを使用するには、リクエストに X-Use-Calc2 ヘッダーを含めてください：

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "X-Use-Calc2: true" \
  -H "Content-Type: application/json" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  }'

主な違い

比較項目	標準エンジン	Calc2エンジン（ベータ）
実装	スイスエフェメリス	カスタム実装
データソース	SE1エフェメリスファイル	SE1エフェメリスファイル（同じデータ）
速度	標準	潜在的に高速
精度	秒角精度（基準）	若干の偏差が生じる可能性あり
ステータス	本番対応	ベータ版

Calc2の使用が推奨される場面

• 推奨： 絶対的な精度よりも速度が優先される大量アプリケーション
• 非推奨： 最大限の天文精度が必要なアプリケーション

既知の制限事項

• カスタム実装は公式スイスエフェメリスライブラリと比較してわずかに異なる結果を生成する場合があります
• 現在も活発に開発・テスト中です
• 重要なアプリケーションでは、標準エンジンに対して結果を検証してください