Eclipse path, cosmogram और Vedic-मानचित्र: pure-SVG विज़ुअलाइज़र बिना headless-Chrome

हमारी रोडमैप पर Visualization श्रेणी 14/14 पूरी हो चुकी है: छह अंतिम एंडपॉइंट विशिष्ट लेआउट को कवर करते हैं जिनके लिए कोई तैयार npm पैकेज नहीं है - तीन क्षेत्रीय शैलियों में वैदिक चार्ट, हैम्बर्ग-स्कूल कॉस्मोग्राम, विश्व मानचित्र पर ग्रहण-पथ और स्टीरियोग्राफिक स्टार-मैप।

मुख्य निर्णय: सभी रेंडर शुद्ध SVG-स्ट्रिंग हैं, बिना हेडलेस क्रोम के। इसका मतलब है सब-सेकंड रिस्पॉन्स, प्रति-कॉल कम लागत, और किसी भी ईमेल/पीडीएफ/वेब-दस्तावेज़ में इनलाइन करने की क्षमता।

अधिकांश प्रकाशन-गुणवत्ता वाली ज्योतिष-छवियां क्रोमियम के माध्यम से SVG-टेम्प्लेट के साथ बनाई जाती हैं - यह पीडीएफ रिपोर्टों के लिए सामान्य है। लेकिन /v1/render/* एंडपॉइंट रियल-टाइम में प्रोग्रामेटिक रेंडर पर केंद्रित हैं:

• डैशबोर्ड React-कंपोनेंट में इनलाइन
• ईमेल-अभियान में एम्बेड करें
• मल्टीमॉडल विश्लेषण के लिए LLM-एजेंट को पास करना

हेडलेस क्रोम उपयुक्त नहीं है - RAM-लागत और लेटेंसी इसे प्रति बैच 100 बार/मिनट कॉल करने की अनुमति नहीं देते हैं। इसलिए, सभी छह रेंडरर एक शुद्ध स्ट्रिंग-बिल्डर हैं जो टेम्प्लेट-फ़ंक्शंस के माध्यम से SVG-मार्कअप उत्सर्जित करते हैं। कोल्ड कैश पर भी लेटेंसी 100ms से कम है।

भारतीय-ज्योतिष परंपरा में जन्म कुंडली के तीन लेआउट ज्ञात हैं, और प्रत्येक का अपने क्षेत्र में सांस्कृतिक महत्व है:

क्लासिक “डायमंड” लेआउट: पहला घर हमेशा ऊपर होता है (निश्चित भाव), लग्न के आधार पर राशियाँ घूमती हैं। अधिकांश हिंदी-मुख्यधारा की परामर्शों में प्रचलित है।

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

तुम SVG-स्ट्रिंग (format: "svg") या { svg, byteLength } के साथ JSON-रैपर (format: "json", डिफ़ॉल्ट) का अनुरोध कर सकते हो।

4×4 की वर्गाकार ग्रिड, राशियाँ निश्चित होती हैं (मीन हमेशा ऊपर-बाएँ, अन्य दक्षिणावर्त), भाव संख्याएँ लग्न के अनुसार बदलती हैं। तमिलनाडु, केरल, कर्नाटक में प्रचलित है।

विकर्णों वाला वर्ग + एक आंतरिक घुमा हुआ वर्ग - एक हाइब्रिड ज्यामिति। पश्चिम में तीनों में से सबसे कम ज्ञात, लेकिन बंगाली-उन्मुख उत्पादों के लिए अनिवार्य है।

तीनों एक ही chart-payload स्वीकार करते हैं - एंडपॉइंट विज़ुअलाइज़ेशन की शैली के अनुसार चुना जाता है।

POST /v1/render/cosmogram - यह एक जन्म कुंडली नहीं है। यह एक 90°-डायल है, जहाँ सभी कठोर पहलू (0°/90°/180°) संयोजन में ढह जाते हैं। यह उपकरण अल्फ्रेड विट्टे (Witte 1928) द्वारा विकसित किया गया था और बाद में रीनहोल्ड एबर्टिन (Ebertin 1940) द्वारा कॉस्मोबायोलॉजी के आधार के रूप में औपचारिक रूप दिया गया।

यह क्यों उपयोगी है: एक मानक 360°-चार्ट पर, कठोर पहलू वृत्त पर “फैले” होते हैं, जिससे क्लस्टर पढ़ना मुश्किल हो जाता है। 90°-डायल पर, वे नेत्रहीन स्पष्ट हो जाते हैं - एक ही 22.5°-सेक्टर में 3-4 ग्रहों का एक क्लस्टर तुरंत दिखाई देता है।

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

यह 4×22.5° वर्ग (कार्डिनल सेक्टर) + 90° के एक घूर्णन पर ग्रहों की स्थिति के साथ SVG लौटाएगा।

POST /v1/render/eclipse-path ग्रहण की केंद्रीयता रेखा के लिए कॉलर-प्रदत्त अक्षांश/देशांतर ट्रैक और वैकल्पिक रूप से डिग्री में बैंड-चौड़ाई स्वीकार करता है। रेंडर - ग्रैटिक्यूल + पथ-रेखा + बैंड-ओवरले के साथ एक इक्विरेक्टेंगुलर विश्व मानचित्र (मानक WGS-84 प्रक्षेपण) है।

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

कॉलर-प्रदत्त पथ एक जानबूझकर किया गया डिज़ाइन विकल्प है। ग्रहण-पथ डेटा विभिन्न प्रामाणिक स्रोतों (NASA Eclipse Catalog, Espenak & Meeus द्वारा Five Millennium Canon of Solar Eclipses) से आता है, प्रत्येक अपनी सटीकता के साथ। एंडपॉइंट NASA की गणना को दोहराने का प्रयास नहीं करता है - यह तुम्हारे ट्रैक को खूबसूरती से रेंडर करता है। डेटा स्रोत के रूप में हम NASA Eclipse Web Site की सलाह देते हैं, लेकिन यह इस एंडपॉइंट के दायरे से बाहर है।

उपयोग का मामला। एक शैक्षिक ऐप, जो मानचित्र पर ट्रैक के साथ अगला ग्रहण दिखाता है। या एक ज्योतिष-परामर्श, जो मूल निवासी के लिए महत्वपूर्ण स्थानों के माध्यम से ग्रहण की “लहर” को विज़ुअलाइज़ करना चाहता है।

POST /v1/render/star-map वैकल्पिक परिमाण और ग्लिफ़ के साथ बिंदुओं (RA/Dec) की एक सूची स्वीकार करता है, और स्टीरियोग्राफिक प्रक्षेपण को रेंडर करता है। परिमाण को बिंदु के त्रिज्या पर मैप किया जाता है (चमकीला तारा = बड़ा वृत्त)।

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

पैरामीटर:

• points: 1 से 2000 तारे/वस्तुएँ
• observerLatDeg + zenithDecDeg: पर्यवेक्षक के बिंदु से सही प्रक्षेपण के लिए
• capAltitudeDeg: ऊंचाई की सीमा (उदाहरण के लिए, खगोलीय गोधूलि के लिए -18)

उपयोग का मामला। ज्योतिष-ऐप में ‘आज रात का आकाश’ विजेट। वास्तविक निर्देशांकों पर नक्षत्रों के साथ वैदिक जन्म संदर्भ। नक्षत्रों के मानचित्र के साथ एक शैक्षिक-उत्पाद।

यदि रास्टर (सोशल मीडिया, ईमेल, पुश के लिए) की आवश्यकता है, तो पाइपलाइन:

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

sharp के माध्यम से SVG → PNG रूपांतरण में ~150ms जुड़ते हैं, जो अभी भी हेडलेस क्रोम से सस्ता है। वैकल्पिक रूप से - इसे SVG के रूप में छोड़ दो और इसे टेम्प्लेट-सिस्टम (Astro, Vue, React कंपोनेंट जिसमें फ्रेमवर्क के संबंधित तंत्र के माध्यम से स्ट्रिंग का सीधा आउटपुट होता है, पूर्व-स्वच्छता के साथ) के माध्यम से HTML में इनलाइन करो।

इस बैच के सभी छह रेंडर एंडपॉइंट - टियर 1: प्रति कॉल 10 क्रेडिट। पूर्ण टैरिफ तालिका मूल्य निर्धारण पर है।

पूर्ण पैरामीटर स्कीमा के साथ दस्तावेज़ - /docs/api/ → रेंडर में। वैदिक-फॉर्मेट, कॉस्मोग्राम, ग्रहण-पथ और स्टार-मैप - प्रत्येक पैरामीटर और प्रतिक्रिया-SVG के उदाहरण के साथ।