Paran sao-hành tinh API

Đối với mỗi sao và hành tinh, endpoint lấy bốn sự kiện góc (rising, setting, culminating, anticulminating) và hỏi ở latitude nào hai sự kiện xảy ra cùng lúc tại cùng một local sidereal time. Culmination cố định sidereal time tại right ascension của thiên thể; rising và setting di chuyển nó bằng semi-diurnal arc, một hàm của latitude và declination. Mỗi trong mười hai cặp sự kiện được giải và mọi root được báo cáo, kèm latitude, sidereal time và meridian nơi cặp này tạo góc tại thời điểm chart cụ thể. Meridian đối lập meridian bị loại: điều kiện này không có latitude, vì vậy nó không bao giờ đúng hoặc luôn đúng, và luôn đúng chỉ có nghĩa là hai thiên thể chia sẻ right ascension. Các sao đã giải nhưng không tạo ra gì sẽ được liệt kê trong response thay vì bị bỏ im lặng, như trường hợp sao circumpolar như Polaris trên hầu hết dải.

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

{
  "ok": true,
  "data": {
    "type": "star-parans",
    "horizon": "geometric",
    "latitudeLimit": 60,
    "count": 16,
    "stars": [
      { "name": "Regulus", "magnitude": 1.36, "rightAscension": 151.9686, "declination": 12.0133 }
    ],
    "parans": [
      {
        "star": "Regulus",
        "starEvent": "rise",
        "planetId": 0,
        "planetName": "Sun",
        "planetEvent": "culminate",
        "latitude": 39.1022,
        "longitude": 6.5735,
        "lst": 51.6
      }
    ]
  }
}

Dùng cái này khi lớp fixed-star của chart cần hơn một danh sách conjunction. Một sao conjunct một hành tinh theo zodiacal longitude chỉ là một phép chiếu; một paran là sao và hành tinh thực sự đứng trên các góc cùng lúc, là mối quan hệ mà công trình của Brady dựa trên và là thứ nối sao với một vị trí trên bản đồ. Trong sản phẩm relocation, các latitude được vẽ thành các dải ngang, và một thành phố nằm trên một dải sẽ mang cặp sao-hành tinh đó. Lưu ý endpoint không cần nơi sinh, chỉ cần thời điểm: latitude tồn tại là thuộc tính của bầu trời, không phải nơi người sinh.

Giải dựa trên hour angles thay vì giao nhau các polyline bản đồ, vì vậy latitude là chính xác thay vì được lượng tử hoá theo bước polyline, và declination thực tế của sao được dùng thay vì độ zodiac mà nó chiếu lên. Sự khác biệt này quan trọng: Vega ở ecliptic latitude 61 độ và Sirius ở minus 39, nên độ mà chúng chiếm không tăng gần như khi chúng thực sự tăng. Vị trí sao lấy từ Swiss Ephemeris fixed-star catalogue, và việc chuyển đổi ecliptic-to-equatorial được kiểm tra với ephemeris bằng cách chạy các hành tinh qua nó. Ví dụ Castor của Brady được tái tạo trong vòng một độ; nó không quyết định cô dùng horizon geometric hay apparent, và vì hai cách khác nhau khoảng hai độ paran latitude, lựa chọn này là request parameter thay vì mặc định im lặng.