Hồi quy Mặt Trời & Mặt Trăng

Tính toán lá số hồi quy mặt trời (lá số sinh nhật) và hồi quy mặt trăng. Lá số hồi quy cho thấy vị trí hành tinh tại thời điểm chính xác khi một hành tinh trở về vị trí tử vi của nó, cung cấp thông tin dự báo cho năm hoặc tháng tới.

Hồi quy Mặt Trời

Lá số hồi quy mặt trời được tính toán cho thời điểm chính xác khi Mặt Trời trở về độ tử vi của nó mỗi năm, xảy ra gần ngày sinh. Nó được sử dụng để dự báo các chủ đề cho năm tới.

Module Bắt buộc

Yêu cầu module solar-return:calc.

bash

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
  }'

Tham số

Tham số	Kiểu	Bắt buộc	Mô tả
`birthDateTime`	string	Có	Ngày và giờ sinh theo định dạng `YYYY-MM-DDTHH:mm`
`birthLocation`	object	Có	Nơi sinh (xem Đối tượng Vị trí bên dưới)
`returnYear`	number	Không	Năm cho hồi quy mặt trời (mặc định: năm hiện tại)
`houseSystem`	string	Không	Hệ thống cung nhà (mặc định: `"placidus"`)
`language`	string	Không	Mã ngôn ngữ cho nội dung văn bản (mặc định: `"en"`)
`includeText`	boolean	Không	Bao gồm văn bản giải thích (mặc định: `false`)
`includeReadableEntities`	boolean	Không	Bao gồm tiêu đề thực thể dễ đọc (mặc định: `false`)
`points`	array	Không	Các điểm thiên thể để bao gồm trong tính toán
`orbs`	object	Không	Giá trị orb tùy chỉnh theo từng loại góc chiếu

Đối tượng Vị trí

json

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

Phản hồi

json

{
    "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/..."
            }
        }
    }
}

Các Trường Phản hồi

Trường	Kiểu	Mô tả
`returnYear`	number	Năm của hồi quy mặt trời này
`returnDate`	string	Thời điểm UTC chính xác của hồi quy mặt trời
`aspects`	array	Các góc chiếu trong lá số hồi quy mặt trời
`points`	object	Vị trí hành tinh trong lá số hồi quy mặt trời
`houses`	object	Điểm cung nhà trong lá số hồi quy mặt trời
`charts.solarReturn`	object	URL hình ảnh lá số hồi quy mặt trời
`charts.biWheel`	object	Lá số hai vòng cho thấy hồi quy mặt trời chồng lên lá số tử vi
`charts.natal`	object	URL hình ảnh lá số tử vi

Hồi quy Mặt Trăng

Lá số hồi quy mặt trăng được tính toán cho thời điểm chính xác khi Mặt Trăng trở về độ tử vi của nó mỗi tháng (khoảng mỗi 27,3 ngày). Nó được sử dụng để dự báo các chủ đề cho tháng tới.

Module Bắt buộc

Yêu cầu module lunar-return:calc.

bash

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
  }'

Tham số

Tham số	Kiểu	Bắt buộc	Mô tả
`birthDateTime`	string	Có	Ngày và giờ sinh theo định dạng `YYYY-MM-DDTHH:mm`
`birthLocation`	object	Có	Nơi sinh (kinh độ, vĩ độ, múi giờ)
`returnDate`	string	Không	Ngày bắt đầu (`YYYY-MM-DD`) để tìm hồi quy mặt trăng tiếp theo từ (mặc định: bây giờ)
`houseSystem`	string	Không	Hệ thống cung nhà (mặc định: `"placidus"`)
`language`	string	Không	Mã ngôn ngữ cho nội dung văn bản (mặc định: `"en"`)
`includeText`	boolean	Không	Bao gồm văn bản giải thích (mặc định: `false`)
`includeReadableEntities`	boolean	Không	Bao gồm tiêu đề thực thể dễ đọc (mặc định: `false`)
`points`	array	Không	Các điểm thiên thể để bao gồm trong tính toán
`orbs`	object	Không	Giá trị orb tùy chỉnh theo từng loại góc chiếu

Phản hồi

json

{
    "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/..."
            }
        }
    }
}

Các Trường Phản hồi

Trường	Kiểu	Mô tả
`returnDate`	string	Thời điểm UTC chính xác của hồi quy mặt trăng
`aspects`	array	Các góc chiếu trong lá số hồi quy mặt trăng
`points`	object	Vị trí hành tinh trong lá số hồi quy mặt trăng
`houses`	object	Điểm cung nhà trong lá số hồi quy mặt trăng
`charts.lunarReturn`	object	URL hình ảnh lá số hồi quy mặt trăng
`charts.biWheel`	object	Lá số hai vòng cho thấy hồi quy mặt trăng chồng lên lá số tử vi
`charts.natal`	object	URL hình ảnh lá số tử vi

Hệ thống Cung nhà

Cả hai endpoint đều hỗ trợ các hệ thống cung nhà giống như tính toán lá số tử vi:

Giá trị	Tên
`placidus`	Placidus (mặc định)
`koch`	Koch
`equal`	Cung Bằng nhau
`whole`	Toàn Dấu hiệu
`campanus`	Campanus
`regiomontanus`	Regiomontanus
`porphyry`	Porphyry

Vị trí cho Lá số Hồi quy

Nhiều nhà chiêm tinh học sử dụng vị trí nơi người đó đang hiện diện vào thời điểm hồi quy, thay vì vị trí sinh. Truyền vị trí cư trú hiện tại hoặc vị trí du lịch trong birthLocation nếu bạn muốn lá số hồi quy tương đối với vị trí.

Hồi quy Mặt Trời & Mặt Trăng ​