API par gwiazda-planeta

Dla każdej gwiazdy i planety endpoint przyjmuje cztery zdarzenia kątowe (wschód, zachód, kulminacja, antykulminacja) i pyta, na jakiej szerokości geograficznej oba zdarzenia mają miejsce w tym samym czasie gwiazdowym. Kulminacja ustala czas gwiazdowy na rektascencji ciała; wschód i zachód przesuwają go o łuk dobowy, który jest funkcją szerokości geograficznej i deklinacji. Każda z dwunastu par zdarzeń jest rozwiązywana, a każdy pierwiastek jest zgłaszany, wraz z szerokością geograficzną, czasem gwiazdowym i południkiem, para jest kątowa w tym konkretnym momencie wykresu. Południk przeciwko południkowi jest odrzucany: to warunek nie zależy od szerokości geograficznej, więc albo nigdy nie zachodzi, albo zachodzi wszędzie, a zachowanie wszędzie oznacza tylko, że dwie ciała mają wspólną rektascencję. Gwiazdy, które dały rozwiązanie, ale nie dały niczego, są wymienione w odpowiedzi, a nie cicho pomijane, tak jak ma to miejsce w przypadku gwiazdy polarnej jak Polaris niemal w całym zakresie.

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

Użyj tego, gdy warstwa gwiazd stałych wykresu musi być czym więcej niż listą koniunkcji. Gwiazda w koniunkcji z planetą wzdłuż długości zodiakalnej to tylko rzut; paran to gwiazda i planeta faktycznie stojące na kątach razem, co jest relacją, na której opiera się praca Brady, i która wiąże gwiazdę z miejscem na mapie. W produkcie dotyczącym przeprowadzki szerokości geograficzne są przedstawiane jako poziome pasma, a miasto leżące na jednym z nich nosi to połączenie gwiazda-planeta. Zauważ, że endpoint nie wymaga miejsca urodzenia, tylko momentu czasu: które szerokości geograficzne istnieją, to właściwość nieba, a nie miejsca urodzenia osoby.

Rozwiązane na kątach godzinowych, a nie przez przecinanie wielokątów mapowych, więc szerokość geograficzna jest dokładna, a nie kwantyzowana do kroku wielokąta, i używana jest rzeczywista deklinacja gwiazdy, a nie stopień zodiakalny, na który ona rzutuje. To rozróżnienie ma znaczenie: Vega znajduje się na szerokości ekliptycznej 61 stopni, a Syriusz na minus 39, więc stopień, który zajmują, nie wschodzi nigdzie blisko czasu, w którym one wschodzą. Pozycje gwiazd pochodzą z katalogu gwiazd stałych Swiss Ephemeris, a konwersja ekliptyczna na równikową jest sprawdzana w samej efemerydzie poprzez przepuszczenie przez nią planet. Przepracowany przykład Brady dotyczący Castora jest odtworzony z dokładnością do stopnia; nie rozstrzyga, czy użyła horyzontu geometrycznego czy pozornego, a ponieważ te dwa różnią się o około dwóch stopni szerokości paran, to wybór jest parametrem zapytania, a nie cichą wartością domyślną.