> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ones1ght.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 測位情報連携

> GeoSpace（GCH）パートナーキーを登録・検証し、実際の建物・図面・ゾーンのパススルーを有効化する設定画面です。

<Info>
  このページは\*\*管理者（Manager）\*\*以上のみアクセスできます（権限 `manage` — オーナー（Owner）または管理者）。
</Info>

## 測位情報連携とは？

**測位情報連携**は、測位パートナーである\*\*GeoSpace（GCH）\*\*のパートナーキーを登録・検証する画面です。
GeoSpaceは建物・図面・ゾーンの情報を提供するパートナーで、OneS1ghtはこのデータをそのまま通過（パススルー）させて[エリア管理](/ja/locator/areas)に実際の図面を表示します。
パートナーキーを登録することでシミュレーションモードが解除され、実際の店舗図面上でゾーン/ポイントを編集できます。

## GeoSpace（GCH）パートナーキー

GeoSpaceサーバーは、リクエストごとに`X-Partner-Key`ヘッダーでパートナーキーを確認します。このキーをコンソールに登録すると、その組織（テナント）の測位連携に使用されます。

| フィールド           | 説明                                                                         |
| --------------- | -------------------------------------------------------------------------- |
| GeoSpaceサーバーURL | デフォルト `https://geospace.geoplan.io` {/* TODO(팀): 정식 GeoSpace 호스트 확인 필요 */} |
| パートナーキー         | `X-Partner-Key` の値。例: `gpk_...`                                            |

## 登録の流れ

<Steps>
  <Step title="キーを入力">
    発行されたGeoSpaceパートナーキーを入力します。
  </Step>

  <Step title="検証して保存">
    **検証して保存**を押すと、キーの有効性を確認したうえで保存します。検証に成功すると、このキーが測位連携に使用されます。
  </Step>

  <Step title="交換・削除">
    登録済みのキーは**交換**または**削除**できます。テナントキーを削除すると、サーバーのデフォルトキーがあればそれにフォールバックします。
  </Step>
</Steps>

## 接続状態バッジ

| バッジ                | 意味                                    |
| ------------------ | ------------------------------------- |
| 未接続 — シミュレーションモード  | パートナーキーがないため、実際の図面ではなくシミュレーションで動作します。 |
| 接続済み · テナントキー      | この組織が登録したパートナーキーで連携中です。               |
| 接続済み · サーバーデフォルトキー | サーバーに設定されたデフォルトキーで連携中です。              |

<Note>
  最終検証時刻が状態とともに表示されます。連携できない場合は、アウトバウンドネットワーク・パートナーキー・許可ホストの設定を確認してください。
</Note>

## 関連ドキュメント

<CardGroup cols={2}>
  <Card title="エリア管理" icon="draw-polygon" href="/ja/locator/areas">
    連携した図面上でゾーン/ポイントを編集します。
  </Card>

  <Card title="モバイルSDKキー管理" icon="key" href="/ja/locator/sdk-keys">
    アプリが位置データを送信する際に使うSDKキーを発行します。
  </Card>
</CardGroup>