> ## 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. 공간 등록](/locator/spaces) |
| 로케이터 설치 및 좌표 반영 완료 | [6. 측위 기능 활성화](/locator/placement) |
| 파트너 키 발급 및 OneS1ght 등록 완료 | [7. 측위 정보 연동](/locator/connect) |

> [!CAUTION]
>
> 위 항목이 완료되지 않으면 건물·층이 표시되지 않거나 '도면 미연동 건물' 또는
> '측위 공간 연동 오류'가 표시될 수 있습니다. 연동 상태는
> [설정 · 측위 연결](/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 로그인이 처음인 경우 [시작하기(초대·로그인)](/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 영역판정](/console/areas#5-sdk-영역판정)을 참고합니다.

> [!NOTE]
>
> 선택한 존은 마우스로 조정할 수 있습니다.
>
> * 존 안쪽을 선택한 후 마우스 드래그로 위치를 이동할 수 있습니다.
> * 모서리의 조절점을 드래그하면 크기와 모양이 바뀝니다.
>
> 위치 이동이나 영역 조절을 하면 메뉴 상단에 초록색 \[저장] 버튼이 활성화됩니다.

> [!CAUTION]
>
> 위치 이동·크기 조절 등의 편집 내용은 상단의 \[저장 (N)]을 클릭해야 GeoSpace(측위 공간)에 반영됩니다.
> 저장 전까지는 '미반영' 상태로 이 화면에만 저장되며, 괄호 안 숫자가 반영되지 않은 변경 건수입니다.

## 5) SDK 영역판정

존을 선택하면 오른쪽 속성 패널에 존 이벤트 설정 항목이 표시됩니다.
앱 SDK가 해당 존의 진입·이탈을 판정하는 기준이며, [SDK의 `Zone` 필드](/developers/sdk/reference/ios#zone)로 전달됩니다.

| 콘솔 항목 | 설명 | SDK 필드 |
| - | - | - |
| 이벤트 감지 사용 | ·이 존을 이벤트 감지 대상으로 사용할지 여부 | — |
| 확정 중 이동 허용(m) | ·진입을 확정하는 동안 좌표가 이보다 크게 튀면 처음부터 다시 셈 (보통 3) | `inDist` |
| 확정 감지 횟수 | ·존 안 좌표가 이 횟수만큼 이어져야 진입으로 확정 (1 이상) | `inCount` |
| 감지 간격(초) | ·확정 중 좌표 사이가 이보다 벌어지면 다시 셈 (0 = 엔진 기본값) | `inCountInterval` |
| 이탈 유예(초) | ·존을 벗어나거나 신호가 끊긴 뒤 이 시간이 지나야 이탈로 확정 (0 = 엔진 기본값) | `outPeriod` |
| 체류 알림(초) | ·진입 후 이 시간이 지나면 체류 이벤트가 한 번 발생 (비우면 없음) | — |
| 겹칠 때 우선순위 | ·존이 겹칠 때 엔진이 먼저 판정할 순서 (1 이상) | `priority` |
| 진입·이탈 알림 보내기 | ·앱으로 진입·이탈 이벤트를 전달할지 여부 (끄면 체류 이벤트도 발생하지 않음) | `callInout` |

> [!NOTE]
>
> 기본값을 그대로 사용해도 동작합니다.
> 진입이 잘 확정되지 않는 경우 확정 중 이동 허용을 늘리고,
> 경계에서 진입·이탈이 반복되는 경우 이탈 유예를 늘려 조정합니다.

> [!CAUTION]
>
> 존의 범위가 너무 좁으면 측위 오차로 인해 진입·이탈이 반복될 수 있습니다.
> 매대 하나가 아니라 사람이 서서 머무는 범위를 기준으로 지정하십시오.

**시책 연결** (시책 연결 기능은 현재 준비 중입니다.)

선택 대상 · 시책 매핑 패널에서 해당 존에 실행할 시책을 연결합니다.
연결할 시책이 없으면 "연결할 활성 시책이 없습니다"로 표시되며, [시책 관리](/console/agent/action-agents)에서 시책을 먼저 활성화해야 합니다.

## 6) 연결 상태

| 상태 | 의미 | 조치 |
| - | - | - |
| 도면 미연동 건물 | ·건물이 아직 도면과 연결되지 않은 상태 | ·건물 등록이 완료되면 자동으로 표시됨·[3. 공간 등록](/locator/spaces) 완료 여부 확인 |
| 측위 공간 연동 오류 | ·측위 공간 서버에 연결하지 못한 상태 | ·\[다시 시도] 클릭·반복되는 경우 관리자에게 문의 |

## 체크리스트

> [!NOTE]
>
> 아래 항목이 모두 확인되면 존 편집이 완료됩니다.
>
> | # | 확인 항목 | 확인 |
> | - | - | :-: |
> | 1 | 선택한 건물·층의 실제 도면이 표시됩니다. | ☐ |
> | 2 | 존의 이름과 존 형태를 지정했습니다. | ☐ |
> | 3 | \[저장 (N)]을 클릭하여 GeoSpace에 반영했습니다. | ☐ |
> | 4 | 레이어 목록에 존이 표시되고, '미반영' 표시가 남아 있지 않습니다. | ☐ |


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