API Các khía cạnh Xuyệt Xích

Từ ngày sinh, giờ, UTC offset và tọa độ, endpoint tính toán xuyệt xích của mỗi thiên thể - khoảng cách của nó về phía bắc hoặc nam của xích đạo thiên thể, ngoài mặt phẳng hoàng đạo mà kinh độ được đo lường - và sau đó so sánh những xuyệt xích này giữa các thiên thể. Khi hai thiên thể có cùng xuyệt xích cùng phía của xích đạo, nó ghi nhận một song song, tương đương xuyệt xích của hợp; khi chúng có cùng xuyệt xích nhưng các phía đối lập, nó ghi nhận một phản song song, tương đương của đối. Mỗi tiếp xúc được trả về dưới data.parallels với các thiên thể liên quan. Endpoint cũng cung cấp ngữ cảnh vượt giới hạn - khi xuyệt xích của một thiên thể vượt quá tối đa của Mặt Trời, mang nó ra ngoài dải mà Mặt Trời từng đạt được, một điều kiện truyền thống được đọc là hành tinh hoạt động mà không có sự kiềm chế thông thường. Điều này cho bạn một lớp tiếp xúc mà kinh độ thuần túy hoàn toàn bỏ lỡ: hai hành tinh không có khía cạnh kinh độ vẫn có thể bị khóa trong một song song chặt chẽ.

curl -X POST https://api.astroway.info/v1/parallel-aspects \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52
}'

{
  "ok": true,
  "data": {
    "parallels": [
      {
        "planet1": "Sun",
        "planet2": "Moon",
        "type": "contra-parallel",
        "orb": 0.49
      }
    ]
  }
}

Sử dụng endpoint này khi một công cụ khía cạnh không nên dừng lại ở hoàng đạo - một trình phân tích biểu đồ nghiêm túc, một công cụ đồng tính hoặc chuyển giao muốn lớp xuyệt xích, hoặc một báo cáo giải thích tại sao hai hành tinh cảm thấy liên kết bất tạo thành khía cạnh kinh độ nào. Song song và phản song song chính xác là những tiếp xúc mà một lưới chỉ kinh độ bỏ qua, vì vậy thêm chúng lấp đầy một khoảng trống thực sự thay vì sao chép đầu ra khía cạnh biểu đồ sinh. Cờ vượt giới hạn độc lập hữu ích: nó đánh dấu các hành tinh mà truyền thống coi là hoạt động không kiểm soát, điều này tạo ra một điểm nhấn sạch sẽ trong báo cáo biểu đồ. Gửi cùng dữ liệu sinh bạn đã dùng ở nơi khác và các tiếp xúc xuyệt xích sẽ đề cập đến cùng các thiên thể như các khía cạnh kinh độ của bạn, cho phép bạn trình bày cả hai lưới như hai cách đọc của một biểu đồ.

Song song và phản song song tuân theo học thuyết xuyệt xích truyền thống, coi các tiếp xúc xuyệt xích bằng nhau như tương đương của hợp và đối; việc đọc vượt giới hạn dựa trên công việc của Kt Boehrer. Các xuyệt xích được tính toán bằng động lực của Swiss Ephemeris (Astrodienst) trong khung nhiệt đới, trên cùng các thiên thể như các endpoint sinh dựa trên kinh độ.