AstroWay/api v2.201.6 · ro
toate sistemele sunt în stare normală
// astrology api · POST /v1/astrocartography

Astrocartografie API

Astrocartografia ia un singur moment de naștere și îl proiectează pe întreaga planetă: în loc să întrebi unde erau planetele în cer, întreabă unde pe Pământ fiecare planetă era angulară. Endpoint-ul returnează geometria de linii pe care o plasezi pe o hartă mondială ca să vezi ce longitudini activează ce energie planetară.

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

Astrocartografie API

Din data nașterii, ora, offset-ul UTC și coordonatele de naștere, endpoint-ul fixează cerul exact pentru acel moment, apoi parcurge globul pentru a găsi fiecare meridian și curbă unde o planetă se afla pe una dintre cele patru unghiuri. Pentru fiecare dintre cele zece planete plus noduri, trasează patru familii de linii: linia de răsărit unde corpul era pe Ascendent, linia de apus pe Descendent, linia culminantă pe Midheaven și linia anti-culminantă pe Imum Coeli. Liniile MC și IC rulează ca meridiane drepte; liniile AC și DC se curbează în funcție de latitudine, deoarece un corp care răsare direct est la o latitudine apare mult mai la nord sau sud la alta. Totul este returnat ca geometrie serializabilă sub data.lines, gata să fie introdus direct într-o bibliotecă de cartografiere. Aceasta este tehnica de relocare popularizată de Jim Lewis ca 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

Folosește acest endpoint când locația e variabila și vrei să știi cum se reexprima o hartă pe hartă – pentru sfaturi de relocare, călătorii și unelte de unde să locuiești, sau orice funcție care suprapune harta unei persoane pe un glob. E backend-ul natural pentru o hartă interactivă: cere liniile o singură dată pentru momentul nașterii, redă-le ca polilinii și lasă utilizatorul să navigheze pe continente pentru a vedea ce planetă guvernează ce coridor. Pentru că rezultatul e geometrie pură, nu proză, se integrează ușor cu stilurile tale de front-end, gruparea și straturile click-to-interpret. Asociază-l cu apelul natal-chart când vrei atât structura hărții de acasă, cât și liniile relocate alăturate; ambele au aceeași rezoluție a nașterii, așa că pozițiile planetare din spatele hărții coincid exact.

// 05 / Notes

Notes

Pozițiile vin din Swiss Ephemeris (Astrodienst), același motor din spatele natal endpoints, așa că liniile se ancorează la longitudinile planetare identice. Angularitatea se calculează în zodiacul tropical. Răspunsul conține doar geometrie – desenul, proiecția și stilizarea hărții mondiale rămân la clientul tău.

Try the Astrocartografie API

Grab a key and make your first call in under a minute.

99,9% SLA · planuri plătite · 30 zile status →