Skip to content

チャートレンダリング

美しいSVGおよびPNGチャート画像を生成します。

SVGチャート

クエリパラメータを使用してSVGネイタルチャートを生成する:

bash
curl -X GET "https://api.astroapi.cloud/api/chart/image.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=-0.1278&location.latitude=51.5074&location.timezone=Europe/London" \
  -H "X-Api-Key: your-api-key"

PNGチャート

PNG形式に変換する:

bash
curl -X GET "https://api.astroapi.cloud/api/chart/image.png?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=-0.1278&location.latitude=51.5074&location.timezone=Europe/London" \
  -H "X-Api-Key: your-api-key" \
  --output chart.png

チャートタイプ

エンドポイント説明
/api/chart/image.svgSVG形式のネイタルチャート
/api/chart/image.pngPNG形式のネイタルチャート
transit.* パラメータ付き /api/chart/image.svgトランジットバイホイールチャート
/api/chart/composite.svgコンポジットチャート(中点)
/api/chart/composite.pngPNG形式のコンポジットチャート

トランジットバイホイールチャート

トランジットパラメータを追加して、ネイタル(内側)とトランジット(外側)のホイールを持つバイホイールチャートをレンダリングする:

bash
curl -X GET "https://api.astroapi.cloud/api/chart/image.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=-0.1278&location.latitude=51.5074&location.timezone=Europe/London&transit.dateTime=2024-01-15T12:00&transit.timezone=Europe/London" \
  -H "X-Api-Key: your-api-key"

トランジットパラメータ

パラメータ必須説明
transit.dateTimeはいトランジットの日時(YYYY-MM-DDTHH:mm)
transit.timezoneはいトランジットのタイムゾーン
transit.longitudeいいえトランジット地の経度(デフォルトはネイタル)
transit.latitudeいいえトランジット地の緯度(デフォルトはネイタル)

コンポジットチャート

2つのネイタルチャートの中点を示すコンポジットチャートを生成する:

bash
curl -X GET "https://api.astroapi.cloud/api/chart/composite.svg?width=800&height=800&person1.dateTime=1990-06-15T14:30&person1.timezone=Europe/London&person1.longitude=-0.1278&person1.latitude=51.5074&person2.dateTime=1988-03-22T09:15&person2.timezone=Europe/Paris&person2.longitude=2.3522&person2.latitude=48.8566" \
  -H "X-Api-Key: your-api-key"

クエリパラメータ

ネイタルチャートパラメータ

パラメータ必須説明
widthはいチャートの幅(ピクセル)
heightはいチャートの高さ(ピクセル)
dateTimeはい出生日時(YYYY-MM-DDTHH:mm)
location.longitudeはい出生地の経度
location.latitudeはい出生地の緯度
location.timezoneはい出生地のタイムゾーン(IANA形式)

コンポジットチャートパラメータ

パラメータ必須説明
widthはいチャートの幅(ピクセル)
heightはいチャートの高さ(ピクセル)
person1.dateTimeはい人物1の出生日時
person1.timezoneはい人物1のタイムゾーン
person1.longitudeはい人物1の経度
person1.latitudeはい人物1の緯度
person2.dateTimeはい人物2の出生日時
person2.timezoneはい人物2のタイムゾーン
person2.longitudeはい人物2の経度
person2.latitudeはい人物2の緯度

レスポンスヘッダー

チャートエンドポイントは適切なコンテントタイプを返します:

  • SVG: image/svg+xml
  • PNG: image/png

チャートの埋め込み

返されたSVGをHTMLに直接使用する:

html
<div class="chart-container">
  <!-- APIからのSVGコンテンツ -->
</div>

またはデータURLを画像ソースとして使用する:

html
<img src="data:image/svg+xml;base64,..." alt="Natal Chart" />

Chart2 - 次世代チャート

AstroAPIはテーマサポートとアニメーションを備えた次世代チャートレンダリングエンジンを提供しています。

エンドポイント

エンドポイント説明必要なモジュール
/api/chart2/natal.svgネイタルチャート(SVG)module:natal-calc
/api/chart2/natal.pngネイタルチャート(PNG)module:natal-calc
/api/chart2/transit.svgトランジットバイホイール(SVG)module:transit-calc
/api/chart2/transit.pngトランジットバイホイール(PNG)module:transit-calc
/api/chart2/synastry.svgシナストリーチャート(SVG)module:synastry-calc
/api/chart2/synastry.pngシナストリーチャート(PNG)module:synastry-calc
/api/chart2/composite.svgコンポジットチャート(SVG)module:synastry-calc
/api/chart2/composite.pngコンポジットチャート(PNG)module:synastry-calc
/api/chart2/animated-transit.svgアニメーショントランジット(SVG)module:transit-calc

基本的な使用方法

bash
curl -X GET "https://api.astroapi.cloud/api/chart2/natal.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=4.89&location.latitude=52.37&location.timezone=Europe/Amsterdam&theme=dark" \
  -H "X-Api-Key: your-api-key"

テーマプリセット

テーマ説明
defaultカラー要素を持つクラシックな白背景
classic伝統的な占星術の外観
dark鮮やかな色を持つモダンなダークテーマ
minimalクリーンで視覚的なノイズが少ない
colorful鮮やかな惑星色
nextgen曲線アスペクトライン、グロー効果、グラデーションを持つモダン
vintage古いパーチメント・写本スタイル、セピアトーン
neon黒背景に明るいネオン色のサイバーパンク
pastel柔らかく落ち着いたパステルカラー
print高コントラストの白黒、印刷に最適化

テーマオーバーライド

クエリパラメータで個別のテーマプロパティをカスタマイズする:

パラメータ説明
theme.background背景色(16進数)
theme.foreground前景色(16進数)
theme.strokeOnlyストロークのみモード(true/false)
theme.symbolScaleシンボルスケールファクター
theme.showDegrees度数ラベルを表示(true/false)
theme.showHouseNumbersハウス番号を表示(true/false)
theme.showRulerルーラーを表示(true/false)
theme.signBackgroundOpacityサイン背景の不透明度(0〜1)

シナストリーとコンポジットチャート

bash
curl -X GET "https://api.astroapi.cloud/api/chart2/synastry.svg?width=800&height=800&person1.dateTime=1990-06-15T14:30&person1.timezone=Europe/Amsterdam&person1.longitude=4.89&person1.latitude=52.37&person2.dateTime=1992-03-20T09:15&person2.timezone=Europe/London&person2.longitude=-0.12&person2.latitude=51.50" \
  -H "X-Api-Key: your-api-key"

アニメーショントランジット

時間の経過とともにトランジットの進行を示すアニメーションSVGを生成する:

bash
curl -X GET "https://api.astroapi.cloud/api/chart2/animated-transit.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=4.89&location.latitude=52.37&location.timezone=Europe/Amsterdam&transit.dateTime=2025-01-01T12:00&transit.timezone=Europe/Amsterdam&target.dateTime=2025-12-31T23:59&animation.duration=3000" \
  -H "X-Api-Key: your-api-key"
パラメータ説明
target.dateTimeアニメーションの終了日時
animation.durationアニメーション時間(ミリ秒)
animation.easingイージング関数(デフォルト:easeInOut)
animation.loopアニメーションをループする(デフォルト:false)

AstroAPI Documentation