Star-planet parans API

Pentru fiecare stea și planetă, endpoint-ul ia cele patru evenimente angulare (rising, setting, culminating, anticulminating) și întreabă la ce latitudine cele două se întâmplă în același timp sideral local. Culminarea fixează timpul sideral la ascensiunea dreaptă a corpului; rising și setting îl mută prin arcul semidiurn, care este o funcție a latitudinii și declinației. Fiecare dintre cele douăsprezece perechi de evenimente este rezolvată și fiecare rădăcină raportată, cu latitudinea, timpul sideral și meridianul unde perechea este angulară în acel moment specific al graficului. Meridianul împotriva meridianului este respins: acea condiție nu are latitudine, deci fie nu se întâmplă niciodată, fie se întâmplă pretutindeni, iar prezența pretutindeni înseamnă doar că cele două împărtășesc aceeași ascensiune dreaptă. Stelele care s-au rezolvat dar nu au produs nimic sunt numite în răspuns în loc să fie eliminate în tăcere, ceea ce se întâmplă cu o stea circumpolară ca Polaris în aproape tot intervalul.

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

Folosește asta când stratul de stele fixe al unei hărți trebuie să fie mai mult decât o listă de conjuncții. O stea conjunctă cu o planetă prin longitudinea zodiacală este o proiecție; un paran este steaua și planeta care stau efectiv pe unghiuri împreună, relația pe care se bazează munca lui Brady și care leagă o stea de un loc pe hartă. Într-un produs de relocare, latitudinile se trasează ca benzi orizontale, și un oraș situat pe una poartă acea pereche stea-planetă. Reține că endpoint-ul nu are nevoie de locul nașterii, doar de moment: latitudinile existente sunt o proprietate a cerului, nu a locului unde s-a născut persoana.

Rezolvat pe unghiuri de oră în loc de intersectarea polilanelor hărții, astfel latitudinea este exactă în loc să fie cuantizată la pasul polilanelor, și declinația reală a stelei este folosită în loc de gradul zodiacal pe care îl proiectează. Această diferență contează: Vega se află la latitudinea ecliptică de 61 de grade și Sirius la minus 39, deci gradul pe care îl ocupă nu apare nicăieri când se ridică. Pozițiile stelelor provin din catalogul de stele fixe Swiss Ephemeris, iar conversia ecliptic-la-ecuatorial este verificată cu ephemerida însăși prin rularea planetelor prin ea. Exemplul lui Castor lucrat de Brady este reprodus cu o precizie de un grad; nu se stabilește dacă a folosit orizontul geometric sau cel aparent, și cum cele două diferă cu aproximativ două grade de latitudine paran, acea alegere este un parametru de cerere în loc de o valoare implicită silențioasă.