# 言語サポート

AstroWay は**多言語対応 API** を構築しています——テキスト解釈、レポート、デイリーホロスコープをユーザーの言語で提供します。公開リストは、占星術市場の需要調査（検索ボリューム、競合のカバレッジ、収益ポテンシャル）に基づいて選定した20言語です。

<Aside type="tip">
**仕組み。** 言語はリクエストボディの `language` フィールド——あるいは URL の `?lang=<code>`、または `Accept-Language` ヘッダー——で `/v1/interpret/*`、`/v1/horoscope/*`、`/v1/reports/*` に渡します。言語がアクティブであれば、その言語でテキストが返されます（Beta 言語では複雑な用語に不正確さが残ることがあり、その場合は英語にフォールバックします）。言語が非アクティブの場合、`/horoscope/*` と `/reports/*`（厳格な enum）は `400 INVALID_INPUT` を返し、`/interpret/*` は英語にフォールバックします。
</Aside>

## 現在のステータス

各言語には翻訳の**ステータス**と、ロードマップ上の**需要スコア**（優先度、48〜95+）が付与されています。

| # | Code | Language | Status | Demand | Reports | Site |
|---|------|----------|--------|--------|---------|------|
| 1  | `uk` | ウクライナ語 | ✅ Source | — | ✅ | ✅ |
| 2  | `en` | 英語 | ✅ Reference | **95+** | ✅ | ✅ |
| 3  | `de` | ドイツ語 | 🚧 Auto | 72 | 📋 | ✅ |
| 4  | `pl` | ポーランド語 | 🚧 Auto | 64 | 📋 | ✅ |
| 5  | `es` | スペイン語 | 🚧 Auto | **88** | 📋 | ✅ |
| 6  | `pt` | ポルトガル語 | 🚧 Auto | **84** | 📋 | ✅ |
| 7  | `hi` | ヒンディー語 | 🚧 Auto | **81** | 📋 | ✅ |
| 8  | `fr` | フランス語 | 🚧 Auto | **78** | 📋 | ✅ |
| 9  | `ko` | 韓国語 | 🚧 Auto | **77** | 📋 | ✅ |
| 10 | `it` | イタリア語 | 🚧 Auto | 73 | 📋 | ✅ |
| 11 | `ja` | 日本語 | 🚧 Auto | 67 | 📋 | ✅ |
| 12 | `id` | インドネシア語 | 🚧 Auto | 62 | 📋 | ✅ |
| 13 | `tr` | トルコ語 | 🚧 Auto | 60 | 📋 | ✅ |
| 14 | `nl` | オランダ語 | 🚧 Auto | 58 | 📋 | ✅ |
| 15 | `cs` | チェコ語 | 🚧 Auto | 56 | 📋 | ✅ |
| 16 | `ro` | ルーマニア語 | 🚧 Auto | 54 | 📋 | ✅ |
| 17 | `vi` | ベトナム語 | 🚧 Auto | 53 | 📋 | ✅ |
| 18 | `ar` | アラビア語 | 🚧 Auto | 52 | 📋 | ✅ |
| 19 | `el` | ギリシャ語 | 🚧 Auto | 50 | 📋 | ✅ |
| 20 | `hu` | ハンガリー語 | 🚧 Auto | 48 | 📋 | ✅ |

**凡例:**
- **Status** — ✅ Source / Reference = 人手で執筆・保守（uk, en）。🚧 Auto = 共有用語集に基づいて自動翻訳し、時間をかけて改善（まだ文字列ごとの手動レビューは行っていないため、ニュアンスのある用語は粗く読めることがあります。欠落した文字列はすべて英語にフォールバック）。
- **Site** — ✅ 提供済み（UI + ドキュメント）・📋 計画中。
- **Reports** — ✅ 提供済み・📋 計画中。

## 翻訳の生成方法

ウクライナ語がソース言語で、英語が保守対象のリファレンスです——どちらも人手で執筆されています。それ以外のすべての言語は、共有の占星術用語集（約800語）に基づいて自動翻訳し、時間をかけて改善しています。まだ文字列ごとの手動レビューは行っていないため、複雑な用語については Beta として扱い、文字列が欠落している箇所は英語にフォールバックします。サイトの UI とドキュメントは、現時点で掲載中のすべての言語をカバーしています。ローカライズされた PDF レポートは現在ウクライナ語と英語で提供されており、需要に応じて他の言語にも順次展開します。

## 需要スコア — 算出方法

以下の要素から構成される複合指標です:
- 各国における占星術キーワードの Google トレンド12か月ボリューム
- 上位5社の競合（Co–Star、AstroSeek、Astro.com、Prokerala、DivineAPI）によるカバレッジ
- 推定人口 × 推定有料アプリ浸透率
- ユーザーあたり収益の差分（購買力平価で調整）

正確な指標ではなく、印象ではなく客観的に「次に何をするか」を決める助けとなる**優先順位付けされたランキング**です。

## 呼び出し方法

```bash
curl -X POST https://api.astroway.info/v1/interpret/aspects \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "language": "es",
    "aspects": [
      { "body1": "Sun", "body2": "Moon", "type": "conjunction", "orb": 2.1 }
    ]
  }'
```

レスポンス（`language=es` のサンプル）:

```json
{
  "ok": true,
  "data": {
    "interpretation": "El aspecto Sol-Luna en conjunción simboliza...",
    "language": "es"
  }
}
```

レスポンスの `language` フィールドは適用された言語をそのまま返します（UX インジケーターとして便利です）。翻訳品質のステータスは上の表に記載されており、API レスポンスでは**返されません**。

## リストにない言語が必要な場合

需要の根拠（サンプルユーザー、想定ボリューム）を添えて [hello@astroway.info](mailto:hello@astroway.info) までメールしてください。リストは**四半期ごと**に見直しており、外部からの実需がある言語は Tier 4（オプトイン）として追加できます。

ショートリストの一部の言語は**恒久的にスキップ**されています——`da, fi, no, bg, sk, hr, zh-CN, fa, tl`——市場が小さい、または占星術の伝統がないためです。これらは非アクティブで、`/horoscope/*` と `/reports/*` は `400 INVALID_INPUT` を返し、`/interpret/*` は英語にフォールバックします。

## 関連

- [計算精度](/ja/accuracy/) — 数値計算は**言語に依存せず**、テキストのみがローカライズされます
- [レポート](/ja/products/) — 多言語対応 PDF レポート
- [冪等性](/ja/idempotency/) — キャッシュ割引は `lang` とは独立して機能します