Eclipse path, cosmogram és Vedic-térképek: pure-SVG visualizerek headless-Chrome nélkül

A Visualization kategória a roadmapunkon 14/14: hatvan végpont zárja le a specifikus layout-okat, amelyekre még nincs kész npm-csomag: három regionális stílusú Vedic-karták, Hamburg School cosmogram, világkárta éghajlati útvonala és stereografikus csillagkép.

Alapvető megoldás: mind a hat renderelés pure SVG-string, headless Chrome nélkül. Ez azt jelenti, hogy subsecond válaszidő, alacsony cost-per-call, és lehetőség inline-be bármely e-mail/PDF/web-dokumentumba.

A legtöbb publikációs minőségű asztrológiai kép Chromiummal készül SVG-sablonnal – ez normális PDF-jelentésekhez. De a /v1/render/* végpontok programos real-time-renderelésre tervezve vannak:

• inline React komponensbe dashboardban
• e-mail kampányba beágyazva
• multimodális analízisre LLM-ügyfélnek

A headless Chrome nem megfelelő – a RAM-cost és a latencia nem engedélyezi, hogy 100-szor/hó hívják egy partira. Ezért mind a hat renderelő tiszta string-builder, amely SVG-márványt ad ki template-függvényekkel. A latencia alig 100 ms, még hideg cache-nél is.

Az indiai asztrológiában három hagyományos layout létezik a natális kartákhoz, és mindennek van kulturális súlya a saját régiójában:

A klasszikus “diamond” layout: az 1. ház mindig a tetején (fix házak), a jelök forognak a Lagna szerint. Elterjedt a legtöbb hindi-mainstream tanácsadásban.

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" }
  }'

Kérheted SVG-stringet (format: "svg") vagy JSON-kötetet { svg, byteLength }-vel (format: "json", default).

Négyzetes 4×4 hálózat, a jelök fixek (Halak mindig felső bal sarokban, a többi óramutató járásával ellentétesen), a házszámok úszkálnak a Lagna szerint. Elterjedt Tamil Nadu, Kerala és Karnataka területén.

Négyzet diagonálokkal és belső forgatott négyzettel – hibrid geometria. A legkevésbé ismert a három közül Nyugaton, de kötelező a bengáli orientációjú termékekhez.

Mindhárom ugyanazt a chart-payload fogadja – a végpontot a vizualizációs stílus alapján választod.

A POST /v1/render/cosmogram nem natális kerek. Ez egy 90°-os dial, ahol az összes hard aspect (0°/90°/180°) összeomlik kapcsolatokba. Az eszközot Alfred Witte (Witte 1928) fejlesztette ki, és később formalizálta Reinhard Ebertin (Ebertin 1940) a cosmobiológia alapjaként.

Miért hasznos: a standard 360°-os kartán a szilárd aspektusok “elterjednek” a körön, nehéz olvasni a klasztereket. A 90°-os dialon viszont láthatóvá válnak – egy 3-4 bolygó tartalmazó 22.5°-os szektor klasztere azonnal látható.

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
  }'

Ad vissza SVG-t négyzetből 4×22.5° (kardinal szektorok) + bolygó pozíciókkal egy 90°-os körforgással.

A POST /v1/render/eclipse-path fogad caller-supplied lat/lon track-et a napfogyatkozás középső vonalára, és opcionálisan band-width-ot fokokban. A renderelés egy equirectangular világkárta (WGS-84 standard projekció) graticule-vel, útvonallal és band-overlay-vel.

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" }
  }'

A caller-supplied útvonala szándékos design choice. A napfogyatkozás adatai különböző kanonikus forrásokból érkeznek (NASA Eclipse Catalog, Five Millennium Canon of Solar Eclipses Espenak & Meeus-től), minden saját pontossággal. A végpont nem próbálja replikálni a NASA számításait – csak szépítik meg a track-et. Adatforrásként ajánljuk a NASA Eclipse Web Site-t, de ez a végpont skópusa kívül esik.

Használati eset. Oktatási alkalmazás, amely mutatja a következő napfogyatkozást a világkárta mentén. Vagy asztrológiai tanácsadás, amely vizualizálni szeretné a “hullám” napfogyatkozást a helyi jelentőségű helyeken keresztül.

A POST /v1/render/star-map fogad egy RA/Dec pontok listáját opcionális fényesség és glyph-vel, és stereografikus projekciót renderel. A fényesség a pont sugárához mapolódik (világosabb csillag = nagyobb kör).

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"
  }'

Paraméterek:

• points: 1-től 2000 csillag/objektumig
• observerLatDeg + zenithDecDeg: a megfigyelő pozíciójának helyes projekciója
• capAltitudeDeg: magasság korlátozása (például -18 az asztrofizikai homályhoz)

Használati eset. Az asztrológiai alkalmazás “ma esti égbolt” widgetje. Vedic natális kontextus csillagokkal, amelyek a Nakszatra csillagoknak felelnek meg, a valódi koordinátákra ráhelyezve. Oktatási termék csillagképével.

Ha raster szükséges (szociális média, e-mail, push), a 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

Az SVG → PNG konverzió sharp-nel ~150 ms-t vesz igénybe, ami még mindig olcsóbb, mint a headless Chrome. Alternatívként hagyhatod SVG-nak és beágyazhatod inline HTML-be template-rendszerek segítségével (Astro, Vue, React komponens közvetlen string-kimenetével a megfelelő keretrendszer mechanizmusával, előzetes szanitizációval).

Mind a hat renderelés végpontja Tier 1: 10 kredit hívásra. Teljes árazási táblázat a Pricing-on. A teljes dokumentáció a paraméter-schemákkal a /docs/api/ → Render oldalon. Vedic-formátumok, cosmogram, eclipse-path és star-map mindkettő példával a paraméterekkel és SVG válaszlemezekkel.