チャートレンダリング
美しい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.svg | SVG形式のネイタルチャート |
/api/chart/image.png | PNG形式のネイタルチャート |
transit.* パラメータ付き /api/chart/image.svg | トランジットバイホイールチャート |
/api/chart/composite.svg | コンポジットチャート(中点) |
/api/chart/composite.png | PNG形式のコンポジットチャート |
トランジットバイホイールチャート
トランジットパラメータを追加して、ネイタル(内側)とトランジット(外側)のホイールを持つバイホイールチャートをレンダリングする:
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) |