ソーラーリターンとルナーリターン

ソーラーリターン（誕生日チャート）とルナーリターンチャートを計算します。リターンチャートは、惑星がネイタル位置に戻る正確な瞬間の惑星位置を示し、翌年または翌月の予測洞察を提供します。

---

ソーラーリターン

ソーラーリターンチャートは、毎年太陽がネイタルの度数に戻る正確な瞬間（誕生日近く）に計算されます。来年のテーマを予測するために使用されます。

必要なモジュール

solar-return:calc モジュールが必要です。

curl -X POST "https://api.astroapi.cloud/api/calc/solar-return" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDateTime": "1990-06-15T14:30",
    "birthLocation": {
      "longitude": -0.1278,
      "latitude": 51.5074,
      "timezone": "Europe/London"
    },
    "returnYear": 2024,
    "houseSystem": "placidus",
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

パラメータ

パラメータ	型	必須	説明
birthDateTime	string	はい	YYYY-MM-DDTHH:mm 形式の出生日時
birthLocation	object	はい	出生地（以下の位置オブジェクトを参照）
returnYear	number	いいえ	ソーラーリターンの年（デフォルト：現在の年）
houseSystem	string	いいえ	ハウスシステム（デフォルト："placidus"）
language	string	いいえ	テキストコンテンツの言語コード（デフォルト："en"）
includeText	boolean	いいえ	解釈テキストを含める（デフォルト：false）
includeReadableEntities	boolean	いいえ	人間が読めるエンティティタイトルを含める（デフォルト：false）
points	array	いいえ	計算に含める天体ポイント
orbs	object	いいえ	アスペクトタイプ別のカスタムオーブ値

位置オブジェクト

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

レスポンス

{
    "data": {
        "returnYear": 2024,
        "returnDate": "2024-06-15T08:42:17Z",
        "aspects": [
            {
                "point1": "sun",
                "point2": "moon",
                "aspect": "trine",
                "orb": 1.8,
                "applying": false
            }
        ],
        "points": {
            "sun": {
                "longitude": 84.71,
                "latitude": 0.0,
                "sign": "gemini",
                "house": 10,
                "retrograde": false
            },
            "moon": {
                "longitude": 324.15,
                "latitude": -2.3,
                "sign": "aquarius",
                "house": 6,
                "retrograde": false
            }
        },
        "houses": {
            "1": { "cusp": 195.4, "sign": "libra" },
            "10": { "cusp": 84.5, "sign": "gemini" }
        },
        "charts": {
            "solarReturn": {
                "title": "Solar Return Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "biWheel": {
                "title": "Solar Return / Natal Bi-wheel",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "natal": {
                "title": "Natal Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            }
        }
    }
}

レスポンスフィールド

フィールド	型	説明
returnYear	number	このソーラーリターンの年
returnDate	string	ソーラーリターンの正確なUTC瞬間
aspects	array	ソーラーリターンチャート内のアスペクト
points	object	ソーラーリターンチャートの惑星位置
houses	object	ソーラーリターンチャートのハウスカスプ
charts.solarReturn	object	ソーラーリターンチャート画像URL
charts.biWheel	object	ネイタルチャートにソーラーリターンを重ねたバイホイール
charts.natal	object	ネイタルチャート画像URL

---

ルナーリターン

ルナーリターンチャートは、月が毎月ネイタルの度数に戻る正確な瞬間（約27.3日ごと）に計算されます。来月のテーマを予測するために使用されます。

必要なモジュール

lunar-return:calc モジュールが必要です。

curl -X POST "https://api.astroapi.cloud/api/calc/lunar-return" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDateTime": "1990-06-15T14:30",
    "birthLocation": {
      "longitude": -0.1278,
      "latitude": 51.5074,
      "timezone": "Europe/London"
    },
    "returnDate": "2024-06-01",
    "houseSystem": "placidus",
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

パラメータ

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

レスポンス

{
    "data": {
        "returnDate": "2024-06-12T03:18:44Z",
        "aspects": [
            {
                "point1": "moon",
                "point2": "venus",
                "aspect": "sextile",
                "orb": 0.9,
                "applying": true
            }
        ],
        "points": {
            "moon": {
                "longitude": 245.2,
                "latitude": -3.1,
                "sign": "sagittarius",
                "house": 4,
                "retrograde": false
            }
        },
        "houses": {
            "1": { "cusp": 130.8, "sign": "leo" },
            "4": { "cusp": 240.5, "sign": "sagittarius" }
        },
        "charts": {
            "lunarReturn": {
                "title": "Lunar Return Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "biWheel": {
                "title": "Lunar Return / Natal Bi-wheel",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "natal": {
                "title": "Natal Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            }
        }
    }
}

レスポンスフィールド

フィールド	型	説明
returnDate	string	ルナーリターンの正確なUTC瞬間
aspects	array	ルナーリターンチャート内のアスペクト
points	object	ルナーリターンチャートの惑星位置
houses	object	ルナーリターンチャートのハウスカスプ
charts.lunarReturn	object	ルナーリターンチャート画像URL
charts.biWheel	object	ネイタルチャートにルナーリターンを重ねたバイホイール
charts.natal	object	ネイタルチャート画像URL

---

ハウスシステム

両エンドポイントはネイタルチャート計算と同じハウスシステムをサポートしています：

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

リターンチャートの場所

多くの占星術師は出生地ではなく、リターン時に人物が実際にいる場所を使用します。場所を考慮したリターンチャートが必要な場合は、現在の居住地または旅行先を birthLocation に渡してください。