Eclipse path, cosmogram en Vedic-kaarten: pure-SVG visualizers zonder headless-Chrome

De categorie Visualisatie op onze roadmap is gesloten (14/14): zes eindpunten sluiten specifieke lay-outs af, waarvoor geen npm-pakket beschikbaar is – Vedic-charts in drie regionale stijlen, Hamburg-School cosmogram, eclipsetraject op een wereldkaart en stereografische sterrenkaart.

Het sleutelbesluit: alle renders zijn pure SVG-strengen, zonder headless Chrome. Dit betekent subsecond respons, lage kosten per oproep en de mogelijkheid om inline te gebruiken in elke e-mail/PDF/web-documentatie.

De meeste publicatie-waardige astrologische afbeeldingen worden gemaakt met behulp van Chromium en een SVG-sjabloon – dit is normaal voor PDF-rapporten. De /v1/render/* eindpunten zijn echter gericht op programmatische rendering in real-time:

• inline in een React-dashboardcomponent
• inbedden in een e-mailcampagne
• doorgeven aan een LLM-agent voor multimodale analyse

Headless Chrome is niet geschikt – de RAM-kosten en latency maken het onmogelijk om dit 100 keer per uur voor een batch uit te voeren. Daarom zijn alle zes renderers puur string-builders die SVG-markering genereren via template-functies. De latency is onder de 100 ms, zelfs op een koude cache.

In de Indiase astrologie zijn er drie lay-outs voor de geboortekaart, elk met een culturele gewicht in hun regio:

De klassieke “diamant”-lay-out: huis 1 staat altijd bovenaan (vaste huizen), de tekenen draaien afhankelijk van de Lagna. Dit is populair in de meeste Hindi-mainstream consultaties.

curl -X POST https://api.astroway.info/v1/render/wheel-vedic-north \
  -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,
    "options": { "format": "svg" }
  }'

Je kunt een SVG-string (format: "svg") of een JSON-wrapping met { svg, byteLength } (format: "json", standaard) aanvragen.

Een vierkante grid van 4×4, de tekenen zijn vast (Vissen staat altijd boven links, de rest in de klokwijzerrichting), de huisnummers drijven mee met de Lagna. Dit is populair in Tamil Nadu, Kerala en Karnataka.

Een vierkant met diagonalen + een inwendig gedraaid vierkant – een hybride geometrie. De minst bekende van de drie in het Westen, maar verplicht voor Bengali-georiënteerde producten.

Alle drie nemen hetzelfde chart-payload aan – de endpoint wordt gekozen op basis van de visualisatiestijl.

POST /v1/render/cosmogram is geen geboortekaart. Het is een 90°-dial, waarbij alle harde aspecten (0°/90°/180°) samengevat worden in verbindingen. Dit instrument werd ontwikkeld door Alfred Witte (Witte 1928) en later formaliseerd door Reinhart Ebertin (Ebertin 1940) als basis voor cosmobiologie.

Waarom dit nuttig is: op een standaard 360°-kaart zijn harde aspecten “verspreid” over de cirkel en moeilijk te lezen. Op de 90°-dial worden ze visueel duidelijk – een cluster van 3-4 planeten in een 22.5°-sector is meteen zichtbaar.

curl -X POST https://api.astroway.info/v1/render/cosmogram \
  -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
  }'

Het retourneert een SVG met een vierkant van 4×22.5° (cardinale sectoren) + de posities van de planeten op één draai van 90°.

POST /v1/render/eclipse-path neemt een caller-supplied lat/lon track voor de centrale lijn van een verduistering en optioneel een bandbreedte in graden. De render is een equirectangulaire wereldkaart (standaardprojectie WGS-84) met graticule + pathlijn + band-overlay.

curl -X POST https://api.astroway.info/v1/render/eclipse-path \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "path": [
      { "latitude": 38.5, "longitude": -125.0, "time": "2026-08-12T17:30Z" },
      { "latitude": 41.2, "longitude": -105.3, "time": "2026-08-12T17:42Z" },
      { "latitude": 44.8, "longitude": -85.7, "time": "2026-08-12T17:54Z" }
    ],
    "bandWidthDeg": 1.2,
    "title": "Eclipse 2026-08-12",
    "options": { "width": 1200, "height": 600, "showGraticule": true, "pathColor": "#ff5500" }
  }'

De caller-supplied path is een bewuste designkeuze. Eclipsedata komt uit verschillende canonische bronnen (NASA Eclipse Catalog, Five Millennium Canon of Solar Eclipses van Espenak & Meeus), elk met hun eigen nauwkeurigheid. De endpoint probeert niet de NASA-berekening te repliceeren – hij render de track mooi. Als data source raden we de NASA Eclipse Web Site aan, maar dit valt buiten de scope van deze endpoint.

Use case. Een educatieve app die het volgende verduistering met een traject door de kaart laat zien. Of een astrologie-consult dat de “golf” van een verduistering wil visualiseren door belangrijke locaties voor de native.

POST /v1/render/star-map neemt een lijst met punten (RA/Dec) met optionele magnitude en glyph, en render een stereografische projectie. De magnitude wordt gemapt op de straal van het punt (helderdere ster = grotere cirkel).

curl -X POST https://api.astroway.info/v1/render/star-map \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "points": [
      { "raHours": 5.92, "decDeg": 7.41, "magnitude": 0.45, "name": "Betelgeuse" },
      { "raHours": 6.75, "decDeg": -16.72, "magnitude": -1.46, "name": "Sirius" },
      { "raHours": 5.24, "decDeg": -8.20, "magnitude": 0.18, "name": "Rigel" }
    ],
    "observerLatDeg": 50.45,
    "zenithDecDeg": 50.45,
    "capAltitudeDeg": -18,
    "title": "Sky at midnight, Kyiv"
  }'

Parameters:

• points: van 1 tot 2000 sterren/objecten
• observerLatDeg + zenithDecDeg: voor correcte projectie vanaf de waarnemer
• capAltitudeDeg: beperking van de hoogte (bijvoorbeeld -18 voor astronomische schemering)

Use case. Een sky-tonight-widget in een astrologie-app. Vedic geboortecontext met sterren-nakshatra’s, overlapt op echte coördinaten. Een educatief product met een sterrenbeeldkaart.

Als je een rasterformaat nodig hebt (voor sociale media, e-mail, push), gebruik dan de volgende pipeline:

import { Astroway } from "@astroway/sdk";
import sharp from "sharp";

const client = new Astroway({ apiKey: process.env.ASTROWAY_KEY });

const { svg } = await client.render.eclipsePath({
  path: eclipseTrack,
  bandWidthDeg: 1.2,
  options: { width: 1200, height: 600, format: "json" },
});

const png = await sharp(Buffer.from(svg))
  .resize(1200, 600)
  .png()
  .toBuffer();

// upload to CDN, get URL

SVG → PNG conversie met behulp van sharp voegt ongeveer 150 ms toe, wat nog steeds goedkoper is dan headless Chrome. Alternatief: laat het als SVG en voeg het inline toe in HTML via template-systems (Astro, Vue, React-component met directe output van de string via de juiste framework-mechanisme met pre-sanitizing).

De zes render-eindpunten van deze categorie vallen onder Tier 1: 10 kredieten per oproep. Het volledige tariefoverzicht vind je op Pricing.

De documentatie met volledige schema’s van parameters is te vinden in /docs/api/ → Render. Vedic-formaten, cosmogram, eclipsetraject en sterrenkaart – elk met voorbeelden van parameters en een SVG-response-screenshot.