Parans API

Endpoint này chuyển thời điểm sinh thành ngày Julian, tính toàn bộ bộ astrocartography (bốn đường góc cho mỗi thiên thể), rồi giao nhau mọi đường với mọi đường của hành tinh khác. Mỗi giao điểm được trả về kèm cả hai hành tinh cha, cả hai loại đường, và vĩ độ, kinh độ nơi giao nhau. Vì các đường MC và IC là kinh tuyến, còn các đường AC và DC là đường cong phụ thuộc vào vĩ độ, hầu hết các giao điểm là hình học chứ không đối xứng: cặp Sun-MC và Moon-ASC gặp nhau đúng một nơi mỗi bán cầu, không trên một dải chung. Một biểu đồ điển hình cho hơn bốn trăm giao điểm trên toàn cầu, vì vậy chúng được trả về dưới dạng danh sách phẳng, có thể sắp xếp thay vì lọc trước theo bất kỳ tiêu chí quan trọng nào.

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

{
  "ok": true,
  "data": {
    "count": 414,
    "parans": [
      {
        "planet1Id": 0,
        "planet1Name": "Sun",
        "line1Type": "MC",
        "planet2Id": 1,
        "planet2Name": "Moon",
        "line2Type": "ASC",
        "location": { "lat": -45.9153, "lng": 6.5735 }
      }
    ]
  }
}

Dùng parans khi các đường astrocartography một mình quá thô. Các đường cho người dùng biết một hành lang có Jupiter; parans cho họ biết ở một vị trí cụ thể trên hành lang đó Jupiter gặp Venus. Sự khác biệt này là gì mà các tư vấn di chuyển tính phí, và là lớp mà hầu hết công cụ bản đồ bỏ qua. Thực tế: vẽ các đường dưới dạng polyline và parans dưới dạng marker có thể click, hoặc lọc danh sách theo các cặp hành tinh mà sản phẩm của bạn quan tâm và xếp hạng các thành phố gần nhất dựa trên khoảng cách tới các điểm đó. Phản hồi chỉ là tọa độ, vì vậy bạn có thể ghép nó với bộ dữ liệu thành phố hoặc vùng của mình mà không phải đấu tranh với định dạng văn bản. Lưu ý endpoint này không cần nơi sinh, chỉ cần thời điểm, vì các giao điểm là thuộc tính của bầu trời chứ không phải nơi người đó đang ở.

Các vị trí lấy từ Swiss Ephemeris (Astrodienst) được biên dịch sang WASM, cùng engine với các endpoint natal, vì vậy parans gắn vào cùng kinh độ hành tinh như các đường mà chúng xuất phát. Các giao điểm được tính trong zodiac nhiệt đới từ toàn bộ hình học đường thay vì ước lượng theo vĩ độ. Học thuyết paran cổ điển do Bernadette Brady đề ra cũng xử lý star-to-planet parans, và báo chúng dưới dạng vĩ độ thay vì điểm; trường hợp đó có endpoint riêng, [star-planet parans](/astrology-api/star-parans/). Cái này bao phủ trường hợp planet-to-planet mà bản đồ astrocartography tự tạo.