Astrocartography API
Astrocartography prende un singolo momento di nascita e lo proietta su tutto il pianeta: invece di chiedere dove fossero i pianeti nel cielo, chiede dove sulla Terra ogni pianeta fosse angolare. L'endpoint restituisce la geometria della linea che tracci su una mappa mondiale per vedere quali longitudini attivano quale energia planetaria.
Astrocartography API
Dalla data di nascita, ora dell'orologio, offset UTC e coordinate di nascita, l'endpoint fissa il cielo esatto per quell'istante, poi scandisce il globo per trovare ogni meridiano e curva dove un pianeta si trovava su uno dei quattro angoli. Per ciascuno dei dieci pianeti più i nodi traccia quattro famiglie di linee: la linea ascendente dove il corpo era sull'Ascendente, la linea discendente sul Discendente, la linea culminante sul Medio Cielo e la linea anti-culminante sull'Imum Coeli. Le linee MC e IC corrono come meridiani puliti; le linee AC e DC si curvano in base alla latitudine, poiché un corpo che sorge a est a una latitudine sorge molto a nord o sud a un'altra. Tutto è restituito come geometria di linea serializzabile sotto data.lines, pronta per essere inserita direttamente in una libreria di mapping. Questa è la tecnica di relocazione popolarizzata da Jim Lewis come 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
Usa questo endpoint quando la posizione è la variabile e vuoi sapere come una carta si ri-esprime sulla mappa – per consigli di rilocalizzazione, viaggi e strumenti su dove vivere, o qualsiasi funzionalità che sovrappone la carta di una persona su un globo. È il backend naturale per una mappa interattiva: richiedi le linee una volta per un momento di nascita, renderizzale come polilinee e lascia che l'utente scorra i continenti per leggere quale pianeta governa quale corridoio. Poiché l'output è pura geometria invece di prosa, si integra facilmente con lo styling del tuo front-end, clustering e livelli click-to-interpret. Abbinalo alla chiamata natal-chart quando vuoi sia la struttura della carta natale sia le linee rilocalizzate fianco a fianco; le due condividono la stessa risoluzione di nascita, così le posizioni planetarie dietro la mappa coincidono esattamente.
Notes
Le posizioni provengono dalla Swiss Ephemeris (Astrodienst), lo stesso motore dietro gli endpoint natali, così le linee si ancorano alle stesse longitudini planetarie. L'angularità è calcolata nello zodiaco tropicale. La risposta contiene solo geometria – il disegno, la proiezione e lo styling della mappa mondiale sono lasciati al tuo client.
Try the Astrocartography API
Grab a key and make your first call in under a minute.