Star-planet parans API

Per ogni stella e pianeta l'endpoint prende i quattro eventi angolari (levata, tramonto, culminazione, anticumulazione) e chiede a quale latitudine i due avvengono allo stesso tempo siderale locale. La culminazione fissa il tempo siderale all'ascensione retta del corpo; levata e tramonto lo spostano dell'arco semi-diurno, che dipende da latitudine e declinazione. Ognuna delle dodici coppie di eventi viene risolta e ogni radice segnalata, con la latitudine, il tempo siderale e il meridiano dove la coppia è angolare in quel preciso momento della carta. Meridiano contro meridiano è scartato: quella condizione non ha latitudine, quindi o non vale mai o vale ovunque, e valere ovunque significa solo che i due condividono la stessa ascensione retta. Le stelle che hanno risolto ma non hanno prodotto nulla sono nominate nella risposta invece di essere silenziosamente scartate, come accade per una stella circumpolare come Polaris quasi per tutta la gamma.

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

Usa questo quando lo strato di stelle fisse di una carta deve essere più di un semplice elenco di congiunzioni. Una stella congiunta a un pianeta per longitudine zodiacale è una proiezione; un paran è la stella e il pianeta che stanno realmente sugli angoli insieme, che è la relazione su cui si basa il lavoro di Brady e che collega una stella a un luogo sulla mappa. In un prodotto di rilocalizzazione le latitudini sono tracciate come bande orizzontali, e una città che si trova su una di esse porta quella coppia stella-pianeta. Nota che l'endpoint non richiede il luogo di nascita, solo il momento: quali latitudini esistono è una proprietà del cielo, non di dove è nato l'individuo.

Risolto su angoli orari invece che intersecando le polilinee della mappa, così la latitudine è esatta invece di quantizzata al passo della polilinea, e la declinazione reale della stella è usata invece del grado zodiacale su cui si proietta. Questa distinzione è importante: Vega si trova a latitudine ecliptica 61 gradi e Sirio a meno 39, quindi il grado che occupano non sale quasi mai quando lo fanno. Le posizioni stellari provengono dal catalogo di stelle fisse Swiss Ephemeris, e la conversione ecliptica-equatoriale è verificata contro l'ephemeris stessa facendo passare i pianeti attraverso di essa. L'esempio di Castor elaborato da Brady è riprodotto entro un grado; non chiarisce se abbia usato l'orizzonte geometrico o apparente, e poiché i due differiscono di circa due gradi di latitudine paran, quella scelta è un parametro di richiesta invece del valore predefinito silenzioso.