Ster-planeetparans API

Voor elke ster en planeet neemt dit endpoint de vier hoekige gebeurtenissen (opkomst, ondergang, culminatie, anticulminatie) en vraagt bij welke breedtegraad de twee op hetzelfde lokale siderische tijdstip plaatsvinden. Culminatie fixeert de siderische tijd op de rechte rektascensie van het lichaam; opkomst en ondergang verschuiven deze met de halfdaagse boog, die afhankelijk is van breedtegraad en declinatie. Elk van de twaalf gebeurtenispaaren wordt opgelost en elke wortel gerapporteerd, met de breedtegraad, de siderische tijd en de meridiaan waar het paar op dat specifieke kaartmoment hoekig is. Meridiaan tegen meridiaan wordt afgewezen: die voorwaarde heeft geen breedtegraad, dus hij geldt nooit of overal, en overal gelden betekent alleen dat de twee dezelfde rechte rektascensie delen. Sterren die opgelost werden maar niets opleverden, worden genoemd in de respons in plaats van stilletjes weggelaten, wat gebeurt bij een circumpolaire ster zoals Polaris over bijna het hele bereik.

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

Gebruik dit wanneer de vaste-sterrenlaag van een kaart meer moet zijn dan een conjunctielijst. Een ster die conjunct een planeet staat volgens de zodiacale lengtegraad is een projectie; een paran is de ster en de planeet die daadwerkelijk samen op de hoeken staan, de relatie waarop Brady's werk is gebaseerd en die een ster verbindt met een plek op de kaart. In een relocatie-product worden de breedtegraden weergegeven als horizontale banden, en een stad die op zo’n band zit, draagt die ster-planeetkoppeling. Let op: dit endpoint heeft geen geboorteplaats nodig, alleen het moment: welke breedtegraden bestaan is een eigenschap van de hemel, niet van waar iemand geboren is.

Opgelost op uurhoeken in plaats van door het kruisen van kaart-polylijnen, zodat de breedtegraad exact is in plaats van gekwantiseerd tot de polyline-stap, en de werkelijke declinatie van de ster wordt gebruikt in plaats van de zodiacale graad waarop hij projecteert. Die onderscheiding is belangrijk: Vega ligt op ecliptische breedtegraad 61 graden en Sirius op min 39, dus de graad die ze innemen stijgt niet in de buurt van wanneer ze dat doen. Sterposities komen uit de Swiss Ephemeris vaste-sterrencatalogus, en de ecliptisch-naar-equatoriale conversie wordt gecontroleerd tegen de ephemeris zelf door de planeten erdoorheen te laten lopen. Brady's uitgewerkte Castor-voorbeeld wordt tot binnen een graad gereproduceerd; het bepaalt niet of ze de geometrische of de apparente horizon gebruikte, en aangezien de twee ongeveer twee graden paran-breedtegraad verschillen, is die keuze een request-parameter in plaats van een stille standaard.