API des parans étoile-planète

Pour chaque étoile et chaque planète, l'endpoint prend les quatre événements angulaires (lever, coucher, culmination, anticulmination) et détermine à quelle latitude les deux se produisent au même temps sidéral local. La culmination fixe le temps sidéral à l'ascension droite du corps ; le lever et le coucher le déplacent selon l'arc semi-diurne, fonction de la latitude et de la déclinaison. Chacune des douze paires d'événements est résolue et chaque solution est rapportée, avec la latitude, le temps sidéral et le méridien où la paire est angulaire à ce moment précis du thème. Le méridien contre méridien est rejeté : cette condition n’a aucune latitude, donc elle ne se vérifie jamais ou partout, et « partout » signifie simplement que les deux partagent la même ascension droite. Les étoiles qui ont résolu mais n'ont rien produit sont nommées dans la réponse plutôt que d’être silencieusement ignorées, comme pour une étoile circumpolaire telle que Polaris sur presque toute la gamme.

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

Utilise ceci quand la couche d'étoiles fixes d'un thème doit être plus qu'une simple liste de conjonctions. Une étoile conjointe à une planète par longitude zodiacale est une projection ; un paran, c'est l'étoile et la planète réellement placées sur les angles ensemble, ce qui correspond à la relation sur laquelle le travail de Brady est basé et qui lie une étoile à un lieu sur la carte. Dans un produit de relocalisation, les latitudes s'affichent comme des bandes horizontales, et une ville située sur l'une porte cette association étoile-planète. Note que l'endpoint n'a besoin d'aucun lieu de naissance, seulement du moment : quelles latitudes existent est une propriété du ciel, pas du lieu de naissance de la personne.

Résolu sur les angles horaires plutôt qu'en intersectant des polylignes de carte, donc la latitude est exacte au lieu d'être quantifiée au pas de la polyligne, et la déclinaison réelle de l'étoile est utilisée plutôt que le degré zodiacal projeté. Cette distinction compte : Vega se trouve à 61° de latitude écliptique et Sirius à -39°, donc le degré qu'elles occupent ne monte jamais près de leur position réelle. Les positions des étoiles proviennent du catalogue d'étoiles fixes Swiss Ephemeris, et la conversion écliptique-équatoriale est vérifiée contre l'éphéméride elle-même en faisant passer les planètes à travers. L'exemple Castor travaillé par Brady est reproduit à moins d'un degré ; il ne précise pas si elle a utilisé l'horizon géométrique ou apparent, et comme les deux diffèrent d'environ deux degrés de latitude de paran, ce choix est un paramètre de requête plutôt qu'une valeur par défaut silencieuse.