Astrocartography API
Astrocartography vezme jediný okamžik narození a promítne ho na celou planetu: místo toho, abys se ptal, kde byly planety na obloze, ptá se, kde na Zemi byla každá planeta úhlová. endpoint vrací geometrii čar, kterou nakreslíš na světovou mapu, abys viděl, které délky aktivují kterou planetární energii.
Astrocartography API
Z data narození, času, UTC offsetu a souřadnic narození endpoint určí přesnou oblohu pro ten okamžik, pak projde zeměkouli a najde každé poledníky a křivky, kde planeta stála v jednom ze čtyř úhlů. Pro každou z deseti planet plus uzly vykreslí čtyři typy čar: vzestupnou čáru, kde těleso bylo na Ascendentu, sestupnou čáru na Descendentu, kulminační čáru na Midheavenu a anti-kulminační čáru na Imum Coeli. MC a IC čáry jsou rovné poledníky; AC a DC čáry se ohýbají jako křivky závislé na zeměpisné šířce, protože těleso, které vychází přímo na východ na jedné šířce, vychází daleko na sever nebo jih na jiné. Všechno je vráceno jako serialisable line geometry pod data.lines, připravené k přímému vložení do mapovací knihovny. To je relokační technika popularizovaná Jimem Lewisem jako Astro*Carto*Graphy.
POST/v1/astrocartography
curl -X POST https://api.astroway.info/v1/astrocartography \
-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": {
"lines": [
{
"planet": "Venus",
"type": "MC",
"longitude": 14.2
},
{
"planet": "Jupiter",
"type": "AC",
"points": [
"…"
]
}
]
}
}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žij tento endpoint, když je místo proměnnou a chceš vědět, jak se horoskop přenese po mapě – pro rady ohledně přestěhování, cestování a kde-žít nástroje, nebo jakoukoli funkci, která překryje něčí horoskop na globus. Je to přirozené backendové řešení pro interaktivní mapu: požádáš jednou o čáry pro okamžik narození, vykreslíš je jako polylines a necháš uživatele posouvat se po kontinentech a číst, která planeta řídí který koridor. Protože výstup je čistá geometrie, ne text, dobře se kombinuje s tvým front-end stylingem, clusteringem a vrstvami click-to-interpret. Spoj to s voláním natal-chart, když chceš mít vedle sebe strukturu domovského horoskopu i přemístěné čáry; oba mají stejnou rozlišení narození, takže planetární pozice za mapou jsou přesně shodné.
Notes
Poloha pochází ze Swiss Ephemeris (Astrodienst), stejného enginu za natal endpoints, takže čáry jsou ukotveny na identických planetárních délkách. Úhlovost se počítá v tropickém zvěrokruhu. Odpověď obsahuje jen geometrii – kreslení, projekci a styling světové mapy necháš na svém klientovi.
Try the Astrocartography API
Grab a key and make your first call in under a minute.