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

# 空間管理

> 店舗の図面上でゾーンとポイントを編集し、施策をマッピングする測位の作業画面です。

> [!NOTE]
>
> このページは管理者（Manager）以上のみアクセスできます。（権限 `manage`: 最高管理者（Owner）または管理者）

## 1) 概要

空間管理は、店舗の図面上でゾーン（Zone）とポイント（Point）を直接描いて編集する測位の作業画面です。

| 用語 | 説明 |
| - | - |
| ゾーン（Zone） | ·図面上に描く多角形の領域·GeoSpace にそのまま反映され、分析・施策の実行対象として使用 |
| ポイント（Point） | ·スタンド看板・試食台・エンドキャップなど、店舗内の特定の地点·OneS1ght で定義する分類 |

## 2) 開始前の確認

空間管理は、GeoSpace に登録された図面とロケーターを基準に動作します。
以下の項目がすべて完了していないと、実際の店舗図面上でゾーンとポイントを編集できません。

| 確認項目 | ドキュメント |
| - | - |
| 建物・フロアの登録と図面スケール設定の完了 | [3. 空間登録](/ja/locator/spaces) |
| ロケーターの設置と座標反映の完了 | [6. 測位機能の有効化](/ja/locator/placement) |
| パートナーキーの発行と OneS1ght への登録の完了 | [7. 測位情報の連携](/ja/locator/connect) |

> [!CAUTION]
>
> 上記の項目が完了していないと、建物・フロアが表示されないか、「図面未連携の建物」または
> 「測位空間連携エラー」が表示されることがあります。連携状態は
> [設定・測位連携](/ja/console/positioning-data) で確認します。

## 3) 画面構成

![空間管理画面（空間管理メニュー、建物・フロア選択、図面を編集ボタン、編集ツール、図面キャンバス）](https://mintcdn.com/onecheck/5u3BErG_mEDOJqyL/images/geospace/zone-open.png?fit=max\&auto=format\&n=5u3BErG_mEDOJqyL\&q=85\&s=34ea3e490b80892370b33faf1ba53cbe)

**① アクセスメニュー**

OneS1ght（[`console.ones1ght.com`](https://console.ones1ght.com)）にログインした後、
コンソールのサイドバーから \[空間管理] に移動します。\

OneS1ght へのログインが初めての場合は、先に [はじめに（招待・ログイン）](/ja/quickstart) を進めてください。

**② 建物・フロアの選択**

上部で建物とフロアを選択すると、該当フロアの図面が表示されます。

**③ \[図面を編集]**

クリックすると編集モードが有効になり、ゾーンとポイントを描いたり修正したりできます。

> [!NOTE]
>
> 「この階にはアンカー情報が登録されていません」と表示される場合でも、ゾーンの設定は可能です。

**④ 編集ツール**

編集モードを有効にすると、図面の左側に編集ツールが表示されます。
各ツールの名前は、マウスを乗せると確認できます。

| ツール | 動作 |
| - | - |
| 選択 | ·ゾーン・ポイントを選択して移動・編集·頂点のドラッグ、辺の追加、ダブルクリックで頂点を削除 |
| ゾーンを描く | ·図面上に領域を描く·選択するとツールの横に図形一覧（四角形・円・三角形・ひし形・フリー）が展開·四角形・円・三角形・ひし形: ドラッグするとその大きさで、クリックすると既定の大きさで描画·フリー: 形が一定でない場合に、点を3つ以上打って描く（最後の点をダブルクリック、または最初の点をクリック: 閉じる） |
| ポイントを配置 | ·図面上の指定した位置にポイントを配置 |
| 削除 | ·選択したゾーン・ポイントを削除 |
| 元に戻す・やり直し | ·直前の操作を取り消し、または復元 |
| グリッド・ルーラー | ·図面上のグリッドとルーラーの表示・非表示 |
| スナップ | ·グリッド（0.25 m）と隣のゾーンの辺に吸着 |
| 複製・連続配置 | ·選択したゾーンをコピー、または同じ形を複数配置 |
| 表示（編集の終了） | ·編集を終了して表示モードに切り替え |

**⑤ 図面キャンバス**

店舗の図面が表示される領域です。ズーム（+・−）と倍率が表示され、図面上でゾーン・ポイントを編集します。

**⑥ レイヤー・プロパティパネル**

![レイヤー・プロパティパネル（現在（編集中）のゾーン一覧と選択したゾーンの基本情報・ゾーンイベント設定）](https://mintcdn.com/onecheck/5u3BErG_mEDOJqyL/images/geospace/zone-panel.png?fit=max\&auto=format\&n=5u3BErG_mEDOJqyL\&q=85\&s=f5bd69750f703d00fe9bac5388fcdb8f)

> [!NOTE]
>
> プロパティパネルは、作成済みのゾーンを選択したときに有効になります。

| パネル | 説明 |
| - | - |
| 現在（編集中） | ·該当フロアのゾーン・ポイント一覧·ゾーンがない場合は「ゾーンがありません。」と表示 |
| プロパティ・基本情報 | ·選択したゾーンのゾーン名とゾーン種別を編集 |
| プロパティ・ゾーンイベント設定 | ·進入・退出の判定と通知の設定·項目ごとの意味は [5) SDKエリア判定](#5-sdkエリア判定) を参照 |

**ゾーン種別**

| 種別 | 値 |
| - | - |
| 入口 | `entrance` |
| プロモーション | `promo` |
| 売場 | `aisle` |
| レジ | `checkout` |
| 戦略商品 | `strategic` |
| 混雑管理 | `congestion` |

* \[新しい種別を追加…] を選択すると、組織で使用する種別を独自に作成できます。

**ポイント種別**

| 種別 | 値 |
| - | - |
| スタンド看板 | `signage` |
| 試食台 | `sampling` |
| エンドキャップ | `endcap` |
| その他 | `other` |

## 4) ゾーンの作成

\[図面を編集] をクリックして編集モードを有効にしてから進めます。

![ゾーン作成の過程（ゾーンを描くツール、図形一覧、新しいゾーンを作成ポップアップ）](https://mintcdn.com/onecheck/5u3BErG_mEDOJqyL/images/geospace/zone-draw.png?fit=max\&auto=format\&n=5u3BErG_mEDOJqyL\&q=85\&s=aa4dcc79dfa92a4ce72f0f3eb9a79e99)

1. \[ゾーンを描く] をクリックします。

2. 図形を選択した後、図面キャンバスでゾーンを作成する位置を指定してドラッグし、描きます。
   * 形が一定でない場合はフリーを選択し、まっすぐ揃えたい場合はスナップをオンにします。
   * フリーの図形は、キャンバスで表示したい領域に沿って点を3つ以上打った後、
     最後の点の位置でダブルクリックするか、最初に打った点をクリックして領域を閉じます。
     領域を閉じると、手順3と同じ「新しいゾーンを作成」ポップアップが表示されます。

3. 「新しいゾーンを作成」ポップアップにゾーン名（例: 入口、レジ、A-1）を入力し、\[作成] をクリックします。\

   同じフロアでゾーン名は重複できません。

![作成したゾーンが選択された画面（図面上のゾーンと実際のサイズ、プロパティパネルの基本情報・ゾーンイベント設定）](https://mintcdn.com/onecheck/5u3BErG_mEDOJqyL/images/geospace/zone-properties.png?fit=max\&auto=format\&n=5u3BErG_mEDOJqyL\&q=85\&s=8fd7395ee2d92a4ba65508f8a7814a87)

4. **ゾーン作成の確認**
   * 作成したゾーンが図面とレイヤー一覧に表示されているか確認します。
     キャンバスにゾーンの実際のサイズ（例: 2.0 m × 1.2 m）が表示されるため、範囲を確認できます。
   * ゾーンを選択するには、左側の編集ツールが選択ツールの状態になっている必要があります。
     ゾーンをクリックすると、右側のプロパティパネルが開きます。
   * ゾーン種別は既定値の売場（`aisle`）で作成されるため、用途に合わせて変更します。
   * プロパティのゾーンイベント設定は、既定値のままでも動作します。
     項目ごとの意味は [5) SDKエリア判定](/ja/console/areas#5-sdkエリア判定) を参照してください。

> [!NOTE]
>
> 選択したゾーンはマウスで調整できます。
>
> * ゾーンの内側を選択した後、マウスのドラッグで位置を移動できます。
> * コーナーのハンドルをドラッグすると、サイズと形が変わります。
>
> 位置の移動や領域の調整を行うと、メニュー上部に緑色の \[保存] ボタンが有効になります。

> [!CAUTION]
>
> 位置の移動・サイズ調整などの編集内容は、上部の \[保存 (N)] をクリックして初めて GeoSpace（測位空間）に反映されます。
> 保存するまでは「未反映」の状態でこの画面にのみ保存されており、括弧内の数字が反映されていない変更の件数です。

## 5) SDKエリア判定

ゾーンを選択すると、右側のプロパティパネルにゾーンイベント設定の項目が表示されます。
アプリ SDK がそのゾーンの進入・退出を判定する基準で、[SDK の `Zone` フィールド](/ja/developers/sdk/reference/ios#zone)として渡されます。

| コンソール項目 | 説明 | SDK フィールド |
| - | - | - |
| イベント検知を使う | ·このゾーンをイベント検知の対象にするかどうか | — |
| 確定中の移動許容(m) | ·進入を確定している間に座標がこれより大きく跳ぶと、最初から数え直す（通常は 3） | `inDist` |
| 確定検知回数 | ·ゾーン内の座標がこの回数連続すると進入と確定（1 以上） | `inCount` |
| 検知間隔(秒) | ·確定中に座標の間隔がこれより開くと数え直す（0 = エンジン既定値） | `inCountInterval` |
| 退出猶予(秒) | ·ゾーンを出るか信号が途切れた後、この時間が経つと退出と確定（0 = エンジン既定値） | `outPeriod` |
| 滞留通知(秒) | ·進入後この時間が経つと滞留イベントが1回発生（空欄の場合はなし） | — |
| 重なり時の優先度 | ·ゾーンが重なるときにエンジンが先に判定する順序（1 以上） | `priority` |
| 進入・退出通知を送る | ·アプリに進入・退出イベントを渡すかどうか（オフにすると滞留イベントも発生しない） | `callInout` |

> [!NOTE]
>
> 既定値のまま使用しても動作します。
> 進入がなかなか確定しない場合は「確定中の移動許容」を増やし、
> 境界で進入・退出が繰り返される場合は「退出猶予」を増やして調整します。

> [!CAUTION]
>
> ゾーンの範囲が狭すぎると、測位誤差によって進入・退出が繰り返されることがあります。
> 棚1本ではなく、人が立って滞在する範囲を基準に指定してください。

**施策連携**（施策連携機能は現在準備中です。）

選択対象・施策マッピングのパネルで、そのゾーンで実行する施策を連携します。
連携する施策がない場合は「連携できる有効な施策がありません」と表示され、[施策管理](/ja/console/agent/action-agents) で先に施策を有効化する必要があります。

## 6) 接続状態

| 状態 | 意味 | 対応 |
| - | - | - |
| 図面未連携の建物 | ·建物がまだ図面と連携されていない状態 | ·建物の登録が完了すると自動で表示される·[3. 空間登録](/ja/locator/spaces) の完了有無を確認 |
| 測位空間連携エラー | ·測位空間サーバーに接続できなかった状態 | ·\[再試行] をクリック·繰り返される場合は管理者に問い合わせ |

## チェックリスト

> [!NOTE]
>
> 以下の項目がすべて確認できたら、ゾーンの編集は完了です。
>
> | # | 確認項目 | 確認 |
> | - | - | :-: |
> | 1 | 選択した建物・フロアの実際の図面が表示されます。 | ☐ |
> | 2 | ゾーンの名前とゾーン種別を指定しました。 | ☐ |
> | 3 | \[保存 (N)] をクリックして GeoSpace に反映しました。 | ☐ |
> | 4 | レイヤー一覧にゾーンが表示され、「未反映」の表示が残っていません。 | ☐ |


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