トランジット

指定した期間にわたって、ネイタルチャートに対する惑星のトランジットとそのアスペクトを計算します。

トランジットの計算

日付範囲のトランジットを計算する：

bash

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-01-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

パラメータ

パラメータ	型	必須	説明
`birthDate`	string	はい	YYYY-MM-DDTHH:mm形式の出生日時
`birthLocation`	object	はい	緯度、経度、タイムゾーンを含む出生地
`transitDateStart`	string	はい	YYYY-MM-DDTHH:mm形式のトランジット期間開始
`transitDateEnd`	string	はい	YYYY-MM-DDTHH:mm形式のトランジット期間終了
`transitLocation`	object	はい	緯度、経度、タイムゾーンを含むトランジット地
`houseSystem`	string	いいえ	ハウスシステム（デフォルト："placidus"）
`points`	array	いいえ	計算する天体ポイント
`orbs`	object	いいえ	アスペクトタイプ別のカスタムオーブ値
`language`	string	いいえ	テキストコンテンツの言語コード（デフォルト："en"）
`includeText`	boolean	いいえ	解釈テキストを含める（デフォルト：false）
`includeReadableEntities`	boolean	いいえ	人間が読めるエンティティタイトルを含める（デフォルト：false）

位置オブジェクト

json

{
  "latitude": 51.5074,
  "longitude": -0.1278,
  "timezone": "Europe/London"
}

レスポンス

レスポンスには、トランジットクロッシング（惑星がサインやハウスに入退場する時）、トランジットハウス位置、トランジット惑星とネイタル惑星のアスペクト、チャートURLが含まれます。

json

{
  "data": {
    "crossings": [...],
    "transitHouses": [...],
    "aspects": [
      {
        "point1": "saturn",
        "point2": "sun",
        "aspect": "conjunction",
        "orb": 1.2,
        "applying": true
      }
    ],
    "charts": {
      "transit": {
        "title": "Transit Chart (Bi-wheel)",
        "url": "..."
      },
      "natal": {
        "title": "Natal Chart",
        "url": "..."
      }
    },
    "natalPoints": [...],
    "natalHouses": [...],
    "transitPoints": [...]
  }
}

カスタムオーブ

異なるアスペクトタイプにカスタムオーブ値を指定する：

bash

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-01-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "orbs": {
      "conjunction": 3,
      "opposition": 3,
      "trine": 2,
      "square": 2
    }
  }'

解釈テキスト付き

トランジット計算に解釈テキストを含める：

bash

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-15T00:00",
    "transitDateEnd": "2024-01-15T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "includeText": true,
    "language": "en"
  }'

iCalエクスポート

トランジットイベントをiCal（.ics）ファイルとしてエクスポートし、Googleカレンダー、Appleカレンダー、Outlookなどのカレンダーアプリにインポートできます。

POST `/api/calc/transit/ical`

bash

curl -X POST "https://api.astroapi.cloud/api/calc/transit/ical" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-03-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }' --output transits.ics

レスポンスは Content-Disposition: attachment; filename="transits.ics" を持つ text/calendar ファイルです。

パラメータ

iCalエクスポートは標準のトランジットエンドポイントと同じパラメータを受け入れ、さらに以下が追加されます：

パラメータ	型	必須	説明
`aspects`	array	いいえ	アスペクトタイプでフィルタリング（例：`["conjunction", "trine"]`）

TIP

ダウンロードした .ics ファイルをカレンダーアプリにインポートすると、各アスペクトの説明付きでトランジットイベントをカレンダーエントリとして確認できます。

トランジット ​