API pevných hvězd
Kromě pohyblivých planet, starší vrstva astrologie čte pevné hvězdy - Regulus, Spica, Algol, Aldebaran a jejich druhy. Tento endpoint skenuje natalní horoskop pro těsné konjunkce s těmito hlavními hvězdami a vrací každý kontakt s jeho orbem, takže můžete do výkladu zahrnout údajnou povahu hvězdy.
API pevných hvězd
Ze zadaného data narození, času, UTC posunu a souřadnic endpoint vypočítá natalní body a pak projde katalog hlavních pevných hvězd založený na tradici Vivian Robson a Ptolemaia - jde o jasné, astrologicky významné hvězdy, nikoliv o celou oblohu. Pro každou hvězdu testuje natalní body na konjunkci, a pokud jedna spadá do orbu, zaznamená kontakt spolu s přesným orbem oddělení. Výstup pod data.stars je seznam zásahů hvězda-bod: která hvězda, který natalní bod se dotýká a jak je blízko zarovnání, takže konjunkce o půl stupně je považována za silnější než ta na okraji orbu. Zvažují se pouze konjunkce - technika považuje hvězdu za významnou, když na ní leží bod horoskopu, nikoliv když tvoří úhlové vzdálenosti, které planety vytvářejí mezi sebou. Tím se odhalují pojmenované hvězdy, které klasické zdroje označily jako šťastné nebo nebezpečné, připravené k přiřazení k vašemu vlastnímu výkladu hvězd.
POST/v1/fixed-stars
curl -X POST https://api.astroway.info/v1/fixed-stars \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52
}'{
"ok": true,
"data": {
"stars": [
{
"star": "Regulus",
"point": "Mercury",
"orb": 0.4
},
{
"star": "Algol",
"point": "Mars",
"orb": 1.1
}
]
}
}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) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
When to use it
Použijte tento endpoint, když výklad horoskopu chce přidat další rozměr pojmenovaných hvězd - tradiční nebo hvězdovědomý interpret, generátor zpráv, který upozorní na výrazný kontakt s Algolem nebo královskou hvězdou Regulus, nebo vzdělávací nástroj, který učí o pověstech za nejjasnějšími hvězdami. Návrh s těsným orbem a pouze konjunkcemi udržuje výstup zaměřený: dostanete pár kontaktů, které stojí za zmínku, místo šumu, což usnadňuje zobrazení jako krátký zvýrazněný seznam. Pošlete mu stejná narození data, která jste poslali do endpointu natalního horoskopu, a zásahy hvězd se zarovnají s planetárními a úhlovými pozicemi již ve vašem horoskopu, což vám umožní anotovat planetu nebo úhel s jeho současnou hvězdou. Protože je katalog vybrán tradičně významnými hvězdami, můžete k každé připojit připravený interpretivní text bez nutnosti vybírat si seznam sami.
Notes
Katalog hvězd následuje výběr předaný od Vivian Robson a Ptolemaia - hlavní astrologicky významné pevné hvězdy, nikoliv úplný průzkum oblohy. Natalní pozice a hvězdné délky jsou vypočítány motorem Swiss Ephemeris (Astrodienst) v tropickém zvěrokole, a jsou vráceny pouze konjunkce v orbu.
Try the Pevné hvězdy API
Grab a key and make your first call in under a minute.