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

# 8. 動作検証

> 設置した測位インフラが実際に動作するかを確認し、問題が発生した場合の対処方法を確認します。

## 1) 開始前の確認

> [!CAUTION]
>
> 検証には UWB 対応の iPhone が必要です。
>
> * 機器: iPhone 12 以降（UWB チップ搭載）
> * iOS: 27.0 以降

担当者から受け取った検証アプリ（デモアプリ）とインストール案内資料を準備してください。

以下の手順がすべて完了しているか確認してください。未完了の手順があると、測位が正常に行われないことがあります。

| 確認項目 | ドキュメント |
| - | - |
| 建物・フロアの登録の完了（図面を登録する場合は図面のアップロード・スケール設定まで） | [3. 空間登録](/ja/locator/spaces) |
| ロケーターの設置と電源接続 | [4. ロケーターの現場設置](/ja/locator/install) |
| ロケーター4台のプロビジョニングと登録の完了 | [5. ハードウェア登録](/ja/locator/hardware) |
| 座標入力と \[装置適用] の完了 | [6. 測位機能の有効化](/ja/locator/placement) |
| パートナーキーの発行と OneS1ght への登録の完了 | [7. 測位情報の連携](/ja/locator/connect) |

> [!NOTE]
>
> 検証のステップでは、コードの入力は必要ありません。通常のアプリと同じ方法で
> 検証アプリ（デモアプリ）をインストールし、測位の動作を確認します。

> [!NOTE]
>
> 検証アプリとインストール案内は担当者を通じて提供されます。届いていない場合は\\
>
> [support@ones1ght.com](mailto:support@ones1ght.com) までご依頼ください。

## 2) ロケーターの電源接続状態の確認

設置したロケーター4台すべてで、上部 LED が緑、下部 LED が青（サーバー接続成功）で点灯しているか確認します。
点灯していないロケーターがある場合は、電源接続を確認します。
クラスターがすでに「構築完了」になっているロケーターは、Wi-Fi が切れて下部 LED が紫と水色で点滅していても測位は動作します
（[トラブルシューティング](/ja/locator/troubleshooting#ロケーターの下部ledが紫と水色で点滅する)）。
（LED の位置と色ごとの意味は [4. ロケーターの現場設置](/ja/locator/install) の LED 表を参照）

* ロケーターが1台でも電源オフの場合は、次のステップに進まないでください。
* 最低4台のロケーターが正常に動作していないと、安定した測位はできません。

## 3) OneS1ght の接続状態の確認

OneS1ght が GeoSpace から実際の図面情報を正常に読み込めているか確認します。

OneS1ght のサイドバーから \[組織設定] に移動し、API 連携の Geospace連携で
Intelligence Hub（モバイル）行の連携状態バッジを確認します。

| バッジ | 意味 | 対応 |
| - | - | - |
| 接続済み | ·パートナーキーが登録され、正常に連携中 | ·次のステップに進む |
| 未接続 | ·パートナーキーが登録されていない状態 | ·[7. 測位情報の連携](/ja/locator/connect) で登録 |
| キー無効 | ·登録されたキーが有効でない状態 | ·[7. 測位情報の連携](/ja/locator/connect) でキーを再発行して登録 |

\[設定変更] をクリックすると、登録日と最終検証の時刻を確認できます。

その後、[空間管理](/ja/console/areas) に移動し、選択した建物・フロアの実際の図面が表示されるか確認します。\

図面を登録したフロアが「図面未連携の建物」と表示される場合は、連携状態と [3. 空間登録](/ja/locator/spaces) の完了有無を再確認します。
図面を登録していないフロアは、「図面未連携の建物」と表示されるのが正常です。

## 4) 検証アプリの実行

**(1) アプリのインストール**

下のボタンを押してストアから **OneS1ght** アプリをインストールし、起動します。

[![App Store からダウンロード — OneS1ght iOS アプリ](https://mintcdn.com/onecheck/E2whs2uAjcPfu5dJ/images/demo/app-store-badge-ja.svg?fit=max\&auto=format\&n=E2whs2uAjcPfu5dJ\&q=85\&s=277895782bd6dc5ed1189daa73935f8f)](https://apps.apple.com/jp/app/ones1ght/id6810071872)

[![Google Play で手に入れよう — OneS1ght Android アプリ](https://mintcdn.com/onecheck/E2whs2uAjcPfu5dJ/images/demo/google-play-badge-ja.svg?fit=max\&auto=format\&n=E2whs2uAjcPfu5dJ\&q=85\&s=59104ecdd6918375fddc5651bbfa46b5)](https://play.google.com/store/apps/details?id=com.ones1ght.onboarding.android\&pcampaignid=web_share)

**(2) 権限の承認**

アプリを初めて起動すると、権限の許可リクエストが表示されます。以下の権限をすべて許可しないと、測位機能を使用できません。

| 権限 | 用途 |
| - | - |
| 位置情報の権限 | ·地図に現在地を表示するために使用 |
| Bluetooth | ·UWB ロケーターの信号を受信するために使用 |

**(3) ログイン**

![検証アプリのログイン画面（メールアドレス・パスワードの入力とログインボタン、Google Workspace・Microsoft Entra アカウントでのログイン）](https://mintcdn.com/onecheck/5u3BErG_mEDOJqyL/images/demo/8.verify-app-login.png?fit=max\&auto=format\&n=5u3BErG_mEDOJqyL\&q=85\&s=11724a67e87bf0ce5d8c11bf90261cc3)

ログイン画面が表示されたら、OneS1ght に登録されたメールアドレスとパスワードを入力してログインします。
メールアドレスが登録されていない場合はログインできないため、組織の管理者（owner または manager）に招待を依頼してください。

* 必ずロケーターが設置された測位エリア内でアプリを実行してください。
  検知エリアの外では、測位が正常に動作しないことがあります。

**(4) 測位画面**

アプリが Bluetooth で周辺のロケーターの信号を検知すると、そのロケーターが登録された GeoSpace の建物・フロアを
自動で認識して測位が始まります。建物・フロアを個別に選択する必要はありません。

**ロケーター検知前（ロケーターを検索中）**

![検証アプリのロケーター検知前の画面（ロケーターを検索中の案内と位置情報の収集準備完了の状態）](https://mintcdn.com/onecheck/5u3BErG_mEDOJqyL/images/demo/8.verify-app-searching.png?fit=max\&auto=format\&n=5u3BErG_mEDOJqyL\&q=85\&s=facfc1d47a4f16577b8bceea6fe9b003)

* ログイン直後、検知されたロケーターがない間は「ロケーターを検索中」の画面が表示され続けます。
* ロケーターが設置された検知エリアに移動すると、自動で先に進みます。

**ロケーター検知後（測位開始）**

![ロケーター検知後の測位開始画面（認識された建物・フロアと受信状態、一時停止・設定ボタン、図面上の現在地の点、ゾーン、下部の状態とログを見る）](https://mintcdn.com/onecheck/5u3BErG_mEDOJqyL/images/demo/8.verify-app-auto-mapping.png?fit=max\&auto=format\&n=5u3BErG_mEDOJqyL\&q=85\&s=bd4a1daf07fa354b1d864d01df7d27ca)

フロアに設置されたロケーターが1台でも検知されると、そのフロアが自動で認識されます。画面構成は次のとおりです。

**① 認識された建物・フロア情報**

ロケーターが検知されると、認識された建物・フロア名と「現在地を受信しています」の状態が自動で表示されます。

**② 一時停止ボタン**

測位は開始操作なしで自動的に始まります。測位を一時的に止めたり再開したりするときに使用します。

| 状態 | ボタン表示 | ロケーター表示 |
| - | - | - |
| 測位中 | 一時停止マーク | 緑色 |
| 一時停止 | 再生マーク | グレー |

* 測位が不安定な場合にも、該当のロケーターがグレー（非アクティブ）で表示されることがあります。

**③ 設定ボタン**

設定画面に移動します。

**④ 現在地の確認**

図面上に現在地の点が表示されれば、測位は正常に始まっています。
以下の方法で位置が正確か確認します。

* ロケーター4台が構成する検知エリアの中央に立ち、図面上に現在地の点が表示されるか確認します。
* 検知エリア内で端から反対側の端までゆっくり移動し、位置の点が実際の移動経路に沿って動くか確認します。
* 各ロケーターの真下に立ち、位置の点が図面上の該当コーナーに表示されるか確認します。
  座標入力と図面配置が正確かを検証する最も確実な方法です。
* 棚や出入口など図面上で見分けられる地点に立ち、位置の点がその地点の周辺に表示されるか確認します。
* アプリの図面の向きは GeoSpace の画面と異なって表示されることがあるため、出入口の位置を基準に向きを確認します。
* 静止していても位置の点は少しずつ動きます。立っている場所から大きく外れなければ正常です。

> [!NOTE]
>
> **図面を登録していないフロア**\\
>
> 図面なしで位置の点だけが表示されます。建物・フロアが自動で認識され、「現在地を受信しています」と表示されれば測位は始まっています。
> 正確かどうかは、各ロケーターの真下に立ったときに点が画面上でそのコーナー側に来るかで確認します。

**⑤ ゾーン（Zone）**

* ゾーンは OneS1ght の [空間管理](/ja/console/areas) で追加できます。
* OneS1ght で登録すると、すぐに図面上に登録されたゾーン（Zone）が表示されます。

**⑥ 下部の状態表示と \[ログを見る]**

下部に測位の状態（「現在地を確認しています」など）が表示されます。

**権限がない場合**

![位置情報の権限がない場合の画面（測位を開始できませんの案内と設定を開くボタン）](https://mintcdn.com/onecheck/5u3BErG_mEDOJqyL/images/demo/8.verify-app-permission-denied.png?fit=max\&auto=format\&n=5u3BErG_mEDOJqyL\&q=85\&s=42948ee4670822a8bc3b07352e6a6272)

| 状態 | 表示 | 対応 |
| - | - | - |
| 位置情報の権限なし | ·「測位を開始できません」の画面が表示 | ·\[設定を開く] をクリックして位置情報へのアクセスを許可 |
| Bluetooth オフ | ·「Bluetooth をオンにしてください。ロケーターを探すには Bluetooth が必要です。」と表示 | ·Bluetooth をオンにしてから進める |

**(5) ログを見る**

下部の \[ログを見る] をクリックすると、測位の進行状況とゾーン（Zone）の進入・退出イベントを
時系列で確認できるイベントパネルが開きます。

![イベントパネル（イベント一覧と削除・拡大・閉じるボタン）](https://mintcdn.com/onecheck/5u3BErG_mEDOJqyL/images/demo/8.verify-app-event-log.png?fit=max\&auto=format\&n=5u3BErG_mEDOJqyL\&q=85\&s=ecf6d7260a0664a6247c751b355cb36f)

![イベントパネルの拡大画面（すべて・お知らせ・入った・出たのフィルターとイベントログ）](https://mintcdn.com/onecheck/5u3BErG_mEDOJqyL/images/demo/8.verify-app-event-log-expand.png?fit=max\&auto=format\&n=5u3BErG_mEDOJqyL\&q=85\&s=32e3dfc0cc9efaa21a548c99e0b793cc)

| 区分 | 機能 |
| - | - |
| ① イベント一覧 | ·測位開始、ロケーター発見、ゾーンの進入・退出イベントを時系列で表示 |
| ② 削除ボタン | ·イベント一覧を削除 |
| ③ 拡大ボタン | ·パネルを広く展開 |
| ④ 閉じるボタン | ·パネルを閉じる |
| ⑤ フィルター | ·すべて・お知らせ・入った・出たのイベントを区分して表示 |

## 5) 測位が正常でない場合

以下の表で、**画面がどのように見えるか**を先に探し、該当するトラブルシューティングの項目に移動します。

| このように見える場合 | 最も多い原因 | リンク |
| - | - | - |
| 点がまったく表示されない | ·クラスター未適用·UWB 非対応の機器 | [トラブルシューティング](/ja/locator/troubleshooting#アプリに位置の点が表示されない) |
| 「ロケーター信号が見つかりません」の画面が表示される | ·検知エリアからの離脱·ロケーター信号の問題 | [トラブルシューティング](/ja/locator/troubleshooting#ロケーター信号が見つからないと表示される) |
| ロケーターの真下に立ったのに、点が**別のコーナー**に表示される | ·座標の入力ミス、またはロケーターを図面上の別の位置に配置 | [トラブルシューティング](/ja/locator/troubleshooting#位置が実際と異なる場所に表示される) |
| 点が**片側にずっと偏って**表示される | ·基準点の位置または基準方向が実際と異なる | [トラブルシューティング](/ja/locator/troubleshooting#位置が実際と異なる場所に表示される) |
| 数歩動いただけなのに、点は**はるかに遠く、または少しだけ**移動する | ·図面のスケールが実際の寸法と異なる | [トラブルシューティング](/ja/locator/troubleshooting#移動距離が実際と合わない) |
| 立ち止まっているのに、点が**その場で激しく飛ぶ** | ·金属の干渉·ロケーターの設置高さ不足 | [トラブルシューティング](/ja/locator/troubleshooting#位置が大きく揺れたり飛んだりする) |

## 6) 収集データの確認

検証アプリで測位が動作したら、収集された座標が OneS1ght に蓄積されているかをコンソールで確認します。
OneS1ght コンソールの \[データソース] → 「測位データ（モバイル）」で、データ状況の状態が **Active** で、測位座標の件数が検証前より増えているか確認します。
元の座標データとゾーンイベントを照会またはダウンロードする方法は、[モバイル測位データの照会](/ja/console/data-sources/mobile-positioning) を参照してください。

## チェックリスト

> [!NOTE]
>
> 以下の項目がすべて確認できたら、測位インフラの構築は完了です。
>
> | # | 確認項目 | 確認 |
> | - | - | :-: |
> | 1 | 設置したロケーター4台の LED がすべて点灯しています。 （上部 LED: 緑、下部 LED: 青。クラスターの「構築完了」後は下部が点滅していても正常） | ☐ |
> | 2 | 連携状態のバッジが「接続済み」と表示されます。 | ☐ |
> | 3 | 画面に現在地を示す点が表示され、移動に合わせて動きます。 | ☐ |
> | 4 | 空間管理の画面で、GeoSpace にアップロードした実際の図面が表示されます。（図面を登録した場合） | ☐ |
> | 5 | 検証アプリに現場の図面が正常に表示されます。（図面を登録した場合） | ☐ |
> | 6 | 四隅の位置で、位置を示す点が図面上の同じ位置に表示されます。（図面を登録した場合） | ☐ |
> | 7 | 検証アプリで建物・フロアが自動で認識され、「現在地を受信しています」と表示されます。（図面を登録していない場合） | ☐ |
> | 8 | 各ロケーターの真下に立ったとき、位置を示す点が画面上でそのコーナー側に表示されます。（図面を登録していない場合） | ☐ |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.