API hvězda-planeta parany
Hvězda a planeta jsou v paranu, když jsou obě v úhlové pozici ve stejný okamžik, a zda se to může stát, závisí pouze na zeměpisné šířce. Paran je tedy zeměpisná šířka, takto ji Bernadette Brady tabuluje, a tento endpoint vrací zeměpisné šířky nikoli body. Je dostupných 953 hvězd, 36 ve výchozím souboru.
API hvězda-planeta parany
Pro každou hvězdu a planetu endpoint vezme čtyři úhlové události (východ, západ, kulminace, antikulminace) a ptá se, na jaké zeměpisné šířce se tyto dvě události dějí ve stejný místní siderický čas. Kulminace stanoví siderický čas na tělesse right ascension; východ a západ ho posouvají o poloviční denní oblouk, což je funkce zeměpisné šířky a deklinace. Každý z dvanácti párů událostí je vyřešen a každý kořen je hlášen, se zeměpisnou šířkou, siderickým časem a poledníkem, kde je pár v úhlové pozici v tomto konkrétním okamžiku horoskopu. Poledník proti poledníku je odmítnut: tato podmínka nemíří na žádnou zeměpisnou šířku, takže buď nikdy neplatí, nebo platí všude, a platí všude pouze znamená, že sdílejí stejné right ascension. Hvězdy, které byly vyřešeny, ale nevyprodukovaly nic, jsou v odpovědi jmenovány místo tichého odstranění, což se děje u cirkumpolární hvězdy jako Polaris napříč téměř celým rozsahem.
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
}
]
}
} Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | no | UTC offset in effect at the birth moment. Defaults to 0. |
| stars | string[] | no | 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[] | no | Swiss Ephemeris planet ids. Defaults to 0-9, Sun through Pluto. |
| latitudeLimit | number (degrees) | no | Search range either side of the equator. Defaults to 60, the range Brady tabulates. |
| horizon | "geometric" | "apparent" | no | 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. |
When to use it
Použijte to, když pevná hvězdná vrstva horoskopu potřebuje být více než seznam konjunkcí. Hvězda v konjunkci s planetou podle zodiakální délky je projekce; paran je hvězda a planeta skutečně stojící na úhlech společně, což je vztah, na kterém je postavena Bradyho práce a který váže hvězdu k místu na mapě. V produktu pro změnu místa se zeměpisné šířky zakreslují jako vodorovné pásy a město ležící na jednom z nich nese toto párování hvězda-planeta. Upozorňujeme, že endpoint nepotřebuje místo narození, pouze okamžik: které zeměpisné šířky existují, je vlastností oblohy, nikoli místem, kde se člověk narodil.
Notes
Řešeno na hodinových úhlech nikoli průsečíkem mapových linií, takže zeměpisná šířka je přesná místo kvantizace na krok linií, a je použita skutečná deklinace hvězdy nikoli zodiakální stupeň, na který promítá. Tato rozdílnost je důležitá: Vega leží na ekliptické šířce 61 stupňů a Sirius na minus 39, takže stupeň, který zaujímají, nevychází nikde blízko, když ony vycházejí. Pozice hvězd pocházejí ze katalogu Swiss Ephemeris fixed-star a převod z ekliptického na rovníkový je ověřen proti samotnému efemeridám spuštěním planet skrz něj. Bradyho vyřešený příklad Castoru je reprodukován na jeden stupeň přes; neurčuje, zda použila geometrický nebo zjevný horizont, a protože se dva liší asi o dva stupně paran šířky, je tento výběr parametrem požadavku místo tichého výchozího nastavení.
Try the Hvězda-planeta parany API
Grab a key and make your first call in under a minute.