API-ul de astrologie Local Space
Spațiul local pune o întrebare diferită față de astrocartografie: nu unde pe Pământ era un planet în poziție angulară, ci în ce direcție a busolă se afla față de locul nașterii. Endpoint-ul returnează un azimut și o altitudine pentru fiecare corp, plus calea de cerc mare pe care o trasează acea direcție pe glob.
API-ul de astrologie Local Space
Endpoint-ul construiește harta natală, convertește fiecare planetă din coordonate ecliptice în cadrul orizontului locului de naștere și returnează azimutul său în grade în sensul acelor de ceasornic de la nordul adevărat împreună cu altitudinea sa deasupra sau dedesubtul orizontului. Apoi proiectează fiecare azimut ca un cerc mare în exteriorul locului de naștere și returnează calea rezultată ca o serie de coordonate, astfel încât o linie trasată pe o hartă mondială rămâne o adevărată direcție de orientare în loc de o linie dreaptă pe o proiecție plată. Treisprezece corpuri sunt acoperite, fiecare având o culoare stabilă, astfel încât o hartă randată păstrează aceeași paletă ca restul suitei. Aici altitudinea este la fel de importantă ca azimutul: un planet sub orizont la naștere se citește diferit de unul înalt în cer în aceeași direcție.
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
Folosește spațiul local când produsul se referă la direcție și distanță față de o casă fixă, nu la poziția absolută pe glob. Două cazuri predomină. Primul este relocarea la orice scară, de la alegerea orașului care se află pe o direcție favorabilă până la decizia în ce direcție să te muți într-o singură țară, deoarece un cerc mare de la locul nașterii traversează mult mai mult teritoriu utilizabil decât câteva meridiane de astrocartografie. Al doilea este lucrul interior și pe șantier, unde aceleași azimute se citesc la scară de cameră în interiorul unei locuințe: endpoint-ul returnează direcțiile, iar companion-ul /local-space/influence-zone transformă una dintre ele într-un poligon conic pe care îl poți desena. Dacă deja randezi astrocartografie, adăugarea spațiului local este cea mai ieftină modalitate de a duba adâncimea unei funcții de relocare, deoarece folosește aceeași intrare de naștere și aceeași suprafață de hartă.
Notes
Pozițiile provin din Swiss Ephemeris (Astrodienst) compilat în WASM. Azimutul se măsoară în sensul acelor de ceasornic de la nordul adevărat, nu de la nordul magnetic, deci nicio corecție de declinație nu se aplică sau este necesară. Calea de cerc mare este returnată ca coordonate eșantionate, nu ca formulă, ceea ce menține clientul liber de geometrie sferică. Tehnica în această formă a fost dezvoltată de Michael Erlewine și este documentată în lucrarea sa Astrophysical Directions.
Try the Local Space API
Grab a key and make your first call in under a minute.