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

# 6. 測位機能の有効化

> ロケーターの設置位置を測定して図面に反映し、クラスターを構成・適用して測位機能を有効化します。

> [!NOTE]
>
> このステップでは、ハードウェア選択、位置配置、クラスター設定のみを行います。
> 本マニュアルで説明していないその他の領域やボタンは使用しないでください。

> [!NOTE]
>
> **このステップで使うメニュー**\\
>
> * **ロケーターをこのフロアに登録・配置するとき** · 画面右上の **\[構成編集]** を使います。ハードウェア → 位置配置 → クラスターの順に進めます。
>   （登録したロケーターの電源と Wi-Fi がすべてオンになっている必要があります。ハードウェア選択の一覧とクラスターの接続一覧はロケーターの電源・接続状態を基準に表示されるため、
>   始める前に現場でロケーター4台の LED が点灯し、下部 LED が青（サーバー接続成功）であることを確認します。）
> * **すでに「構築完了」したフロアでロケーターの座標だけを修正するとき** · 右上の **\[位置調整]** を使います。
>   [4) 構築完了後に座標だけを修正するとき](#4-構築完了後に座標だけを修正するとき) を参照してください。

![図面配置・無線設計画面（メニューに入り建物・フロアを選択し、構成編集をクリック）](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/6.placement-deploy-open.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=03cef63cf34f909aa61731d05a5b4a8b)

\[図面配置・無線設計] メニューに入り、建物とフロアを選択して、画面右上の \[構成編集] ボタンをクリックします。\[構成編集] をクリックすると、右側にハードウェア → 位置配置 → クラスターの3ステップの設定ウィザードが表示されます。

> [!NOTE]
>
> **図面を登録していない場合**\\
>
> [3. 空間登録](/ja/locator/spaces) で図面を登録していないフロアは、配置画面に図面の代わりに空白の画面が表示されます。
> 手順は図面がある場合と同じで、空白の画面上の任意の場所にロケーターを置いたあと、**「配置済み」一覧で X・Y・Z の値を実測値で直接入力**します。
> 基準ロケーターを (0, 0) とし、ロケーター間の座標の差が実測距離と一致するように入力します。

## 1) ハードウェア選択

![ハードウェア選択（オンライントグルが ON のロケーター一覧とこのフロアの登録一覧）](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/6.placement-deploy-hardware.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=0f63eadac2b910e5c08dd138686f18ac)

1. ハードウェア選択の一覧で配置するロケーターをクリックすると、「このフロアに登録」の一覧に追加されます。

2. 追加したロケーターが「このフロアに登録」の一覧に表示されていることを確認し、\[次へ] をクリックして次のステップに進みます。

> [!NOTE]
>
> 一覧には、以下の条件を満たすロケーターのみ表示されます。
>
> 1. [ハードウェア登録](/ja/locator/hardware) が完了しているロケーター
> 2. 該当フロアの図面にまだ配置されていないロケーター
> 3. ハードウェア選択の一覧の検索ボックス右側にある **「オンライン」スイッチ** がオンのときに表示されるロケーター
>
> ロケーターが一覧に表示されない場合は、上記の条件を確認してください。\\
>
> 「オンライン」スイッチがオフの場合は一覧から除外されることがあるため、配置のステップではオンにしておきます。

> [!NOTE]
>
> **構成を初期化した後にロケーターが見当たらない場合**\\
>
> ステップ表示（1 ハードウェア・2 位置配置・3 クラスター）の右端にある赤いゴミ箱をクリックすると、このフロアの構成が初期化され、このフロアに登録したロケーターの一覧が空になります。
> 初期化しても、ロケーターの [ハードウェア登録](/ja/locator/hardware) は削除されず、\[ハードウェア管理] の一覧にそのまま残ります（一覧でどのフロアに配置されているかも確認できます）。
> ロケーターが消えたと勘違いして再度プロビジョニングせず、ハードウェア選択の一覧でロケーターをもう一度クリックして、このフロアに追加します。

## 2) 位置配置

> [!NOTE]
>
> [1. 設置前の準備](/ja/locator/site-survey) のステップで確認した空間のサイズ、現場で測定した各ロケーターの設置位置、
> 図面の向きをもう一度確認します。

![位置配置画面（① 配置方式、② 配置待ち・配置済み一覧）](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/6.placement-locator-place.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=120ccd28c62a6f628429a59a7c1b8433)

**(1) 配置方式の確認**

画面右側で、配置方式が \[手動配置] に選択されていることを確認します。

* 自動配置は現在準備中の機能のため、使用しません。

**(2) 図面への配置**

「配置待ち」一覧からロケーターを選択して図面に配置します。ロケーターを図面上の実際の設置位置にドラッグするか、一覧でロケーターを選択した後、図面上の該当位置をクリックします。配置されたロケーターは「配置済み」一覧に移動し、配置した位置の座標が自動で表示されます。

* 設置前の準備のステップで設定した基準方向に沿って、左下のコーナーが座標の基準点（概念上の 0, 0）になります。
* 右へ行くほど X 座標が増加し、「上辺」へ行くほど Y 座標が増加するため、空間内の座標はすべて正の値で表示される必要があります。

表示されたロケーターの座標を [設置前の準備のステップで測定した実測距離](/ja/locator/site-survey#3-現場実測) と比較し、実測した距離に合うように座標を修正します。たとえば、左右に向かい合う2台のロケーターの X 座標の差は、その2台の間の実測した幅の距離と一致する必要があります。

* ロケーターを図面のコーナーに配置すること自体が重要なのではありません。基準点を基準に、実測したロケーター間の距離を座標に反映し、その結果が図面上の実際の設置位置と一致するように配置することが重要です。

* 座標を実測値に合わせて調整したとき、図面に表示されたロケーターの位置が実際の設置位置と目に見えてずれている場合は、図面のスケールが合っていません。この場合は [3. 空間登録](/ja/locator/spaces#3-図面の登録と設定（任意）) に戻って正確な図面を登録し、2点でのスケール設定をやり直します。

実際の空間は完全な四角形でないことが多いため、ロケーター間の距離が互いに異なることがあります。この場合は各ロケーターの座標を微調整し、実測値と最大限一致するように設定します。実際に測位が正常に動作するかは [8. 動作検証](/ja/locator/verify) で確認できます。

> [!NOTE]
>
> **オフセット**\\
>
> 画面の座標は、実際の空間ではなく登録された図面画像を基準に認識されます。
> そのため、図面に正確な空間だけが描かれているのではなく、壁の厚みやその他の余白が含まれている場合は、
> 図面上で実際の空間に合わせて配置すると、基準点の座標が (0, 0) ではなく (0.4, 0.25) のように表示されることがあります。
> このときの概念上の基準点の座標と図面上の座標の差をオフセットと呼びます。
> 重要なのは、各ロケーターの座標間の距離が実際の実測距離と一致しているかどうかです。

> [!NOTE]
>
> **座標入力の例**\\
>
> 幅 10 m × 奥行き 10 m × 高さ 3 m を基準に、左下を基準点とした場合
>
> ![左下を基準点とした 10 m × 10 m の空間と4台のロケーターの X・Y・Z 座標](https://mintcdn.com/onecheck/ejvlLb-qx5RrYDZL/images/geospace/6.placement-coord-room-ja.svg?fit=max\&auto=format\&n=ejvlLb-qx5RrYDZL\&q=85\&s=e2d5325d2c3e2ad8389e86301a50172b)
>
> | ロケーターの位置 | X | Y | Z |
> | - | - | - | - |
> | 左下（基準点） | 0 | 0 | 3 |
> | 右下 | 10 | 0 | 3 |
> | 左上 | 0 | 10 | 3 |
> | 右上 | 10 | 10 | 3 |

> [!NOTE]
>
> 一覧右上の鉛筆アイコンをクリックすると、図面に配置したロケーターの名前を変更できます。
> 初期値は S/N（例: `GP26CAN500-00043`）で、設置位置を識別できる名前に変更しておくと、
> 以降の座標確認の過程で照合しやすくなります。
>
> * この名前は該当フロアの図面配置にのみ適用され、[ハードウェア管理](/ja/locator/hardware) に登録された機器情報は変更されません。

**(3) 設置高さの入力**

![配置完了画面（基本設置高さと配置済み一覧の x・y・z 値）](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/6.placement-complete-example.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=bb49125597de66bbebccbf98a544f6a0)

「配置済み」一覧の上にある **基本設置高さ(m)** に設置高さを入力し、\[一括適用] をクリックすると、すべてのロケーターに同じ値が適用されます。

* 高さが異なるロケーターがある場合は、該当行の **z(m)** の値のみ個別に修正します。
* 上の図は、ロケーターごとに設置高さが少しずつ異なるため、z の値を個別に修正した例です。

> [!NOTE]
>
> 図面を変更したり、最初に設定した基準方向を変更したりすることもできます。たとえば反時計回りに 90° 変更して、
> これまでの右側の壁を「上辺」に設定することもできます。その場合は図面画像を差し替え、変更後の基準方向に沿って
> 基準点（0, 0）の位置も設定し直す必要があるため、上記の過程をすべて最初からやり直します。
>
> ![同じ店舗で基準方向を90度回して設定した場合、基準点のコーナーが A から D に変わる比較図](https://mintcdn.com/onecheck/ejvlLb-qx5RrYDZL/images/geospace/6.placement-coord-north-rotated-ja.svg?fit=max\&auto=format\&n=ejvlLb-qx5RrYDZL\&q=85\&s=c8b1ec90fe341b4040a94ec4632e8a06)

ロケーターの座標入力が完了したら、\[次へ] をクリックしてクラスター設定のステップに進みます。

## 3) クラスター

> [!NOTE]
>
> **開始前の確認**\\
>
> 配置したロケーターがすべて **接続状態** である必要があります。
> 接続されたロケーターのみクラスターに登録されるため、画面上でグレー（未接続）と表示されるロケーターは除外されます。
> 電源と Wi-Fi 接続を確認し、下部 LED が青になってから進めます。

クラスタリングは、複数のロケーターをひとつの送出グループ（クラスター）として構成する作業で、クラスタリングを完了して初めてロケーターが測位信号を送出します。

同じクラスターに属するロケーターは、マスターロケーターが送る信号を基準に互いの時刻を同期します。
測位は各ロケーターの信号がモバイル端末に到着した時間差で計算されるため、
時刻が同期されたロケーターの信号だけをひとつの計算に使用できます。

**(1) 登録された機器の確認**

![登録された機器の確認（クラスター対象カードのロケーター一覧と接続状態）](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/6.placement-cluster-connection-list.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=72e168f063028e45a73911907f16ff0f)

クラスタータブに入ると、登録されたロケーターの一覧が表示されます。
ロケーター一覧では、該当フロアに配置された各ロケーターの接続状態を確認できます。

* 一覧に該当フロアに配置したロケーターがすべて表示されているか確認し、現場で各ロケーターの電源状態を確認します。
* 一覧の上部には「接続（直近1分以内）された装置のみクラスター対象に含まれます。未接続の機器はグレーで表示され、除外されます。」という案内が表示されます。
* 未接続（グレー）と表示されるロケーターがある場合は、電源と Wi-Fi 接続を確認して接続状態にしてから進めます。
  未接続のまま進めると、そのロケーターはクラスターから外れ、測位に使われません。
* **\[次へ]** をクリックしてクラスター構成に進みます。

**(2) クラスター構成**

クラスター構成は2段階で進めます。まず **\[自動クラスター構成]** で基準距離を入力してグループを生成します。
その後 **\[手動クラスター構成]** で生成されたグループを確認し、セッションID とマスターロケーターを指定します。
（マスターロケーター（INP）とセッションID の意味は [0. 概要](/ja/locator/overview#3-用語) を参照）

> [!CAUTION]
>
> マスターロケーターとセッションID の値は、サービス導入時にメールなどで別途ご案内します。
> 任意に指定せず、事前に案内された値を入力してください。
> 案内が届いていない場合は [support@ones1ght.com](mailto:support@ones1ght.com) までお問い合わせください。

**① 自動クラスター構成**

入力した距離を基準に、システムがクラスターを一次構成します。

![自動クラスター構成（① 図面上で対角線 14.85 m を測定、② 基本タイプ・クラスター構成距離 15・実行）](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/6.placement-cluster-auto-config.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=17a82e6df08142e614df6a7f5d301bbc)

図面右上の **メジャー（距離測定）** ボタンをクリックした後、対角線上に向かい合う2台のロケーターを順にクリックします。**Enter** を押すと測定が終了し、2点間の距離が図面に表示されます。（例: 14.85 m）

**基本タイプ**が **\[装置配置基準]** に選択されていることを確認します。

> [!NOTE]
>
> 基本タイプの \[距離データ基準] は現在準備中の機能のため、使用しません。
> 本ドキュメントの手順は \[装置配置基準] を基準に作成されています。

**\[クラスター構成距離(m)]** に、測定した対角線の距離より少し大きい値を入力します。（例: 測定値 14.85 m → 15 を入力）

* **\[推奨]** をクリックすると、余裕を持たせた値が自動で入力されます。

> [!NOTE]
>
> **クラスター構成距離**\\
>
> 配置したロケーターをひとつのクラスターにまとめるために設定する値です。設定した距離以内にあるロケーターが
> ひとつのクラスターとして構成されます。そのため、ロケーター4台をひとつのクラスターにまとめるには、最も離れた
> 2台のロケーター間の距離（対角線の距離）を基準に設定し、すべてのロケーターが確実に含まれるよう、
> 測定した距離より少し大きめに入力します。

最後に **\[自動クラスター構成実行]** をクリックすると、**\[手動クラスター構成]** 画面が表示されます。

**② 手動クラスター構成**

続いて **\[自動クラスター構成]** の結果を確認し、最終反映します。

![手動クラスター構成（クラスターツリー: セッションID、P マスター表示、鉛筆、編集初期化、保存）](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/6.placement-cluster-config.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=d9a730bc8d7a7243380642f43c6dcde0)

グループ行の **セッションID** 入力欄に、案内された値を入力します。

クラスターツリーの**鉛筆アイコン**をクリックして、マスターロケーターを設定します。マスターロケーターは任意に指定できず、必ず事前に案内されたロケーターを指定してください。

* ロケーター一覧でロケーターを選択すると、そのロケーターに **P** マークが表示され、マスターロケーターとして指定されます。
* マスターロケーターは、クラスターごとに1台のみ指定できます。

その他の主なボタンは次のとおりです。

| ボタン・項目 | 位置 | 機能 |
| - | - | - |
| \[+] | クラスターツリー最上部のタブ行の右端 | ·セッションID が異なる新しい P グループ（タブ）を追加·基本構成（ロケーター4台・クラスター1個）では使用しない |
| \[+] | グループ行（セッションID の横） | ·同じグループ内にクラスターを追加·基本構成では使用しない |
| チェックボックス | グループ行・クラスター行 | ·図面に表示するかどうか |
| ゴミ箱・✕ | グループ行・クラスター行 | ·削除。\[保存] をクリックすると反映 |
| \[保存] | クラスターツリー右上 | ·編集内容を反映。項目を修正するたびにクリック（セッションID 入力後に1回、マスター指定後に1回） |
| \[編集初期化] | クラスターツリー右上 | ·最後に保存した状態に戻す。保存前の編集内容のみ取り消し |
| \[全削除] | クラスター構成右上 | ·クラスター構成をすべて削除。\[自動クラスター構成] から再度進行 |

**(3) 適用**

**\[装置適用]** をクリックすると、設定内容がロケーターに反映されます。保存されていない変更がある場合は、先に保存の案内が表示されます。

* 未接続ロケーターの警告が表示された場合、そのロケーターはクラスターから外れます。電源と Wi-Fi 接続を確認して接続状態にしてから、再度適用します。
* 適用が完了したら **\[完了]** をクリックします。
* 実際に測位が動作するかどうかは [8. 動作検証](/ja/locator/verify) で確認します。

装置適用後の状態は、次のように表示されます。

| 状態 | 意味 | 対応 |
| - | - | - |
| 構築完了 | ·設定がロケーターに反映された状態 | ·次のステップに進む |
| 未適用 | ·構成のみ保存され、まだ反映されていない状態 | ·\[装置適用] を実行 |
| 設定失敗 | ·一部のロケーターへの反映に失敗（フロアの状態が「要設定確認」と表示） | ·ロケーターの電源・接続状態を確認して再適用·失敗が繰り返される場合は [8. 動作検証](/ja/locator/verify) で実際の測位動作から判断 |

> [!NOTE]
>
> 初回は、状態が **「構築完了」** になって初めて登録が完了します。
> 「未適用」や「要設定確認」のままの場合は、電源と Wi-Fi 接続を確認して再度適用します。
> 実際に測位が動作するかどうかは [8. 動作検証](/ja/locator/verify) で確認します。

> [!NOTE]
>
> **クラスター適用後にロケーターを変更した場合**\\
>
> クラスター適用は、「これらのロケーターをこの空間の測位エリアとして使う」とサーバーに登録する過程です。
> 一度「構築完了」になれば、その後は Wi-Fi が切れたり LED が点滅したりしても測位は動作し続けます。
> ただし、ロケーターの構成が変わった場合は再度登録が必要です。
>
> * ロケーターを別の空間（フロア）に再登録した場合
> * この空間に別のロケーターを配置、または交換した場合
>
> 電源と Wi-Fi を再接続したあと、(1) 接続状態の確認 → (2) クラスター構成の確認 → (3) \[装置適用] → \[完了] をもう一度進めます。
> グループが変わった場合は、(2) で \[自動クラスター構成] から再度実行し、セッションID とマスターを指定し直します。
> 座標だけを修正する場合は再適用せず、[4) 構築完了後に座標だけを修正するとき](#4-構築完了後に座標だけを修正するとき) を参照してください。

## 4) 構築完了後に座標だけを修正するとき

> [!NOTE]
>
> 位置調整は、クラスター構成が変わらない微調整専用です。ロケーターを追加・交換したり、別のフロアに移動したりした場合は、
> 3\) クラスターの「クラスター適用後にロケーターを変更した場合」のとおり、\[構成編集] → クラスタータブで再度適用します。

クラスターが「構築完了」になったあとにロケーターの座標だけを修正するときは、\[構成編集] ではなく **\[位置調整]** を使います。
クラスター設定と UWB セッションはそのまま維持されるため、測位は中断されず、クラスターを再適用する必要もありません。

![図面配置・無線設計画面（構築完了の状態で右上に表示される位置調整ボタン）](https://mintcdn.com/onecheck/Wf6UKFhI34T5ZSLD/images/geospace/6.placement-adjust-entry.png?fit=max\&auto=format\&n=Wf6UKFhI34T5ZSLD\&q=85\&s=f0a41c1ad0768c6ba91216ea7ccc39bc)

1. \[図面配置・無線設計] で建物とフロアを選択し、画面右上の **\[位置調整]** をクリックします。
   右側のパネルが「位置調整モード・位置微調整専用」に切り替わります。

![位置調整モード（配置済み一覧の x・y・z 入力、位置微調整専用の案内、変更した装置に位置設定をプッシュボタン）](https://mintcdn.com/onecheck/Wf6UKFhI34T5ZSLD/images/geospace/6.placement-adjust-panel.png?fit=max\&auto=format\&n=Wf6UKFhI34T5ZSLD\&q=85\&s=aefb44052cf4d67cbfd5834921601809)

2. 「配置済み」一覧で各ロケーターの **x(m)・y(m)・z(m)** の値を直接修正するか、図面上でロケーターをドラッグします。
   基本設置高さ(m) と \[一括適用] も同じように使えます。**値を変更するとすぐに保存されます**（パネル上部に「保存済み」と表示）。

3. ロケーターが Wi-Fi に接続された状態（下部 LED が青）であれば、パネル最下部の **\[変更した装置に位置設定をプッシュ]** をクリックして
   座標（x・y・z）を装置にも送ります。変更がない場合、ボタンは無効になっています。

> [!NOTE]
>
> **ロケーターの Wi-Fi が切れている場合**\\
>
> プッシュはロケーターの Wi-Fi 接続経路で送られるため、接続が切れていると実行できません。
> 座標は 2 ですでに保存されているため、プッシュを押さずに \[終了] で終えれば問題ありません。

4. **\[終了]** で調整モードを終えます。

## チェックリスト

> [!NOTE]
>
> 以下の項目がすべて確認できたら、次のステップに進めます。
>
> | # | 確認項目 | 確認 |
> | - | - | :-: |
> | 1 | 配置するロケーターをすべて追加しました。 | ☐ |
> | 2 | ロケーターを図面に配置し、事前に設定した基準方向と基準点に沿って、各ロケーターの座標値（X・Y・Z）を実際のロケーターの位置と一致するように設定しました。（図面を登録した場合） | ☐ |
> | 3 | 「配置済み」一覧で、各ロケーターの座標値（X・Y・Z）を実測値どおりに直接入力しました。（図面を登録していない場合） | ☐ |
> | 4 | セッションID とマスターロケーターを設定し、\[装置適用] → \[完了] まで進めて、状態が「構築完了」になりました。 | ☐ |
> | 5 | クラスター構成が変わった場合は、クラスターを再度適用しました。（該当する場合） | ☐ |
> | 6 | 「構築完了」後に座標を修正した場合は、\[位置調整] で修正しました。Wi-Fi 接続状態であればプッシュまで押しました。（該当する場合） | ☐ |


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