API паранів зірка-планета

Для кожної пари зірка-планета ендпоінт бере чотири кутові події (схід, захід, кульмінація, антикульмінація) і питає, на якій широті дві з них припадають на той самий місцевий зоряний час. Кульмінація фіксує зоряний час на прямому сходженні тіла; схід і захід зсувають його на піводенну дугу, яка залежить від широти й схилення. Кожна з дванадцяти пар подій розв'язується, і кожен корінь повертається з широтою, зоряним часом і меридіаном, де пара стоїть на кутах саме в цей момент карти. Меридіан проти меридіана відкидається: у цій умові широти немає взагалі, тож вона або не виконується ніколи, або виконується всюди, а «всюди» означає лише спільне пряме сходження. Зірки, які обчислилися, але нічого не дали, названі у відповіді, а не викинуті мовчки, і саме це стається з навколополярною зіркою на кшталт Полярної майже на всьому діапазоні.

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
      }
    ]
  }
}

Беріть це тоді, коли шар нерухомих зірок у карті має бути чимось більшим за список з'єднань. З'єднання зірки з планетою за зодіакальною довготою це проєкція; паран це коли зірка й планета справді стоять на кутах разом, і саме на цьому побудована робота Брейді, і саме це прив'язує зірку до місця на карті. У продукті для релокації широти лягають горизонтальними смугами, і місто, що потрапило на смугу, несе цю пару зірка-планета. Зверніть увагу: місце народження не потрібне, лише момент, бо набір широт це властивість неба, а не того, де народилася людина.

Розв'язується через часові кути, а не перетином полілiній карти, тому широта точна, а не квантована кроком полілінії, і береться справжнє схилення зірки, а не градус зодіаку, на який вона проєктується. Різниця суттєва: Вега стоїть на екліптичній широті 61 градус, а Сіріус на мінус 39, тож градус, який вони займають, сходить зовсім не тоді, коли вони. Позиції зірок беруться з каталогу нерухомих зірок Swiss Ephemeris, а перетворення з екліптичних координат в екваторіальні перевірене проти самої ефемериди прогоном планет через нього. Робочий приклад Брейді з Кастором відтворюється з точністю до градуса; він не вирішує, який горизонт вона брала, геометричний чи видимий, а оскільки різниця між ними близько двох градусів широти парана, цей вибір винесено в параметр запиту, а не зашито мовчки.