> ## 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.

# 測位連携の概要

> OneS1ght の屋内測位をアプリに組み込むまでの全体像 — GeoSpace のインフラ準備から OneS1ght コンソールの設定、SDK 連携までを順番にご案内します。

OneS1ght の屋内測位は、**GeoSpace（測位インフラ）**・**OneS1ght コンソール**・**SDK（アプリ）** の3つで構成されます。それぞれが役割を分担し、相互にデータをやり取りすることでアプリ上の屋内測位が動作します。

## 構成の関係

<Frame>
  <img src="https://mintcdn.com/onecheck/vwnqWP7-70Fw4Xfz/images/positioning-architecture.png?fit=max&auto=format&n=vwnqWP7-70Fw4Xfz&q=85&s=e062cad3d4e30e9c0118d11934a18581" alt="GeoSpace · OneS1ght コンソール · SDK の構成関係" width="1992" height="1080" data-path="images/positioning-architecture.png" />
</Frame>

<CardGroup cols={3}>
  <Card title="GeoSpace" icon="tower-broadcast">
    屋内測位インフラを提供する**パートナー（Geoplan）**。建物・階・図面とロケーター（アンカー）を登録・管理し、連携に使用する**パートナーキー**を発行します。
  </Card>

  <Card title="OneS1ght コンソール" icon="chart-line">
    **サービス本体。** 収集した位置・動線データを**分析・インサイト・レポート**として可視化し、\*\*実行施策（AIエージェント）\*\*につなげます。測位連携のためのパートナーキー登録・エリア設定・SDKキー発行もこちらで行います。
  </Card>

  <Card title="SDK" icon="mobile">
    お客様の**アプリに組み込む測位ライブラリ**。UWB で屋内位置を測定し、エリアの進入・退出・滞在**イベントをアプリに通知**します。
  </Card>
</CardGroup>

<Note>
  本ドキュメントでは、上記のうち**測位連携に必要な設定**（GeoSpace の準備・コンソール連携・SDK の組み込み）のみを扱います。コンソールの分析・インサイト・レポート機能については扱いません。
</Note>

## 進行の順序

3つの構成要素は以下の順に準備します。各ステップが次のステップの前提条件となります。

<Steps>
  <Step title="1. GeoSpace で測位インフラを準備">
    建物・階・図面を登録し、ロケーターを設置・配置したうえで**パートナーキー**を発行します。
  </Step>

  <Step title="2. OneS1ght コンソールで連携・設定">
    パートナーキーを登録して空間を接続し、検知する**エリア**を作成してから**SDKキー**を発行します。
  </Step>

  <Step title="3. アプリに SDK を連携">
    発行した SDKキーでアプリに SDK を組み込みます。以降、測位・エリアイベントがコンソールへ収集されます。
  </Step>
</Steps>

## 詳細な流れ

<Steps>
  <Step title="① GeoSpace — 空間・ロケーターの準備" icon="tower-broadcast">
    パートナーインフラで建物・階・図面を登録し、ロケーター（アンカー）を設置・配置します。最後に**パートナーキー**を発行します。

    → [GeoSpace の準備](/ja/geospace/onboarding) · [空間の構築](/ja/geospace/spaces) · [ロケーター設定](/ja/geospace/locators)
  </Step>

  <Step title="② OneS1ght コンソール — 連携・エリア・キー" icon="sliders">
    発行したパートナーキーをコンソールに**登録**して図面を接続し、検知する**エリア（ゾーン）**を設定したうえで、アプリに組み込む**SDKキー**を発行します。

    → [測位連携](/ja/locator/positioning-data) · [空間管理](/ja/locator/areas) · [モバイルSDK キー管理](/ja/locator/sdk-keys)
  </Step>

  <Step title="③ アプリ — SDK 連携" icon="mobile">
    発行した SDKキーでアプリに OneS1ght SDK を組み込みます。初期化 → 測位開始 → エリアイベント受信の順に動作します。

    → [モバイルSDK 概要](/ja/sdk/overview) · [インストール](/ja/sdk/installation) · [使い方](/ja/sdk/usage)
  </Step>
</Steps>

## 2つのコンソール

この工程では性質の異なる2つのコンソールを使用します。**①は GeoSpace、②は OneS1ght コンソール**で行う点にご注意ください。

| コンソール               | 担当ステップ | 主な役割                                                  | アドレス                           |
| ------------------- | ------ | ----------------------------------------------------- | ------------------------------ |
| **GeoSpace**（パートナー） | ①      | 建物・階・図面・ロケーターの設定、パートナーキーの発行                           | `https://geospace.geoplan.io`  |
| **OneS1ght コンソール**  | ②      | 位置データの分析・インサイト・レポート、実行施策（＋測位連携：パートナーキー登録・エリア・SDKキー発行） | `https://console.ones1ght.com` |

<Note>
  2つのコンソールは権限体系も異なります。GeoSpace は `admin · operator · viewer`、OneS1ght コンソールは `owner · manager · viewer` を使用します。
</Note>

## 事前準備チェックリスト

アプリへの SDK 連携（③）の前に、以下が準備されている必要があります。

| 準備項目                 | 実施場所                      | ドキュメント                               |
| -------------------- | ------------------------- | ------------------------------------ |
| 建物・階・図面（スケール設定済み）    | GeoSpace                  | [空間の構築](/ja/geospace/spaces)         |
| ロケーターの設置・配置          | GeoSpace                  | [ロケーター設定](/ja/geospace/locators)     |
| パートナーキーの発行 → コンソール登録 | GeoSpace → OneS1ght コンソール | [測位連携](/ja/locator/positioning-data) |
| エリア（ゾーン）の設定          | OneS1ght コンソール            | [空間管理](/ja/locator/areas)            |
| SDKキーの発行             | OneS1ght コンソール            | [モバイルSDK キー管理](/ja/locator/sdk-keys) |

<Info>
  **GeoSpace** は UWB 屋内測位インフラを提供するパートナーサービス（Geoplan）です。本ドキュメントでは OneS1ght との連携に必要な準備手順のみをご案内します。GeoSpace 自体の詳細な使い方は GeoSpace のガイドをご参照ください。
</Info>

## 次のステップ

<CardGroup cols={2}>
  <Card title="① GeoSpace の準備から始める" icon="right-to-bracket" href="/ja/geospace/onboarding">
    GeoSpace のログイン・テナント・パートナーキー発行。
  </Card>

  <Card title="③ SDK 連携をプレビュー" icon="mobile" href="/ja/sdk/overview">
    アプリに SDK を組み込む方法。
  </Card>
</CardGroup>