# Vastu API: 家のプラン、マンダラ、16ゾーン、レポート

あなたは家のプランを送ります: 輪郭、北への角度、部屋、アイテム、主要なドア、画像のピクセルまたはメートル単位で。返ってくるのは、各部屋が中心からどこにあるか、テキストで説明された内容、できること、そして単にプランに貼り付けられる画像です。

![12×9メートルのプラン上の81セルのマンダラ: 南東のキッチン、北東のトイレ、E3セルのドア](/vastu-plan-overlay.svg)

## API が返すもの

| エンドポイント | クレジット | 返却内容 |
|---|---|---|
| `POST /v1/vastu/plan` | 20 | 各部屋とアイテムの方位、8・16・32 セクター、神が描かれたマンダラのセル、ソース付きの判定、ドアの位置、輪郭の形状、修正付きの発見、帯付きの評価 |
| `POST /v1/render/vastu` | 20 | 透明背景の SVG（プラン座標系）: マンダラ、16 ゾーンまたは 8 方向 |
| `POST /v1/reports/vastu` | 5 000 | あなたのブランドで作成された PDF レポート（ウクライナ語または英語） |
| `POST /v1/vastu/zones` | 10 | 正確な境界を持つ 8、16、または 32 セクター。プランを送れば各ゾーンに含まれるものも返す |
| `POST /v1/vastu/rooms` | 10 | 方向ごとの判定と評価（プランがすでに測定済みの場合） |
| `POST /v1/vastu/entrance` | 10 | 主要ドアの位置とその影響 |
| `POST /v1/vastu/mandala` | 10 | 完全なマンダラ: 45 の神とそのセル |
| `POST /v1/vastu/directions` | 10 | 守護者・惑星・古典的規則付きの 8 方向 |

フィールドの完全な説明、例、エラ―コードは [Vastu ドキュメント](/vedic/vastu/) を参照してください。

## ルールの出典

各判定には `basis` が付与されます。`classical` は詩が裏付けとなっており、ソースは番号で示します: **ブリハット・サンヒタ, 第 53 章**（1884 年アイエル訳、サンスクリットと照合）、**マヤマタ**（第 2 の古典学派）、**ムフルタ・チンタマニ 12.21**（16 区ゾーンの部屋用）。`convention` は詩なしの現代的実践を意味し、そのまま記載されます。

選択できる 3 つの学派: `brihat-samhita`（デフォルト）、`mayamata`、`sixteen-zone`。古典学派はマンダラ矩形の中心から方位を測り、16 区学派は面積の重心から測ります。回答は常にどちらから測ったかを示します。

**Caution:**
**一部の部屋は古典学派で扱われません。** 食堂、バルコニー、ガレージ、屋上のタンクは古典的規則がなく、`brihat-samhita` と `mayamata` は 400 を返し、架空の回答は出しません。`sixteen-zone` 学派では `convention` ラベル付きで評価されます。

## やらないこと

- **画像からプランを読み取らない。** 幾何情報は自分で送るので、画像自体やその URL はデバイスを離れません。私たちが受け取るのは輪郭、部屋、ドアの座標だけです。
- **結果を保証しない。** 修正には作業コストとラベルが付くかどうかが示されますが、変更が確実に起こるとは限りません。ピラミッド、ヤントラ、フィギュアなどの商品は提供しません。
- **規則を作り出さない。** どのソースにも記載がない配置には `no-rule` 判定が付与され、評価には含めません。

## 対象者

- **プロップテック・不動産エージェンシー**: 物件の他の特性と併せてアパートのプランを評価。
- **建築家・インテリアデザイナー**: 図面作成前に古典規則でスケッチをチェック。
- **ヴァストゥ コンサルタント**: 手作業計算の代わりに、1 分で自社ブランドのレポートを作成。
- **占星プラットフォーム**: ヴァストゥ をマップに組み込み、同じキーとクレジットで利用。

## FAQ

**北をどう指定すればいいですか？コンパスしかない場合は？** 角度と `northReference: "magnetic"`、そして場所に合わせた `declination` を送ってください。磁北だけだと 400 が返ります：規則は真北から読み取ります。

**G 字形のプランはどう扱われますか？** 重心がプラン外にあります。回答は警告を出し、古典学派はマンダラ矩形の中心から測り、切り抜き部分のセルは `outsideContour` とマークされます。

**レポートの料金はいくらですか？** 5 000 クレジットで、他の PDF レポートと同じです。無料プランではレポートは利用できませんが、10 と 20 クレジットの計算は可能です。