API Hướng Cung Mặt Trời

Từ dữ liệu sinh và ngày mục tiêu, endpoint đầu tiên tiến chart ngày-cho-năm, đo khoảng Mặt Trời đã di chuyển so với vị trí sinh, và lấy khoảng cách đó làm cung. Sau đó cộng cung này vào mọi kinh độ sinh một lúc: tất cả hành tinh, mọi cung nhà, ascendant và MC. Phản hồi chứa các vị trí đã định hướng trong data.planets và data.houses, cung tính bằng độ trong data.arc, và key tạo ra nó trong data.key. Vì một cung duy nhất được áp dụng đồng đều, hình học của chart sinh được giữ nguyên, chỉ mối quan hệ với độ sinh thay đổi, nên kỹ thuật này rất tiết kiệm để đọc: một số cho biết trạng thái toàn bộ chart ở một tuổi nhất định. Hai key khác cũng có trên cùng endpoint. Đặt key thành naibod để dùng tốc độ trung bình của Mặt Trời 59'08.3" mỗi năm, hoặc bỏ qua để dùng một độ mỗi năm. Gửi converse true sẽ hướng ngược lại từ thời điểm sinh thay vì tiến tới, đảo dấu của cung.

curl -X POST https://api.astroway.info/v1/symbolic-directions \
  -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,
  "targetDate": "2026-05-15",
  "key": "solar_arc"
}'

{
  "ok": true,
  "data": {
    "arc": 34.5083,
    "key": "solar_arc",
    "planets": [
      {
        "id": 0,
        "name": "Sun",
        "longitude": 88.8843,
        "isRetrograde": false
      }
    ],
    "houses": {
      "system": "P",
      "ascendant": 204.4763,
      "mc": 111.5826
    }
  }
}

Dùng Solar Arc khi bạn cần thời gian mang tính biểu tượng hơn là thiên văn, và muốn dạng mà người đọc có thể theo dõi. Vì mọi thứ di chuyển cùng tốc độ, một liên hệ định hướng sẽ rơi vào một năm cụ thể thay vì một khoảng thời gian, phù hợp cho tính năng dòng thời gian cuộc đời, báo cáo cột mốc tuổi, hoặc câu chuyện AI phải nói năm đó nói gì. Nó kết hợp tự nhiên với tiến triển phụ, vì cung được lấy từ cùng một Mặt Trời đã tiến triển: tiến triển cho chart nội bộ di chuyển, Solar Arc cho toàn bộ chart dịch lên. So sánh ba key khi độ chính xác quan trọng với khán giả. Solar Arc theo Mặt Trời thực tế nên hơi thay đổi theo ngày sinh, Naibod dùng tốc độ trung bình, và một độ mỗi năm là quy ước số tròn. Đối với sinh giữa tháng 5, ba giá trị ra khoảng 34.5, 35.5 và 36.0 độ trong 36 năm, đủ gần để đồng ý về thập kỷ và đủ xa để phân biệt các năm khác nhau.

Cung là khoảng cách Mặt Trời đã tiến triển phụ di chuyển, ngày cho một năm, là định nghĩa chuẩn; key Naibod dùng chuyển động trung bình hàng ngày của Mặt Trời, 59'08.3" mỗi năm. Đối với solar arc, chart đã tiến được tính tiến về phía trước và hướng di chuyển được áp dụng một lần, vì vậy hướng ngược sẽ trả về cung đã bị đảo dấu thay vì gấp đôi. Các vị trí lấy từ engine Swiss Ephemeris trong cung hoàng đạo nhiệt đới, trên cùng các thiên thể và hệ thống nhà như các endpoint sinh.