Gölge yolu, kosmogram ve Vedic haritaları: saf-SVG görselleştiriciler headless-Chromesuz

Yol haritamızdaki Görselleştirme kategorisi 14/14 tamamlandı: Altı nihai uç nokta, hazır bir npm paketi bulunmayan belirli düzenleri kapsıyor - üç bölgesel stilde Vedik çizelgeler, Hamburg Okulu kozmogramı, dünya haritasında tutulma yolu ve stereografik yıldız haritası.

Anahtar karar: tüm render’lar, headless Chrome olmadan saf SVG dizeleridir. Bu, saniyenin altında yanıt süresi, düşük çağrı başına maliyet ve herhangi bir e-posta/PDF/web belgesine satır içi ekleme imkanı anlamına gelir.

Çoğu yayın kalitesinde astroloji görseli, SVG şablonlu Chromium aracılığıyla oluşturulur - bu, PDF raporları için normaldir. Ancak /v1/render/* uç noktaları gerçek zamanlı programatik render için tasarlanmıştır:

• bir dashboard React bileşenine satır içi ekleme
• bir e-posta kampanyasına gömme
• çok modlu analiz için bir LLM aracısına aktarma

Headless Chrome uygun değil - RAM maliyeti ve gecikme süresi, tek bir parti için dakikada 100 kez çağrılmasına izin vermiyor. Bu nedenle, altı render’ın tamamı, şablon fonksiyonları aracılığıyla SVG işaretlemesi yayan saf bir string-builder’dır. Soğuk önbellekte bile gecikme süresi 100 ms’nin altındadır.

Hint astrolojisi geleneğinde natal haritanın üç düzeni bilinir ve her birinin kendi bölgesinde kültürel bir ağırlığı vardır:

Klasik “elmas” düzeni: 1. ev her zaman üsttedir (sabit evler), burçlar Lagna’ya bağlı olarak döner. Çoğu Hint ana akım danışmanlığında yaygındır.

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 dizesi (format: "svg") veya { svg, byteLength } içeren bir JSON sarmalayıcı (format: "json", varsayılan) isteyebilirsin.

4×4 kare ızgara, burçlar sabit (Balık her zaman sol üstte, diğerleri saat yönünde), ev numaraları Lagna’ya göre değişir. Tamil Nadu, Kerala, Karnataka’da yaygındır.

Çapraz çizgili bir kare + içe dönük bir kare - hibrit bir geometri. Batı’da üçü arasında en az bilinenidir, ancak Bengal odaklı ürünler için zorunludur.

Üçü de aynı chart-payload’u kabul eder - uç nokta görselleştirme stiline göre seçilir.

POST /v1/render/cosmogram - bu bir natal çember değildir. Bu, tüm sert açıların (0°/90°/180°) birleştiği 90°‘lik bir kadrandır. Bu araç Alfred Witte (Witte 1928) tarafından geliştirilmiş ve daha sonra Reinhold Ebertin (Ebertin 1940) tarafından kozmobiyolojinin temeli olarak resmileştirilmiştir.

Neden faydalı: Standart 360°‘lik bir çizelgede, sert açılar çember boyunca “yayılır”, kümeleri okumak zordur. 90°‘lik kadranda görsel olarak belirgin hale gelirler - tek bir 22.5°‘lik sektördeki 3-4 gezegenlik bir küme hemen görünür.

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°‘lik bir kare (ana sektörler) + gezegenlerin 90°‘lik tek bir dönüşteki konumlarıyla birlikte bir SVG döndürür.

POST /v1/render/eclipse-path, tutulma merkez hattı için arayan tarafından sağlanan enlem/boylam izini ve isteğe bağlı olarak derece cinsinden bant genişliğini kabul eder. Render, bir ızgara + yol çizgisi + bant kaplaması ile eş dikdörtgen bir dünya haritasıdır (standart WGS-84 projeksiyonu).

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

Arayan tarafından sağlanan yol, kasıtlı bir tasarım seçimidir. Tutulma yolu verileri, her biri kendi doğruluğuna sahip farklı kanonik kaynaklardan (NASA Eclipse Catalog, Espenak & Meeus’tan Five Millennium Canon of Solar Eclipses) gelir. Uç nokta, NASA hesaplamasını tekrarlamaya çalışmaz - senin izini güzelce render eder. Veri kaynağı olarak NASA Eclipse Web Sitesi’ni öneriyoruz, ancak bu, bu uç noktanın kapsamı dışındadır.

Kullanım durumu. Harita üzerinde bir iz ile bir sonraki tutulmayı gösteren bir eğitim uygulaması. Veya tutulmanın “dalga”sını yerli için önemli konumlar üzerinden görselleştirmek isteyen bir astroloji danışmanlığı.

POST /v1/render/star-map, isteğe bağlı büyüklük ve glif ile bir nokta listesi (RA/Dec) kabul eder ve stereografik projeksiyonu render eder. Büyüklük, noktanın yarıçapına eşlenir (daha parlak yıldız = daha büyük daire).

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

Parametreler:

• points: 1 ila 2000 yıldız/nesne
• observerLatDeg + zenithDecDeg: gözlemci noktasından doğru projeksiyon için
• capAltitudeDeg: yükseklik sınırı (örneğin, astronomik alacakaranlık için -18)

Kullanım durumu. Bir astroloji uygulamasında ‘bu gece gökyüzü’ widget’ı. Gerçek koordinatlara yerleştirilmiş yıldız-nakşatralarla Vedik natal bağlam. Takımyıldız haritası içeren bir eğitim ürünü.

Eğer raster (sosyal medya, e-posta, push için) gerekiyorsa, işlem hattı:

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 aracılığıyla SVG → PNG dönüşümü ~150 ms ekler, bu da headless Chrome’dan hala daha ucuzdur. Alternatif olarak - SVG olarak bırak ve HTML’ye şablon sistemleri (Astro, Vue, React bileşeni, ilgili framework mekanizması aracılığıyla ön-sanitizasyon ile doğrudan dize çıktısı) aracılığıyla satır içi olarak ekle.

Bu partideki altı render uç noktasının tamamı - Katman 1: çağrı başına 10 kredi. Tam tarife tablosu Fiyatlandırma sayfasında.

Tam parametre şemalarıyla birlikte dokümantasyon /docs/api/ → Render bölümünde. Vedik formatlar, kozmogram, tutulma yolu ve yıldız haritası - her biri parametre örnekleri ve yanıt SVG’si ile birlikte.