Stern-Planet-Paran-API
Ein Stern und ein Planet sind in Paran, wenn beide gleichzeitig im Winkel stehen, und ob das möglich ist, hängt allein von der geografischen Breite ab. Ein Paran ist also eine geografische Breite, so wie Bernadette Brady sie tabelliert, und dieser Endpunkt gibt Breitengrade anstelle von Punkten zurück. 953 Sterne sind verfügbar, 36 im Standard-Set.
Stern-Planet-Paran-API
Für jeden Stern und jeden Planeten nimmt der Endpunkt die vier Winkelereignisse (Aufgang, Untergang, Kulmination, Antikulmination) und fragt, bei welcher geografischen Breite die beiden Ereignisse zur gleichen lokalen siderischen Zeit stattfinden. Die Kulmination fixiert die siderische Zeit bei der Rektaszension des Himmelskörpers; Auf- und Untergang verschieben sie um den halben Tagesbogen, was eine Funktion der geografischen Breite und Deklination ist. Jedes der zwölf Ereignispaare wird gelöst und jede Wurzel gemeldet, mit der geografischen Breite, der siderischen Zeit und dem Meridian, an dem das Paar zu diesem bestimmten Zeitpunkt im Winkel steht. Meridian gegen Meridian wird abgelehnt: diese Bedingung hat keine geografische Breite in sich, also gilt sie entweder nie oder überall, und überall zu gelten bedeutet nur, dass die beiden eine Rektaszension teilen. Sterne, die gelöst wurden, aber nichts erzeugt haben, werden in der Antwort benannt, anstatt still wegzufallen, was bei einem zirkumpolaren Stern wie Polaris im gesamten Bereich passiert.
POST/v1/parans/star
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
}
]
}
} Parameter
| name | type | Erforderlich | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | ja | Birth date. |
| time | string (HH:MM:SS) | ja | Local clock time at birth. |
| timezoneOffset | number (hours) | nein | UTC offset in effect at the birth moment. Defaults to 0. |
| stars | string[] | nein | Star names from the Swiss Ephemeris catalogue. Defaults to the 36-star astrological set. The full list is at GET /v1/fixed-stars/catalog. |
| planets | number[] | nein | Swiss Ephemeris planet ids. Defaults to 0-9, Sun through Pluto. |
| latitudeLimit | number (degrees) | nein | Search range either side of the equator. Defaults to 60, the range Brady tabulates. |
| horizon | "geometric" | "apparent" | nein | Which horizon counts as rising. Geometric (default) is altitude 0; apparent is -34 arcmin, where refraction lifts a body into view first. Worth about two degrees of paran latitude at mid-latitudes. |
Wann verwenden
Verwenden Sie dies, wenn die Fixsternschicht eines Diagramms mehr als eine Konjunktionsliste sein muss. Ein Stern, der durch die ekliptische Länge mit einem Planeten konjunkt ist, ist eine Projektion; ein Paran ist der Stern und der Planet, die tatsächlich gemeinsam auf den Winkeln stehen, was die Beziehung ist, auf der Bradys Arbeit aufbaut und die einen Stern an einen Ort auf der Karte bindet. In einem Relokationsprodukt werden die Breitengrade als horizontale Bänder dargestellt, und eine Stadt, die auf einem solchen Band liegt, trägt diese Stern-Planet-Kombination. Beachten Sie, dass der Endpunkt keinen Geburtsort benötigt, nur den Zeitpunkt: welche Breitengrade existieren, ist eine Eigenschaft des Himmels, nicht des Geburtsorts der Person.
Hinweise
Gelöst auf Stundenwinkel anstatt durch Schnittstellen von Kartenpolylinien, sodass die geografische Breite genau ist und nicht auf den Polylinienschritt quantisiert wird, und die tatsächliche Deklination des Sterns wird verwendet, nicht das Tierkreisgrad, auf den er projiziert wird. Diese Unterscheidung ist wichtig: Vega befindet sich bei einer ekliptischen Breite von 61 Grad und Sirius bei minus 39, also steigt der Grad, den sie einnehmen, nirgendwo in der Nähe, wenn sie selbst aufgehen. Die Sternpositionen stammen aus dem Swiss Ephemeris Fixsternkatalog, und die Umrechnung von ekliptischen zu äquatorialen Koordinaten wird durch die Durchführung der Planeten durch den Ephemeris selbst überprüft. Bradys bearbeitetes Castor-Beispiel wird innerhalb eines Grades reproduziert; es klärt nicht, ob sie den geometrischen oder den sichtbaren Horizont verwendet hat, und da die beiden um etwa zwei Grad Paran-Breite differieren, ist diese Wahl ein Anfrageparameter anstelle eines stillen Standards.
Stern-Planet-Paran-API ausprobieren
Hol dir einen Key und mach deinen ersten Aufruf in unter einer Minute.