Eclipse path, cosmogram dan Vedic-peta: pure-SVG visualizer tanpa headless-Chrome

Kategori Visualisasi di roadmap kami telah selesai 14/14: enam endpoint akhir menutup layout khusus yang tidak memiliki paket npm siap pakai - Vedic-chart dalam tiga gaya regional, Hamburg-School cosmogram, eclipse-path di peta dunia, dan stereographic star-map.

Solusi kunci: semua render adalah string SVG murni, tanpa headless Chrome. Ini berarti respons subdetik, biaya rendah per-panggilan, dan kemungkinan inline di email/PDF/web-dokumen apa pun.

Banyak gambar astrologi berkualitas publikasi dibuat menggunakan Chromium dengan template SVG - ini normal untuk laporan PDF. Namun, endpoint /v1/render/* ditujukan untuk render program secara real-time:

• Inline di komponen React dashboard
• Embed di kampanye email
• Kiriman ke agen LLM untuk analisis multimodal

Headless Chrome tidak cocok - biaya RAM dan latensi tidak memungkinkan menjalankannya hingga 100 kali per jam untuk satu batch. Oleh karena itu, semua enam renderer adalah string-builder murni yang mengeluarkan markup SVG melalui fungsi template. Latensi di bawah 100ms bahkan pada cache dingin.

Dalam astrologi India, ada tiga layout untuk chart natal, dan masing-masing memiliki bobot budaya di wilayahnya:

Layout klasik “diamond”: rumah pertama selalu di atas (rumah tetap), tanda-tanda berputar tergantung pada Lagna. Populer di sebagian besar konsultasi mainstream Hindi.

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

Anda dapat meminta string SVG (format: "svg") atau wrapper JSON dengan { svg, byteLength } (format: "json", default).

Grid kuadrat 4×4, tanda-tanda tetap (Pisces selalu top-left, lainnya bergerak searah jarum jam), nomor rumah berubah-ubah tergantung pada Lagna. Populer di Tamil Nadu, Kerala, Karnataka.

Kuadrat dengan diagonal + kuadrat internal terbalik - geometri hibrid. Paling sedikit dikenal di Barat, tetapi wajib untuk produk yang berorientasi Bengali.

Semua tiga menerima payload chart yang sama - endpoint dipilih berdasarkan gaya visualisasi.

POST /v1/render/cosmogram bukanlah chart natal. Ini adalah dial 90° di mana semua hard aspects (0°/90°/180°) dikolaps menjadi koneksi. Alat ini dikembangkan oleh Alfred Witte (Witte 1928) dan kemudian diformalisasi oleh Reinhart Ebertin (Ebertin 1940) sebagai dasar cosmobiology.

Mengapa ini berguna: pada chart 360° standar, hard aspects “tersebar” di lingkaran, sulit untuk membaca klaster. Pada dial 90°, mereka menjadi jelas secara visual - klaster dengan 3-4 planet di satu sektor 22.5° terlihat langsung.

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

Mengembalikan SVG dengan kuadrat 4×22.5° (sektor kardinal) + posisi planet pada satu putaran 90°.

POST /v1/render/eclipse-path menerima jalur lat/lon yang disediakan pemanggil untuk garis sentralitas gerhana dan lebar band opsional dalam derajat. Rendering adalah peta dunia equirectangular (proyeksi standar WGS-84) dengan graticule + jalur path + overlay 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" }
  }'

Jalur yang disediakan pemanggil adalah pilihan desain sengaja. Data eclipse-path berasal dari berbagai sumber kanonik (NASA Eclipse Catalog, Five Millennium Canon of Solar Eclipses oleh Espenak & Meeus), masing-masing dengan presisi sendiri. Endpoint tidak mencoba replikasi komputasi NASA - ia hanya merender jalurmu dengan indah. Sebagai sumber data, kami merekomendasikan NASA Eclipse Web Site, tetapi hal ini berada di luar lingkup endpoint ini.

Use case. Aplikasi pendidikan yang menampilkan gerhana berikutnya dengan jalur melalui peta. Atau konsultasi astrologi yang ingin visualisasi “gelombang” gerhana melalui lokasi penting bagi seseorang.

POST /v1/render/star-map menerima daftar titik (RA/Dec) dengan magnitudo opsional dan glyph, dan merender proyeksi stereografis. Magnitudo di mapping ke radius titik (bintang lebih terang = lingkaran lebih besar).

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

Parameter:

• points: dari 1 hingga 2000 bintang/objek
• observerLatDeg + zenithDecDeg: untuk proyeksi yang benar dari titik pengamat
• capAltitudeDeg: batas ketinggian (misalnya, -18 untuk senja astronomis)

Use case. Widget “langit malam ini” dalam aplikasi astrologi. Konteks natal Vedic dengan bintang-nakshatra, ditumpuk pada koordinat sebenarnya. Produk pendidikan dengan peta konstellasi.

Jika dibutuhkan raster (untuk media sosial, email, push), 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

Konversi SVG ke PNG menggunakan sharp menambahkan ~150ms, yang tetap lebih murah daripada headless Chrome. Alternatifnya - biarkan sebagai SVG dan masukkan inline ke HTML melalui sistem templating (Astro, Vue, React komponen dengan output langsung string melalui mekanisme framework yang sesuai dengan pre-sanitasi).

Enam endpoint render ini termasuk dalam Tier 1: 10 kredit per panggilan. Daftar harga lengkap dapat ditemukan di Pricing.

Dokumentasi lengkap dengan skema parameter penuh di /docs/api/ → Render. Format Vedic, cosmogram, eclipse-path, dan star-map masing-masing memiliki contoh parameter dan snapshot respons SVG.