Eclipse path, cosmogram と Vedicマップ: pure-SVG ビジュアライザー（headless-Chromeなし）

**カテゴリ「Visualization」**は、当社のロードマップで14/14の完了を迎えました。この中には、npmパッケージがまだ用意されていない6つの最終的なエンドポイントが含まれており、それぞれ特定のレイアウトに対応しています：ヴェディックチャート（3つの地域スタイル）、ハンブルクスクールのコスモグラム、世界地図上の日食経路、およびステレオグラフィックスターマップ。

鍵となる解決策：すべてのレンダリングは純粋なSVG文字列で、Headless Chromeを使用しません。これはサブセカンドのレスポンス時間、低コストパーコール、そしてメール/PDF/Webドキュメント内でのインライン挿入が可能なことを意味します。

多くの出版レベルの占星術チャートは、ChromiumとSVGテンプレートを使用して作成されますが、これはPDFレポート向けの標準的な方法です。しかし、/v1/render/*エンドポイントはリアルタイムでのプログラムによるレンダリングに特化しています：

• ダッシュボード内のReactコンポーネントへのインライン挿入
• メールキャンペーンへの埋め込み
• マルチモーダル分析のためのLLMエージェントへの送信

Headless Chromeは適していません。RAMコストとラテンシが、1時間あたり100回以上の呼び出しを許容できないためです。そのため、6つのレンダラーはすべて、テンプレート関数を通じてSVGマークアップを出力する純粋な文字列ビルダーです。冷たいキャッシュでもラテンシは100ms未満です。

インド占星術の伝統では、3つの生まれつきのチャートレイアウトがあり、それぞれの地域で文化的なウェイトがあります：

クラシックな「ダイヤモンド」レイアウト：1番の家は常に上部（固定されたhouses）、星座はラグナに応じて回転します。ヒンディー系のメインストリームコンサルテーションで広く使用されています。

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の正方形グリッドで、星座は固定されています（魚座は常にトップ左、他の星座は時計回り）。ラグナに応じて家の番号が変動します。タミルナードゥ、ケーララ、カルナタカ州で広く使用されています。

対角線付きの正方形 + 内側に回転した正方形のハイブリッド幾何学。西側では最も知られていない3つのうちの1つですが、ベンガル系の製品には必須です。

3つのチャートは同じチャートペイロードを受け付け、エンドポイントは視覚化スタイルによって選択されます。

POST /v1/render/cosmogramは、生まれつきの輪ではありません。これは90°ダイヤルで、すべてのハードアスペクト（0°/90°/180°）が接続にコラプスします。アルフレッド・ヴィッテ（Witte 1928）によって開発され、後にラインゴルト・エーベルト（Ebertin 1940）によってコスモバイオロジーの基礎として形式化されました。

なぜ役立つか：標準的な360°チャートでは、ハードアスペクトが円周に広がっており、クラスターを読み取るのが難しいです。90°ダイヤルでは、これらのアスペクトが視覚的に明確になり、3-4の惑星が同じ22.5°セクター内に集中しているクラスターがすぐにわかります。

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は、呼び出し元が提供するlat/lonトラック（日食の中心線）と、オプションで度数単位のバンド幅を受け付けます。レンダリングは、WGS-84の標準的な投影である赤道直角世界地図（graticule + path-line + band-overlay）です。

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の座標リスト（オプションで明るさとglyph）を受け付け、ステレオグラフィック投影をレンダリングします。明るさは、点の半径にマッピングされます（明るい星ほど大きな円）。

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を追加しますが、それでもHeadless Chromeよりは安価です。代替案として、SVGのままにしておき、HTML内にインラインで挿入することもできます（Astro、Vue、Reactコンポーネントで直接文字列を出力する際のテンプレートシステムを使用し、事前にサンプリングを行う）。

このパーティの6つのレンダリングエンドポイントは、Tier 1：1回の呼び出しあたり10クレジットです。完全な料金表は、Pricingでご確認ください。

完全なパラメータスキーマのドキュメントは、/docs/api/ → Renderにあります。ヴェディック形式、コスモグラム、日食経路、スターマップは、それぞれパラメータの例とSVGレスポンスのサンプルを含んでいます。