Eclipse path, cosmogram și Vedic-hărți: pure-SVG vizualizatoare fără headless-Chrome

Categoria Visualization de pe roadmap-ul nostru este închisă 14/14: șase endpoint-uri finale acoperă layout-uri specifice pentru care nu există un pachet npm gata făcut - hărți vedice în trei stiluri regionale, cosmograma Hamburg-School, eclipse-path pe o hartă mondială și o hartă stelară stereografică.

Decizia cheie: toate randările sunt string-uri SVG pure, fără headless Chrome. Aceasta înseamnă răspuns sub o secundă, cost redus per apel și posibilitatea de a le include inline în orice document de email/PDF/web.

Majoritatea imaginilor astrologice de calitate pentru publicații sunt create prin Chromium cu un șablon SVG – acest lucru este normal pentru rapoartele PDF. Însă endpoint-urile /v1/render/* sunt orientate către randarea programatică în timp real:

• inline într-o componentă React de dashboard
• embed într-o campanie de email
• transmitere către un agent LLM pentru analiză multimodală

Headless Chrome nu este potrivit – costul RAM și latența nu permit apelarea sa de 100 de ori/minut pentru un singur lot. Prin urmare, toate cele șase randere sunt un string-builder pur, care emite marcajul SVG prin funcții template. Latența este sub 100ms chiar și pe un cache rece.

În tradiția astrologiei indiene, există trei layout-uri pentru harta natală, și fiecare are o greutate culturală în regiunea sa:

Layout-ul clasic “diamond”: casa 1 este întotdeauna sus (houses fixe), semnele se rotesc în funcție de Lagna. Răspândit în majoritatea consultațiilor hindi-mainstream.

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

Poți solicita un string SVG (format: "svg") sau un wrapper JSON cu { svg, byteLength } (format: "json", implicit).

Grilă pătrată 4×4, semnele sunt fixe (Peștii întotdeauna sus-stânga, celelalte în sens orar), numerele caselor plutesc în funcție de Lagna. Răspândit în Tamil Nadu, Kerala, Karnataka.

Pătrat cu diagonale + un pătrat interior rotit – geometrie hibridă. Cel mai puțin cunoscut dintre cele trei în Occident, dar obligatoriu pentru produsele cu orientare Bengali.

Toate trei acceptă același chart-payload – endpoint-ul este ales în funcție de stilul de vizualizare.

POST /v1/render/cosmogram – acesta nu este un cerc natal. Este un cadran de 90°, unde toate aspectele dure (0°/90°/180°) se colapsează într-o conjuncție. Instrumentul a fost dezvoltat de Alfred Witte (Witte 1928) și ulterior formalizat de Reinhold Ebertin (Ebertin 1940) ca bază a cosmobiologiei.

De ce este util: pe o hartă standard de 360°, aspectele dure sunt “împrăștiate” pe cerc, fiind dificil de citit clusterele. Pe un cadran de 90°, acestea devin vizual evidente – un cluster de 3-4 planete într-un singur sector de 22.5° este vizibil imediat.

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

Va returna un SVG cu un pătrat de 4×22.5° (cardinal sectors) + pozițiile planetelor pe o singură rotație de 90°.

POST /v1/render/eclipse-path acceptă un traseu lat/lon furnizat de apelant pentru linia de centralitate a eclipsei și, opțional, lățimea benzii în grade. Randarea este o hartă mondială echirectangulară (proiecție standard WGS-84) cu graticule + linie de traseu + suprapunere de bandă.

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

Traseul furnizat de apelant este o alegere de design intenționată. Datele despre calea eclipsei provin din diverse surse canonice (NASA Eclipse Catalog, Five Millennium Canon of Solar Eclipses de Espenak & Meeus), fiecare cu propria precizie. Endpoint-ul nu încearcă să replice calculul NASA – el randează frumos traseul tău. Ca sursă de date, recomandăm NASA Eclipse Web Site, dar acest lucru este în afara scopului acestui endpoint.

Caz de utilizare. O aplicație educațională care arată următoarea eclipsă cu traseul pe hartă. Sau o consultație astrologică care dorește să vizualizeze “valul” eclipsei prin locații importante pentru nativ.

POST /v1/render/star-map acceptă o listă de puncte (RA/Dec) cu magnitudine și glifă opționale, randează o proiecție stereografică. Magnitudinea este mapată la raza punctului (stea mai strălucitoare = cerc mai mare).

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

Parametri:

• points: de la 1 la 2000 de stele/obiecte
• observerLatDeg + zenithDecDeg: pentru o proiecție corectă din punctul observatorului
• capAltitudeDeg: limită de altitudine (de exemplu, -18 pentru amurgul astronomic)

Caz de utilizare. Widget “Cerul de azi” într-o aplicație de astrologie. Context natal vedic cu stele-nakshatra suprapuse pe coordonate reale. Produs educațional cu o hartă a constelațiilor.

Dacă ai nevoie de raster (pentru rețele sociale, email, push), pipeline-ul este:

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

Conversia SVG → PNG prin sharp adaugă ~150ms, ceea ce este oricum mai ieftin decât headless Chrome. Alternativ – lasă-l ca SVG și inserează-l inline în HTML prin sisteme de template (Astro, Vue, componentă React cu ieșire directă a string-ului prin mecanismul corespunzător al framework-ului cu pre-sanitizare).

Toate cele șase endpoint-uri de randare din acest lot – Tier 1: 10 credite per apel. Tabelul complet de tarife – pe Prețuri.

Documentația cu scheme complete de parametri – în /docs/api/ → Render. Formatele vedice, cosmograma, calea eclipsei și harta stelară – fiecare cu un exemplu de parametri și SVG-ul de răspuns.