逆行期間
指定した日付範囲内での惑星の逆行期間を、逆行前シャドウと逆行後シャドウ期間を含めて計算します。
必要なモジュール
retrograde:calc モジュールが必要です。
逆行期間の計算
bash
curl -X POST "https://api.astroapi.cloud/api/calc/retrograde" \
-H "X-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"startDate": "2024-01-01",
"endDate": "2024-12-31",
"points": ["mercury", "venus", "mars"]
}'パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
startDate | string | はい | YYYY-MM-DD 形式の開始日 |
endDate | string | はい | YYYY-MM-DD 形式の終了日 |
points | array | いいえ | 逆行期間を計算する惑星（以下のデフォルトを参照） |
デフォルトポイント
points が指定されていない場合、すべての標準的な外惑星と内惑星の逆行期間が計算されます：
mercury、venus、mars、jupiter、saturn、uranus、neptune、pluto、chiron
日付範囲
長い日付範囲には多くの逆行期間が含まれますが、計算に若干時間がかかる場合があります。日付範囲に厳密な制限はありませんが、1〜2年の範囲が一般的です。
レスポンス
json
{
"data": {
"dateRange": {
"startDate": "2024-01-01",
"endDate": "2024-12-31"
},
"periodsByPoint": {
"mercury": [
{
"retrogradeStation": {
"date": "2024-04-01T15:14:00Z",
"longitude": 27.3,
"sign": "aries",
"degreesInSign": 27.3
},
"directStation": {
"date": "2024-04-25T08:54:00Z",
"longitude": 15.6,
"sign": "aries",
"degreesInSign": 15.6
},
"durationDays": 24,
"signsTraversed": ["aries"],
"preRetrogradeShadow": {
"startDate": "2024-03-18T00:00:00Z",
"endDate": "2024-04-01T15:14:00Z",
"durationDays": 14
},
"postRetrogradeShadow": {
"startDate": "2024-04-25T08:54:00Z",
"endDate": "2024-05-13T00:00:00Z",
"durationDays": 18
}
}
],
"mars": [
{
"retrogradeStation": {
"date": "2024-12-06T09:33:00Z",
"longitude": 86.0,
"sign": "gemini",
"degreesInSign": 6.0
},
"directStation": {
"date": "2025-02-23T22:00:00Z",
"longitude": 47.2,
"sign": "cancer",
"degreesInSign": 17.2
},
"durationDays": 79,
"signsTraversed": ["gemini", "cancer"],
"preRetrogradeShadow": {
"startDate": "2024-10-26T00:00:00Z",
"endDate": "2024-12-06T09:33:00Z",
"durationDays": 41
},
"postRetrogradeShadow": {
"startDate": "2025-02-23T22:00:00Z",
"endDate": "2025-05-01T00:00:00Z",
"durationDays": 66
}
}
]
},
"periods": [
{
"point": "mercury",
"retrogradeStation": {
"date": "2024-04-01T15:14:00Z",
"longitude": 27.3,
"sign": "aries",
"degreesInSign": 27.3
},
"directStation": {
"date": "2024-04-25T08:54:00Z",
"longitude": 15.6,
"sign": "aries",
"degreesInSign": 15.6
},
"durationDays": 24,
"signsTraversed": ["aries"],
"preRetrogradeShadow": {
"startDate": "2024-03-18T00:00:00Z",
"endDate": "2024-04-01T15:14:00Z",
"durationDays": 14
},
"postRetrogradeShadow": {
"startDate": "2024-04-25T08:54:00Z",
"endDate": "2024-05-13T00:00:00Z",
"durationDays": 18
}
}
]
}
}レスポンスフィールド
| フィールド | 型 | 説明 |
|---|---|---|
dateRange | object | リクエストされた範囲の開始日と終了日 |
periodsByPoint | object | 惑星名でグループ化された逆行期間 |
periods | array | 時系列順のすべての逆行期間 |
RetrogradePeriodオブジェクト
| フィールド | 型 | 説明 |
|---|---|---|
retrogradeStation | object | 惑星が逆行ステーションになる際のデータ |
directStation | object | 惑星が順行ステーションになる際のデータ |
durationDays | number | 逆行期間の長さ（日数） |
signsTraversed | array | 逆行中に惑星が通過する黄道サイン |
preRetrogradeShadow | object | 逆行開始前のシャドウ期間 |
postRetrogradeShadow | object | 惑星が順行になった後のシャドウ期間 |
Stationオブジェクト
| フィールド | 型 | 説明 |
|---|---|---|
date | string | ステーションのUTCタイムスタンプ |
longitude | number | ステーション時の黄道経度（0〜360） |
sign | string | ステーション時の黄道サイン |
degreesInSign | number | サイン内の度数（0〜30） |
ShadowPeriodオブジェクト
| フィールド | 型 | 説明 |
|---|---|---|
startDate | string | シャドウ期間のUTC開始 |
endDate | string | シャドウ期間のUTC終了 |
durationDays | number | シャドウ期間の長さ（日数） |
シャドウ期間の説明
各逆行には2つのシャドウ期間があります：
- 逆行前シャドウ：惑星が最終的に順行になる度数に最初に達した時に始まります。惑星は後に再訪する領域を「プレビュー」します。
- 逆行後シャドウ：惑星が最初に逆行ステーションになった度数に戻った時に終わります。惑星は逆行ゾーンのレビューを完了しています。
シャドウ期間を使った計画
多くの占星術師は逆行自体だけでなく、両方のシャドウ期間中も注意を促しています。逆行前シャドウ、逆行、逆行後シャドウからなる完全な逆行サイクルが、その惑星のテーマに関するレビューの完全な期間です。
典型的な逆行頻度
| 惑星 | 頻度 | 期間 |
|---|---|---|
| 水星 | 年に3〜4回 | 約3週間 |
| 金星 | 約18ヶ月に1回 | 約6週間 |
| 火星 | 約2年に1回 | 約2〜3ヶ月 |
| 木星 | 年に1回 | 約4ヶ月 |
| 土星 | 年に1回 | 約4.5ヶ月 |
| 天王星 | 年に1回 | 約5ヶ月 |
| 海王星 | 年に1回 | 約5ヶ月 |
| 冥王星 | 年に1回 | 約5〜6ヶ月 |
| カイロン | 年に1回 | 約5ヶ月 |