Solar return astrocartography API

Endpoint trước tiên xây dựng biểu đồ sinh, sau đó tìm kiếm thời điểm trong năm được yêu cầu mà Mặt Trời di chuyển đạt đến kinh độ sinh Mặt Trời, với độ chính xác tốt hơn một giây cung. Nó tính toán vị trí hành tinh cho thời điểm đó và vẽ bốn họ đường góc trên toàn thế giới, chính xác như endpoint astrocartography sinh làm, trả về sáu mươi ba đường. Tên mỗi hành tinh đều có hậu tố SR để một client hiển thị cả hai bản đồ cùng lúc không thể nhầm lẫn đường Jupiter sinh với đường nhật giải. Các đường được trả về dưới dạng cặp tọa độ có cùng hình dạng như /acg, vì vậy một trình kết xuất hiện có không cần thay đổi gì ngoài kiểu cho lớp thứ hai.

curl -X POST https://api.astroway.info/v1/solar-acg \
  -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,
  "year": 2026
}'

{
  "ok": true,
  "data": {
    "year": 2026,
    "lines": [
      {
        "planet": "Sun (SR)",
        "planetId": 0,
        "type": "MC",
        "coordinates": [[-85, 110.4845], [-84.5, 110.4845], "…"]
      }
    ]
  }
}

Đây là endpoint đằng sau câu hỏi thương mại nhất trong chiêm tinh địa lý: tôi nên ở đâu để mừng sinh nhật, và tôi nên đặt trụ sở ở đâu trong năm nay. Biểu đồ nhật giải truyền thống được tạo ra cho bất cứ nơi nào người đó thực sự ở vào thời điểm nhật giải, điều này khiến vị trí trở thành một quyết định chứ không phải là một điều đã cho, và bản đồ này chính là thứ biến quyết định đó thành thứ mà người dùng có thể thấy. Xây dựng báo cáo di chuyển hàng năm, trình gợi ý chuyến đi sinh nhật, hoặc lớp phủ hàng năm trên bản đồ astrocartography hiện có của bạn. Vì thời điểm nhật giải cơ bản thay đổi mỗi năm, kết quả là nội dung có thể mua lại một cách tự nhiên thay vì một lần tính toán duy nhất, và nó kết hợp trực tiếp với /solar-return khi người dùng muốn cả biểu đồ và bản đồ.

Vị trí đến từ Swiss Ephemeris (Astrodienst) được biên dịch thành WASM. Thời điểm nhật giải được giải quyết dựa trên kinh độ sinh Mặt Trời trong hoàng đạo nhiệt đới; nhật giải tinh độ là một kỹ thuật khác và không phải là thứ mà endpoint này tính toán. Bản đồ được vẽ từ biểu đồ nhật giải một mình, vì vậy nó là sự thay thế hoàn toàn cho các đường sinh trong năm đó chứ không phải là một sửa đổi của chúng. Một số trường phái tạo nhật giải cho nơi sinh thay vì vị trí hiện tại; lựa chọn đó thuộc về lớp diễn giải của bạn, vì hình học của đường là giống nhau trong cả hai trường hợp.