ネイタルチャート

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

基本的な計算

bash

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",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

パラメータ

パラメータ	型	必須	説明
`dateTime`	string	はい	YYYY-MM-DDTHH:mm形式の日時
`location.latitude`	number	はい	緯度（-90〜90）
`location.longitude`	number	はい	経度（-180〜180）
`location.timezone`	string	はい	IANAタイムゾーン識別子
`houseSystem`	string	いいえ	ハウスシステム（デフォルト："placidus"）
`points`	array	いいえ	計算する天体ポイント（下記の利用可能なポイントを参照）
`orbs`	object	いいえ	アスペクトタイプごとのカスタムオーブ値（例：`{ "conjunction": 8, "opposition": 6 }`）
`language`	string	いいえ	テキストコンテンツの言語コード（デフォルト：`"en"`）
`includeText`	boolean	いいえ	解釈テキストを含める（デフォルト：`false`）
`includeReadableEntities`	boolean	いいえ	人間が読めるエンティティタイトルを含める（デフォルト：`false`）

ハウスシステム

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

レスポンス

json

{
  "data": {
    "dateTime": "1990-06-15T12:30:00.000Z",
    "points": {
      "sun": {
        "pointId": "sun",
        "longitude": 84.5,
        "sign": "gemini",
        "signTitle": "Gemini",
        "degreesInSign": 24.5,
        "degreesInSignDms": [24, 30, 0],
        "houseNumber": 10,
        "houseId": "house-10",
        "retrograde": false,
        "pointTitle": "Sun",
        "houseTitle": "10th House"
      },
      "moon": {
        "pointId": "moon",
        "longitude": 245.2,
        "sign": "sagittarius",
        "signTitle": "Sagittarius",
        "degreesInSign": 5.2,
        "degreesInSignDms": [5, 12, 0],
        "houseNumber": 4,
        "houseId": "house-4",
        "retrograde": false,
        "pointTitle": "Moon",
        "houseTitle": "4th House"
      }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": {
        "pointId": "descendant",
        "longitude": 0.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "aries"
      },
      "midheaven": {
        "pointId": "midheaven",
        "longitude": 270.2,
        "degreesInSign": 0.2,
        "degreesInSignDms": [0, 12, 0],
        "sign": "capricorn"
      },
      "imumCoeli": {
        "pointId": "imumCoeli",
        "longitude": 90.2,
        "degreesInSign": 0.2,
        "degreesInSignDms": [0, 12, 0],
        "sign": "cancer"
      }
    },
    "houses": {
      "cusps": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 210.3, "longitudeDms": { "degrees": 210, "minutes": 18, "seconds": 0 }, "sign": "scorpio" }
      ],
      "ascmc": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 270.2, "longitudeDms": { "degrees": 270, "minutes": 12, "seconds": 0 }, "sign": "capricorn" }
      ]
    },
    "aspects": [
      {
        "pointA": "sun",
        "pointB": "moon",
        "aspect": "opposition",
        "angle": 160.7,
        "orb": 0.7,
        "applying": false,
        "pointATitle": "Sun",
        "pointBTitle": "Moon",
        "aspectTitle": "Opposition"
      }
    ],
    "chart": {
      "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..."
    }
  }
}

ハウスカスプ

各カスプオブジェクトには longitude（黄経度数）、longitudeDms（度/分/秒）、sign（黄道十二宮のサインID）が含まれます。最初のカスプ（cusps[0]）はアセンダントです。ascmc 配列にはアセンダント、MC、ARMC、バーテックスが含まれます。

利用可能なポイント

points パラメータを使用して、計算する天体ポイントを選択します。省略した場合、デフォルトセットが使用されます。

デフォルトポイント

sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, meanNode, trueNode, meanApogee, osculatingApog

すべての利用可能なポイント

ポイントID	説明
`sun`	太陽
`moon`	月
`mercury`	水星
`venus`	金星
`mars`	火星
`jupiter`	木星
`saturn`	土星
`uranus`	天王星
`neptune`	海王星
`pluto`	冥王星
`meanNode`	平均ノースノード
`trueNode`	真のノースノード
`meanApogee`	平均ブラックムーンリリス
`osculatingApog`	真のブラックムーンリリス
`chiron`	カイロン
`pholus`	フォルス
`ceres`	セレス
`pallas`	パラス
`juno`	ジュノー
`vesta`	ベスタ
`interpolatedLunarApogee`	補間月遠地点（ナチュラルアポジー）
`interpolatedLunarPerigee`	補間月近地点（プリアポス）
`earth`	地球

例：太陽と火星のみを計算

bash

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",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "points": ["sun", "mars"]
  }'

レスポンスの points オブジェクトには sun と mars が含まれ、angles オブジェクトには4つのアングルすべてが含まれます：

json

{
  "data": {
    "points": {
      "sun": { "pointId": "sun", "longitude": 84.5, "sign": "gemini", ... },
      "mars": { "pointId": "mars", "longitude": 12.3, "sign": "aries", ... }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": { "pointId": "descendant", "longitude": 0.5, "sign": "aries", ... },
      "midheaven": { "pointId": "midheaven", "longitude": 270.2, "sign": "capricorn", ... },
      "imumCoeli": { "pointId": "imumCoeli", "longitude": 90.2, "sign": "cancer", ... }
    },
    "houses": { ... },
    "aspects": [ ... ]
  }
}

アングル

4つのアングル（ascendant、descendant、midheaven、imumCoeli）は、points パラメータに関係なく、常に angles オブジェクトに含まれます。アングルはエフェメリスではなくハウス計算から導出されるため、よりシンプルな構造です（速度やレトログレードデータなし）。houses レスポンスの ascmc 配列にも常に生のアングル経度が含まれています。

月と太陽

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

POST `/api/calc/moon-sun`

bash

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 モジュールが必要です。

レスポンス

json

{
  "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はNASAのJPL DE442エフェメリスを直接読み取り、サブミリ秒角精度の惑星位置を提供します。データソースと補正の詳細については計算精度ページをご覧ください。

ネイタルチャート ​

基本的な計算 ​

パラメータ ​

ハウスシステム ​

レスポンス ​

利用可能なポイント ​

デフォルトポイント ​

すべての利用可能なポイント ​

例：太陽と火星のみを計算 ​

月と太陽 ​

POST /api/calc/moon-sun ​

パラメータ ​

レスポンス ​

計算精度 ​

ネイタルチャート

基本的な計算

パラメータ

ハウスシステム

レスポンス

利用可能なポイント

デフォルトポイント

すべての利用可能なポイント

例：太陽と火星のみを計算

月と太陽

POST `/api/calc/moon-sun`

パラメータ

レスポンス

計算精度