Local space astrology API
Local space chiede una domanda diversa dall'astrocartografia: non dove sulla Terra un pianeta era angolare, ma in quale direzione della bussola si trovava dal luogo di nascita. L'endpoint restituisce un'azimut e un'altitudine per ogni corpo, più il percorso del cerchio massimo che quella direzione traccia sul globo.
Local space astrology API
L'endpoint costruisce il tema natale, converte ogni pianeta dalle coordinate eclittiche nel sistema di riferimento dell'orizzonte del luogo di nascita e restituisce la sua azimut in gradi in senso orario rispetto al vero nord insieme alla sua altitudine sopra o sotto l'orizzonte. Poi proietta ogni azimut come un cerchio massimo dal luogo di nascita e restituisce il percorso risultante come una serie di coordinate, in modo che una linea tracciata su una mappa mondiale rimanga una vera bussola anziché una linea retta su una proiezione piana. Tredici corpi sono coperti, ognuno con un colore stabile in modo che una mappa renderizzata mantenga la stessa tavolozza del resto della suite. L'altitudine conta tanto quanto l'azimut qui: un pianeta sotto l'orizzonte alla nascita si interpreta diversamente da uno alto nel cielo nella stessa direzione.
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
Usa lo spazio locale quando il prodotto riguarda direzione e distanza da una casa fissa piuttosto che posizione assoluta sul globo. Due casi prevalgono. Il primo è il trasferimento a qualsiasi scala, dalla scelta di quale città si trova lungo una bearing favorevole a decidere come muoversi all'interno di un paese, perché un cerchio massimo dal luogo di nascita attraversa molto più territorio utilizzabile di poche linee di astrocartografia. Il secondo è il lavoro interno e sul sito, dove le stesse azimut vengono lette a scala stanza all'interno di un'abitazione: l'endpoint restituisce le bussola, e il companion /local-space/influence-zone trasforma una di esse in un poligono cono che puoi disegnare. Se già renderizzi l'astrocartografia, aggiungere lo spazio locale è il modo più economico per raddoppiare la profondità di una funzione di trasferimento, poiché usa lo stesso input di nascita e la stessa superficie di mappa.
Notes
Le posizioni provengono dalle Swiss Ephemeris (Astrodienst). L'azimut è misurato in senso orario rispetto al vero nord, non al nord magnetico, quindi nessuna correzione di declinazione viene applicata o necessaria. Il percorso del cerchio massimo viene restituito come coordinate campionate anziché come formula, il che mantiene il client libero da geometria sferica. La tecnica in questa forma è stata sviluppata da Michael Erlewine ed è documentata nel suo Astrophysical Directions.
Try the Local Space API
Grab a key and make your first call in under a minute.