Eclipse path, cosmogram y cartas Vedic: pure-SVG visualizadores sin headless-Chrome

La categoría Visualization en nuestra hoja de ruta está completa 14/14: los seis endpoints finales cubren diseños específicos para los que no existe un paquete npm listo para usar: cartas védicas en tres estilos regionales, cosmograma de la Escuela de Hamburgo, ruta de eclipse en un mapa mundial y mapa estelar estereográfico.

Decisión clave: todos los renders son cadenas SVG puras, sin headless Chrome. Esto significa una respuesta en subsegundos, un bajo coste por llamada y la posibilidad de incrustarlos en cualquier documento de correo electrónico/PDF/web.

La mayoría de las imágenes astrológicas de calidad para publicación se crean a través de Chromium con una plantilla SVG, lo cual es normal para los informes en PDF. Sin embargo, los endpoints /v1/render/* están orientados a la renderización programática en tiempo real:

• incrustación en un componente React de un panel de control
• inserción en una campaña de correo electrónico
• transferencia a un agente LLM para análisis multimodal

Headless Chrome no es adecuado: el coste de RAM y la latencia no permiten llamarlo 100 veces/minuto para un solo lote. Por lo tanto, los seis renderizadores son constructores de cadenas puros que emiten marcado SVG a través de funciones de plantilla. La latencia es inferior a 100 ms incluso con la caché fría.

En la astrología india, la tradición conoce tres diseños de cartas natales, y cada uno tiene un peso cultural en su región:

El diseño clásico de “diamante”: la casa 1 siempre está arriba (casas fijas), los signos rotan dependiendo del Lagna. Común en la mayoría de las consultas hindi convencionales.

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

Puedes solicitar una cadena SVG (format: "svg") o un envoltorio JSON con { svg, byteLength } (format: "json", por defecto).

Una cuadrícula cuadrada de 4×4, los signos fijos (Piscis siempre arriba a la izquierda, los demás en el sentido de las agujas del reloj), los números de las casas flotan según el Lagna. Común en Tamil Nadu, Kerala, Karnataka.

Un cuadrado con diagonales + un cuadrado interior rotado: una geometría híbrida. La menos conocida de las tres en Occidente, pero obligatoria para los productos con orientación bengalí.

Los tres aceptan el mismo payload de carta; el endpoint se elige según el estilo de visualización.

POST /v1/render/cosmogram no es una carta natal. Es un dial de 90° donde todos los aspectos duros (0°/90°/180°) colapsan en una conjunción. Una herramienta desarrollada por Alfred Witte (Witte 1928) y posteriormente formalizada por Reinhold Ebertin (Ebertin 1940) como base de la cosmobiología.

Por qué es útil: en una carta estándar de 360°, los aspectos duros están “dispersos” alrededor del círculo, lo que dificulta la lectura de los cúmulos. En un dial de 90°, se vuelven visualmente obvios: un cúmulo de 3-4 planetas en un sector de 22.5° se ve de inmediato.

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

Devuelve un SVG con un cuadrado de 4×22.5° (sectores cardinales) + las posiciones de los planetas en una rotación de 90°.

POST /v1/render/eclipse-path acepta una trayectoria de latitud/longitud proporcionada por el llamador para la línea de centralidad del eclipse y, opcionalmente, un ancho de banda en grados. El renderizado es un mapa mundial equirrectangular (proyección estándar WGS-84) con retícula + línea de trayectoria + superposición de banda.

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

La trayectoria proporcionada por el llamador es una elección de diseño intencionada. Los datos de la trayectoria del eclipse provienen de varias fuentes canónicas (NASA Eclipse Catalog, Five Millennium Canon of Solar Eclipses de Espenak & Meeus), cada una con su propia precisión. El endpoint no intenta replicar el cálculo de la NASA, sino que renderiza tu trayectoria de forma atractiva. Como fuente de datos, recomendamos el sitio web de eclipses de la NASA, pero esto está fuera del alcance de este endpoint.

Caso de uso. Una aplicación educativa que muestra el próximo eclipse con su trayectoria en un mapa. O una consulta astrológica que desea visualizar la “onda” del eclipse a través de ubicaciones importantes para el nativo.

POST /v1/render/star-map acepta una lista de puntos (RA/Dec) con magnitud y glifo opcionales, y renderiza una proyección estereográfica. La magnitud se mapea al radio del punto (estrella más brillante = círculo más grande).

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

Parámetros:

• points: de 1 a 2000 estrellas/objetos
• observerLatDeg + zenithDecDeg: para una proyección correcta desde el punto del observador
• capAltitudeDeg: límite de altitud (por ejemplo, -18 para el crepúsculo astronómico)

Caso de uso. Un widget “Cielo esta noche” en una aplicación de astrología. Contexto natal védico con estrellas Nakshatra superpuestas en coordenadas reales. Un producto educativo con un mapa de constelaciones.

Si necesitas un ráster (para redes sociales, correo electrónico, notificaciones push), el pipeline es:

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

La conversión de SVG a PNG a través de sharp añade ~150 ms, lo que sigue siendo más barato que headless Chrome. Alternativamente, déjalo como SVG e insértalo en línea en HTML a través de sistemas de plantillas (Astro, Vue, componente React con salida directa de la cadena a través del mecanismo apropiado del framework con pre-sanitización).

Los seis endpoints de renderizado de este lote son de Nivel 1: 10 créditos por llamada. La tabla completa de tarifas está en Precios.

La documentación con esquemas completos de parámetros está en /docs/api/ → Render. Los formatos védicos, el cosmograma, la ruta de eclipse y el mapa estelar, cada uno con un ejemplo de parámetros y un SVG de respuesta.