Zum Inhalt springen
AstroWay/api v2.356.2 · de
alle Systeme in Ordnung

SVG-Kartenbilder

Last updated Als Markdown öffnen Agenten-Setup

/v1/render/* gibt eine Karte als fertiges SVG zurück: Geburtshoroskop, Bi- und Tri-Radix, Komposit, vedische Horoskope (Nord-, Süd-, Ost-Stil), Aspektgitter, Kosmogramm, Mondphase, Zeitleiste, Biorhythmen, Finsternisband und Sternenkarte. Du sendest die Geburtsdaten, wir berechnen die Karte und zeichnen sie. Eine vollständige Liste der Routen und Parameter findest du in der API-Referenz.

Derselbe Zeichencode ist als npm-Paket @astroway/render veröffentlicht: Wenn du die Kartendaten bereits hast, kann das Rad im Browser oder auf deinem eigenen Server gezeichnet werden, und es wird Byte für Byte mit dem übereinstimmen, was die API zurückgibt. Die API gibt die Zeichenversion im X-Render-Version-Header zurück.

Terminal-Fenster
curl -X POST https://api.astroway.info/v1/render/wheel-western \
-H "X-Api-Key: $ASTROWAY_KEY" -H "Content-Type: application/json" \
-d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":3,"latitude":50.45,"longitude":30.52,
"options":{"theme":"css","format":"svg"}}' > wheel.svg

format: "svg" gibt die Datei selbst zurück, das typische json verpackt den SVG-String in eine normale API-Antwort. Themen: light, dark, console und css.

Mit theme: "css" wird jede Farbe im SVG als CSS-Variable mit der Farbe des hellen Themes als Fallback gespeichert, zum Beispiel var(--aw-ring, #222). Füge das SVG in den HTML-Code der Seite ein (nicht in <img>: dort werden Variablen nicht verarbeitet) und definiere die Variablen:

.chart {
--aw-chart-bg: transparent;
--aw-ring: #444;
--aw-fg: currentColor;
--aw-aspect-tense: crimson;
}

Ohne eine einzige Variable sieht die Karte genau wie light aus. Die CSS-Regel deiner Seite ist stärker als die Variable, sodass ein einzelnes Element mit einer Klasse neu eingefärbt werden kann.

VariableWas gefärbt wird
--aw-chart-bgKartenhintergrund
--aw-fg, --aw-mutedGlyphen und Beschriftungen, sekundärer Text und Teilstriche
--aw-ringKreise und Gitterlinien
--aw-houses-fillFeld der vedischen Karte, Scheibe der Sternenkarte, Finsterniskarte
--aw-beneficPlaneten des äußeren Kreises, Lagna in der vedischen Karte, Timeline-Ereignisse ohne eigene Farbe
--aw-maleficZeichen der Rückläufigkeit ℞, Finsternisband
--aw-aspect-harmonious, --aw-aspect-tense, --aw-aspect-neutral, --aw-aspect-minor, --aw-aspect-quintileAspektlinien und -symbole
--aw-moon-shadow, --aw-moon-lightMondphase
--aw-cycle-physical, --aw-cycle-emotional, --aw-cycle-intellectualBiorhythmen

Im css-Theme haben westliche Räder (wheel-western, bi-wheel, tri-wheel, composite) und das Aspektgitter feste Klassen. Die Namen werden nur hinzugefügt, niemals umbenannt, sodass du Stile und Skripte darauf schreiben kannst.

  • Rad: aw-bg, aw-ring, aw-sign aw-sign-leo, aw-sign-line, aw-tick, aw-house-cusp, aw-house-number, Achsen aw-axis aw-asc (aw-dsc, aw-mc, aw-ic), deren Beschriftungen aw-label aw-axis-label, Titel aw-title.
  • Planet: Gruppe <g class="aw-planet aw-planet-sun">, rückläufige Planeten haben zusätzlich aw-retrograde, Planeten des äußeren Kreises aw-layer-1. Im Inneren aw-glyph, aw-retro (Zeichen ℞) und aw-planet-tick.
  • Aspekt: Linie aw-aspect aw-aspect-trine, eine Linie zwischen zwei Karten zusätzlich aw-cross-aspect.
  • Aspektgitter: aw-grid-header, aw-grid-cell, aw-aspect aw-aspect-square, aw-orb.

Die Planetengruppe hat data-planet (sun, north-node, lilith; auf dem äußeren Kreis b-sun, auf dem dritten c-sun) und data-label mit Name und Position: Mercury 8°00' Taurus, retrograde. Die Aspektlinie und die Gitterzelle haben data-a und data-b. So werden alle Aspekte eines Planeten beim Hovern hervorgehoben:

svg.querySelectorAll('.aw-planet').forEach((g) => g.addEventListener('mouseenter', () => {
const id = g.dataset.planet;
svg.querySelectorAll('.aw-aspect').forEach((line) =>
line.classList.toggle('is-on', line.dataset.a === id || line.dataset.b === id));
}));

Westliche Räder akzeptieren options.labels: deine Wörter für Achsenbeschriftungen, für <title> und <desc>, die von Screenreadern gelesen werden, und für Namen in data-label. Schlüssel, die nicht vorhanden sind, bleiben auf Englisch; wir übersetzen selbst nichts.

"options": {
"theme": "css",
"labels": {
"asc": "Асц", "mc": "МС", "title": "Натальна карта",
"bodies": { "Sun": "Сонце", "Moon": "Місяць" },
"signs": ["Овен","Телець","Близнюки","Рак","Лев","Діва","Терези","Скорпіон","Стрілець","Козеріг","Водолій","Риби"],
"retrograde": "ретроградний"
}
}

bodies hat englische Schlüssel (Sun, North Node), signs sind genau zwölf Namen, beginnend mit Widder, jede Beschriftung bis zu 40 Zeichen.

/v1/render/bi-wheel mit options.crossAspects: true zeichnet gestrichelte Aspekte zwischen der inneren und äußeren Karte, denselben Satz, den POST /v1/synastry als crossAspects zurückgibt. Ein Paar, bei dem einer der Körper nicht gezeichnet ist, wird übersprungen. Standardmäßig deaktiviert.

Wenn du die Karte bereits hast, weil du gerade POST /v1/chart aufgerufen hast, sende ihre data im Feld chart anstelle der Geburtsdaten, und wir werden sie nur zeichnen. So funktionieren wheel-western, aspect-grid und bi-wheel (dort natal.chart und outer.chart, beide müssen fertige Karten sein). Das Bild wird Byte für Byte dasselbe sein wie mit den Geburtsdaten.

{ "chart": { "planets": [ ... ], "houses": { "cusps": [ ... ], "ascendant": 7.77, "mc": 277.12 }, "aspects": [ ... ] },
"options": { "theme": "css" } }

Überflüssige Felder der Antwort müssen nicht entfernt werden. Es wird überprüft, was gezeichnet wird: 1 bis 30 Körper, Längengrade von 0 bis 360, genau 12 Häuserspitzen. Ein Körper, bei dem sowohl chart als auch Geburtsdaten vorhanden sind, wird mit 400 abgelehnt.

Ein Render-Aufruf mit Geburtsdaten kostet 10 Credits, da die Karte berechnet wird.

/v1/render/vastu kostet 20 Credits.

Mit einer fertigen Karte chart kosten die Aufrufe /v1/render/wheel-western, /v1/render/aspect-grid und /v1/render/bi-wheel 1 Credit. Theme, Klassen und Beschriftungen beeinflussen den Preis nicht.