API de parans estrela-planeta

Para cada estrela e planeta, o endpoint toma os quatro eventos angulares (nascimento, ocaso, culminação e anti-culminação) e pergunta em que latitude os dois acontecem ao mesmo tempo sideral local. A culminação fixa o tempo sideral na ascensão reta do corpo; o nascimento e o ocaso deslocam-no pelo arco semi-diurno, que é uma função da latitude e da declinação. Cada um dos doze pares de eventos é resolvido e cada raiz é reportada, com a latitude, o tempo sideral e o meridiano onde o par está angular neste momento específico do mapa. Meridiano contra meridiano é rejeitado: essa condição não contém latitude, por isso ou nunca se verifica ou verifica-se em todo o lado, e verificar-se em todo o lado significa apenas que os dois partilham uma ascensão reta. As estrelas que foram resolvidas mas não produziram nada são nomeadas na resposta em vez de serem silenciosamente omitidas, que é o que acontece a uma estrela circumpolar como Polaris em quase toda a gama.

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 isto quando a camada de estrelas fixas de um mapa precisa de ser mais do que uma lista de conjunções. Uma estrela em conjunção com um planeta por longitude zodiacal é uma projeção; um paran é a estrela e o planeta realmente juntos nos ângulos, que é a relação em que o trabalho de Brady assenta e a que liga uma estrela a um lugar no mapa. Num produto de relocalização, as latitudes aparecem como faixas horizontais, e uma cidade sobre uma delas carrega esse emparelhamento estrela-planeta. Nota que o endpoint não precisa do local de nascimento, apenas do momento: que latitudes existem é uma propriedade do céu, não do lugar onde a pessoa nasceu.

Resolvido em ângulos horários em vez de intersectar polilinhas no mapa, por isso a latitude é exata em vez de quantizada ao passo da polilinha, e é usada a declinação real da estrela em vez do grau do zodíaco sobre o qual ela se projeta. Essa distinção importa: Vega está a 61 graus de latitude eclíptica e Sirius a menos 39, por isso o grau que ocupam não nasce nem perto de quando elas nascem. As posições das estrelas vêm do catálogo de estrelas fixas do Swiss Ephemeris, e a conversão eclíptica-equatorial é verificada contra a própria efeméride passando os planetas por ela. O exemplo trabalhado de Castor de Brady é reproduzido com erro inferior a um grau; isso não resolve se ela usou o horizonte geométrico ou o aparente, e como os dois diferem em cerca de dois graus de latitude de paran, essa escolha é um parâmetro do pedido em vez de uma predefinição silenciosa.