Giai đoạn Nghịch hành
Tính toán các giai đoạn nghịch hành cho các hành tinh trong một phạm vi ngày xác định, bao gồm các giai đoạn bóng trước và sau nghịch hành.
Module Bắt buộc
Yêu cầu module retrograde:calc.
Tính toán Giai đoạn Nghịch hành
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"]
}'Tham số
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
startDate | string | Có | Ngày bắt đầu theo định dạng YYYY-MM-DD |
endDate | string | Có | Ngày kết thúc theo định dạng YYYY-MM-DD |
points | array | Không | Các hành tinh để tính toán giai đoạn nghịch hành (xem mặc định bên dưới) |
Điểm Mặc định
Nếu points không được chỉ định, các giai đoạn nghịch hành được tính toán cho tất cả các hành tinh ngoài và trong chuẩn:
mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, chiron
Phạm vi Ngày
Các phạm vi ngày dài hơn sẽ bao gồm nhiều giai đoạn nghịch hành hơn nhưng có thể mất thêm thời gian để tính toán. Không có giới hạn nghiêm ngặt về phạm vi ngày, nhưng các phạm vi từ một hoặc hai năm là điển hình.
Phản hồi
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
}
}
]
}
}Các Trường Phản hồi
| Trường | Kiểu | Mô tả |
|---|---|---|
dateRange | object | Ngày bắt đầu và kết thúc của phạm vi được yêu cầu |
periodsByPoint | object | Các giai đoạn nghịch hành được nhóm theo tên hành tinh |
periods | array | Tất cả các giai đoạn nghịch hành theo thứ tự thời gian |
Đối tượng RetrogradePeriod
| Trường | Kiểu | Mô tả |
|---|---|---|
retrogradeStation | object | Dữ liệu cho khi hành tinh dừng lại nghịch hành |
directStation | object | Dữ liệu cho khi hành tinh dừng lại thuận hành |
durationDays | number | Độ dài giai đoạn nghịch hành tính bằng ngày |
signsTraversed | array | Các cung hoàng đạo hành tinh di chuyển qua trong khi nghịch hành |
preRetrogradeShadow | object | Giai đoạn bóng trước khi nghịch hành bắt đầu |
postRetrogradeShadow | object | Giai đoạn bóng sau khi hành tinh chuyển thuận |
Đối tượng Station
| Trường | Kiểu | Mô tả |
|---|---|---|
date | string | Dấu thời gian UTC của điểm dừng |
longitude | number | Kinh độ hoàng đạo (0–360) tại điểm dừng |
sign | string | Cung hoàng đạo tại điểm dừng |
degreesInSign | number | Độ trong cung (0–30) |
Đối tượng Shadow Period
| Trường | Kiểu | Mô tả |
|---|---|---|
startDate | string | Bắt đầu UTC của giai đoạn bóng |
endDate | string | Kết thúc UTC của giai đoạn bóng |
durationDays | number | Độ dài giai đoạn bóng tính bằng ngày |
Giải thích về Giai đoạn Bóng
Mỗi nghịch hành có hai giai đoạn bóng:
- Bóng trước nghịch hành: Bắt đầu khi hành tinh lần đầu tiên đạt đến độ nơi nó cuối cùng sẽ chuyển thuận. Hành tinh "xem trước" lãnh thổ mà nó sẽ xem xét lại sau này.
- Bóng sau nghịch hành: Kết thúc khi hành tinh trở về độ nơi nó lần đầu tiên dừng lại nghịch hành. Hành tinh đang hoàn thành việc xem xét vùng nghịch hành.
Lập kế hoạch với Bóng
Nhiều nhà chiêm tinh học khuyên thận trọng không chỉ trong chính giai đoạn nghịch hành mà còn trong cả hai giai đoạn bóng. Toàn bộ chu kỳ nghịch hành — tiền bóng, nghịch hành, hậu bóng — là giai đoạn xem xét hoàn chỉnh cho các chủ đề của hành tinh đó.
Tần suất Nghịch hành Điển hình
| Hành tinh | Tần suất | Thời gian |
|---|---|---|
| Mercury | 3–4 lần mỗi năm | ~3 tuần |
| Venus | Một lần mỗi ~18 tháng | ~6 tuần |
| Mars | Một lần mỗi ~2 năm | ~2–3 tháng |
| Jupiter | Một lần mỗi năm | ~4 tháng |
| Saturn | Một lần mỗi năm | ~4,5 tháng |
| Uranus | Một lần mỗi năm | ~5 tháng |
| Neptune | Một lần mỗi năm | ~5 tháng |
| Pluto | Một lần mỗi năm | ~5–6 tháng |
| Chiron | Một lần mỗi năm | ~5 tháng |