AstroWay/api v2.95.1 · de
alle Systeme in Ordnung
// astrology api · POST /v1/astrocartography

Astrocartography-API

Die Astrokartografie nimmt einen einzigen Geburtsmoment und projiziert ihn auf den gesamten Planeten: Statt zu fragen, wo die Planeten am Himmel standen, fragt sie, wo auf der Erde jeder Planet angulär war. Der Endpunkt gibt die Liniengeometrie zurück, die Sie auf einer Weltkarte einzeichnen, um zu sehen, welche Längengrade welche planetare Energie aktivieren.

Endpunkt
POST /v1/astrocartography
Kosten
50 Credits
Latenz
~76 ms
Stufe
Tier 3
// 01 / Was es berechnet

Astrocartography-API

Aus Geburtsdatum, Uhrzeit, UTC-Offset und Geburtskoordinaten fixiert der Endpunkt den exakten Himmel für diesen Augenblick und durchsucht dann den Globus, um jeden Meridian und jede Kurve zu finden, an der ein Planet auf einer der vier Achsen stand. Für jeden der zehn Planeten plus die Knoten zeichnet er vier Linienfamilien nach: die Aufgangslinie, wo der Körper auf dem Aszendenten stand, die Untergangslinie auf dem Deszendenten, die Kulminationslinie auf dem Medium Coeli und die Antikulminationslinie auf dem Imum Coeli. Die MC- und IC-Linien verlaufen als klare Meridiane; die AC- und DC-Linien biegen sich als breitenabhängige Kurven, da ein Körper, der bei einer Breite genau im Osten aufgeht, bei einer anderen weit im Norden oder Süden aufgeht. Alles wird als serialisierbare Liniengeometrie unter data.lines zurückgegeben, bereit, direkt in eine Kartenbibliothek eingespeist zu werden. Dies ist die von Jim Lewis als Astro*Carto*Graphy populär gemachte Relokationstechnik.

// 02 / Live-Anfrage

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

Parameter

nametypeErforderlich
date string (YYYY-MM-DD) ja Birth date.
time string (HH:MM:SS) ja Local clock time at birth.
timezoneOffset number (hours) ja UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones.
latitude number ja Birth-place latitude, decimal degrees (north positive).
longitude number ja Birth-place longitude, decimal degrees (east positive).
// 04 / Wann verwenden

Wann verwenden

Verwenden Sie diesen Endpunkt, wenn der Ort die Variable ist und Sie wissen möchten, wie sich ein Horoskop über die Karte hinweg neu ausdrückt — für Relokationsberatung, Reise- und Wohnort-Tools oder jede Funktion, die das Horoskop einer Person über einen Globus legt. Es ist das natürliche Backend für eine interaktive Karte: Fordern Sie die Linien einmal für einen Geburtsmoment an, rendern Sie sie als Polylinien und lassen Sie den Nutzer über die Kontinente schwenken, um abzulesen, welcher Planet welchen Korridor beherrscht. Da die Ausgabe reine Geometrie statt Prosa ist, fügt sie sich sauber in Ihr eigenes Frontend-Styling, Clustering und Klick-zum-Deuten-Schichten ein. Kombinieren Sie ihn mit dem natal-chart-Aufruf, wenn Sie sowohl die Heimhoroskop-Struktur als auch die relozierten Linien nebeneinander möchten; beide teilen dieselbe Geburtsauflösung, sodass die planetaren Positionen hinter der Karte exakt übereinstimmen.

// 05 / Hinweise

Hinweise

Die Positionen stammen aus der Swiss Ephemeris (Astrodienst), zu WASM kompiliert, derselben Engine hinter den natalen Endpunkten, sodass die Linien an den identischen planetaren Längen verankert sind. Die Angularität wird im tropischen Tierkreis berechnet. Die Antwort enthält nur Geometrie — Zeichnung, Projektion und Styling der Weltkarte bleiben Ihrem Client überlassen.

Astrokartografie-API ausprobieren

Hol dir einen Key und mach deinen ersten Aufruf in unter einer Minute.

99,9% SLA · kostenpflichtige Tarife · 30 Tage Status →