Quá độ

Tính toán các quá độ hành tinh và góc chiếu của chúng với lá số tử vi trong một khoảng thời gian xác định.

Tính toán Quá độ

Tính toán quá độ cho một phạm vi ngày:

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

Tham số

Tham số	Kiểu	Bắt buộc	Mô tả
birthDate	string	Có	Ngày/giờ sinh theo định dạng YYYY-MM-DDTHH:mm
birthLocation	object	Có	Nơi sinh với vĩ độ, kinh độ và múi giờ
transitDateStart	string	Có	Bắt đầu giai đoạn quá độ theo định dạng YYYY-MM-DDTHH:mm
transitDateEnd	string	Có	Kết thúc giai đoạn quá độ theo định dạng YYYY-MM-DDTHH:mm
transitLocation	object	Có	Vị trí quá độ với vĩ độ, kinh độ và múi giờ
houseSystem	string	Không	Hệ thống cung nhà (mặc định: "placidus")
points	array	Không	Các điểm thiên thể cần tính toán
orbs	object	Không	Giá trị orb tùy chỉnh theo từng loại góc chiếu
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)

Đối tượng Vị trí

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

Phản hồi

Phản hồi bao gồm các điểm giao cắt quá độ (khi hành tinh vào/ra các dấu hiệu hoặc cung nhà), vị trí cung nhà quá độ, các góc chiếu giữa hành tinh quá độ và hành tinh tử vi, và URL lá số.

{
  "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": [...]
  }
}

Orb Tùy chỉnh

Chỉ định các giá trị orb tùy chỉnh cho các loại góc chiếu khác nhau:

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

Với Văn bản Giải thích

Bao gồm văn bản giải thích cùng với tính toán quá độ của bạn:

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

Xuất iCal

Xuất các sự kiện quá độ dưới dạng tệp iCal (.ics) có thể được nhập vào các ứng dụng lịch như Google Calendar, Apple Calendar hoặc Outlook.

POST /api/calc/transit/ical

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

Phản hồi là tệp text/calendar với Content-Disposition: attachment; filename="transits.ics".

Tham số

Xuất iCal chấp nhận các tham số giống như endpoint quá độ chuẩn, cộng thêm:

Tham số	Kiểu	Bắt buộc	Mô tả
aspects	array	Không	Lọc theo loại góc chiếu (ví dụ: ["conjunction", "trine"])

TIP

Nhập tệp .ics đã tải xuống vào ứng dụng lịch của bạn để xem các sự kiện quá độ dưới dạng các mục lịch với mô tả của từng góc chiếu.