AstroWay/api v2.201.6 · it
tutti i sistemi sono operativi
// astrology api · POST /v1/astrocartography

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.

Endpoint
POST /v1/astrocartography
Cost
50 credits
Latency
~76 ms
Tier
Tier 3
// 01 / What it computes

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.

// 02 / Live request

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
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "lines": [
      {
        "planet": "Venus",
        "type": "MC",
        "longitude": 14.2
      },
      {
        "planet": "Jupiter",
        "type": "AC",
        "points": [
          "…"
        ]
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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).
// 04 / When to use it

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.

// 05 / Notes

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.

99.9% SLA · piani a pagamento · 30d stato →