API pro návrat Slunce v astrokartoografii
Natační astrokartoografie odpovídá na to, kde funguje horoskop. Návratová astrokartoografie odpovídá na to, kde funguje tento rok. Endpoint vypočítá přesný okamžik, kdy Slunce vrátí do své natační délky ve vámi zadaném roce, a pak mapuje tento horoskop po celém světě jako vlastní sadu úhlových linií.
API pro návrat Slunce v astrokartoografii
Endpoint nejprve sestaví natační horoskop, pak hledá okamžik ve zvoleném roce, kdy přecházející Slunce dosáhne natační sluneční délky s přesností pod jednu vteřinu úhlu. Vypočítá planetární pozice pro tento okamžik a zakreslí čtyři rodiny úhlových linií po celém světě, přesně jako endpoint natační astrokartoografie, vracející šedesát tři linie. Každý název planety nese příponu SR, aby klient vykreslující obě mapy nemohl zaměnit natační linii Jupiteru s návratovou. Linie jsou vráceny jako dvojice souřadnic ve stejném tvaru jako /acg, takže existující vykreslovací nástroj nepotřebuje žádné změny kromě stylu pro druhou vrstvu.
POST/v1/solar-acg
curl -X POST https://api.astroway.info/v1/solar-acg \
-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,
"year": 2026
}'{
"ok": true,
"data": {
"year": 2026,
"lines": [
{
"planet": "Sun (SR)",
"planetId": 0,
"type": "MC",
"coordinates": [[-85, 110.4845], [-84.5, 110.4845], "…"]
}
]
}
}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. |
| latitude | number | yes | Birth-place latitude, decimal degrees. |
| longitude | number | yes | Birth-place longitude, decimal degrees. |
| year | number | yes | Calendar year of the solar return whose map you want. |
When to use it
Toto je endpoint za jednou z nejkomerčnějších otázek v astrologii přesunu: kde bych měl strávit narozeniny a kde bych měl být tento rok. Návratové horoskopy jsou tradičně sestavovány pro místo, kde se osoba fyzicky nachází v okamžiku návratu, což z místa činí rozhodnutí spíše než danost, a tato mapa je tím, co toto rozhodnutí proměňuje v něco, co uživatel může vidět. Sestavte roční zprávu o přesunu, doporučovač narozeninových výletů nebo roční vrstvu na vaši existující astrokartoografickou mapu. Protože základní okamžik návratu se každý rok mění, výsledek je přirozeně opakovaně kupovatelný obsah spíše než jednorázový výpočet, a skládá se přímo s /solar-return, když uživatel chce jak mapu, tak horoskop.
Notes
Pozice pocházejí ze Swiss Ephemeris (Astrodienst) zkompilovaného do WASM. Okamžik návratu je řešen vůči natační slunečné délce v tropickém zvěrokole; siderické návraty Slunce jsou jiná technika a nejsou tím, co tento endpoint počítá. Mapa je vytvořena pouze z návratového horoskopu, takže je to úplná náhrada natačních linií pro daný rok spíše než jejich modifikace. Některé školy sestavují návrat pro místo narození místo současné polohy; toto rozhodnutí náleží vaší interpretativní vrstvě, protože geometrie linií je oběma způsoby identická.
Try the Návrat Slunce v astrokartoografii API
Grab a key and make your first call in under a minute.