Local Space astrologické API
Local Space se ptá jiné otázky než astrocartografie: ne kde na Zemi byl planet úhlový, ale kterým směrem byl od místa narození. Endpoint vrací azimuth a altitude pro každé těleso, plus great-circle path, který ten směr opisuje po celé planetě.
Local Space astrologické API
Endpoint vytváří natal chart, převádí každou planetu z ekliptických souřadnic do horizontálního rámce místa narození a vrací její azimuth ve stupních po směru hodinových ručiček od pravého severu spolu s její altitude nad nebo pod horizontem. Pak projekuje každý azimuth jako great circle od místa narození a vrací vzniklou dráhu jako sérii souřadnic, takže čára nakreslená na světové mapě zůstává pravým směrem místo přímky na ploché projekci. Pokrývá třináct těles, každé má stabilní barvu, takže vykreslená mapa zachovává stejnou paletu jako zbytek sady. Altitude je zde stejně důležitá jako azimuth: planet pod horizontem při narození se čte jinak než ten vysoko na nebi ve stejném směru.
POST/v1/local-space
curl -X POST https://api.astroway.info/v1/local-space \
-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": {
"birthplace": { "latitude": 50.45, "longitude": 30.52 },
"count": 13,
"lines": [
{
"planetId": 0,
"planetName": "Sun",
"azimuth": 219.8018,
"altitude": 53.1309,
"color": "#FFB300",
"points": [{ "lat": 50.45, "lng": 30.52 }, "…"]
}
]
}
}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. Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). Local space is anchored here, so this is not optional. |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
When to use it
Použij local space, když je produkt o směru a vzdálenosti od pevného domova místo o absolutní pozici na globu. Dva případy převládají. První je přemístění v jakémkoli měřítku, od výběru města ležícího pod výhodným směrem až po rozhodnutí, kam se přesunout v rámci jedné země, protože great circle od místa narození prochází mnohem více využitelného území než pár astrocartography meridiánů. Druhý je interiér a terénní práce, kde se stejné azimuthy čtou v místnostním měřítku uvnitř obydlí: endpoint vrací směry a companion /local-space/influence-zone z nich udělá kuželový polygon, který můžeš nakreslit. Pokud už renderuješ astrocartography, přidání local space je nejlevnější způsob, jak zdvojnásobit hloubku funkce přemístění, protože používá stejné vstupy narození a stejný povrch mapy.
Notes
Pozice pochází ze Swiss Ephemeris (Astrodienst) zkompilovaného do WASM. Azimuth se měří po směru hodinových ručiček od pravého severu, ne od magnetického severu, takže žádná korekce deklinace se neaplikuje ani nevyžaduje. Great-circle path se vrací jako vzorkované souřadnice místo jako vzorec, což udržuje klienta bez sférické geometrie. Technika v této podobě byla vyvinuta Michaelem Erlewine a je zdokumentována v jeho Astrophysical Directions.
Try the Local Space API
Grab a key and make your first call in under a minute.