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

# 5. 측위 기능 활성화

> 로케이터의 설치 위치를 측정하여 도면에 반영하고, 클러스터를 구성·적용하여 측위 기능을 활성화합니다.

<Info>
  현 단계에서는 하드웨어 선택, 위치 배치, 클러스터 설정만 진행하며,
  이 매뉴얼에서 설명하지 않은 다른 영역이나 버튼은 사용하지 않습니다.
</Info>

<Frame>
  <img src="https://mintcdn.com/onecheck/IlOcLn7Fdb-0IWzX/images/geospace/deploy-open.png?fit=max&auto=format&n=IlOcLn7Fdb-0IWzX&q=85&s=5015b6bfa4b624540872427b3d18f2e5" alt="도면 배치 · 무선 설계 화면 — 메뉴 진입 후 빌딩·층 선택, 구성 편집 클릭" width="4400" height="2617" data-path="images/geospace/deploy-open.png" />
</Frame>

\[도면 배치 · 무선 설계] 메뉴로 진입 후 빌딩과 층을 선택하고, 화면 우측 상단의 \[구성 편집] 버튼을 클릭합니다. \[구성 편집]을 클릭하면 우측에 하드웨어 → 위치 배치 → 클러스터의 3단계 설정 마법사가 표시됩니다.

## 1) 하드웨어 선택

<Frame>
  <img src="https://mintcdn.com/onecheck/IlOcLn7Fdb-0IWzX/images/geospace/deploy-hardware.png?fit=max&auto=format&n=IlOcLn7Fdb-0IWzX&q=85&s=a245c4bcd41f5341c79a0d2086a626ad" alt="하드웨어 선택 — 목록에서 로케이터를 추가하면 이 층 등록에 표시됩니다" width="4400" height="2617" data-path="images/geospace/deploy-hardware.png" />
</Frame>

1. 하드웨어 선택 목록에서 배치할 로케이터의 \[+]를 클릭합니다.

2. 추가한 로케이터가 '이 층 등록' 목록에 표시되는지 확인 후 \[다음]을 클릭해 다음 단계로 진행합니다.

<Info>
  목록에는 아래 조건을 충족하는 로케이터만 표시됩니다.

  1. [하드웨어 등록](/geospace/install#1-하드웨어-등록)이 완료된 로케이터
  2. 해당 층 도면에 아직 배치되지 않은 로케이터
  3. 온라인 토글이 OFF 상태인 로케이터

  로케이터가 목록에 표시되지 않는 경우 위 조건을 확인합니다.<br />
  온라인 토글을 ON으로 변경하면 목록에서 제외될 수 있으므로, 배치 단계에서는
  OFF 상태로 유지합니다.
</Info>

## 2) 위치 배치

<Info>
  [1. 설치 전 준비](/geospace/site-survey) 단계에서 공간의 크기와 현장에서 측정한 각 로케이터의 설치 위치,
  도면의 방향을 다시 한번 확인합니다.
</Info>

<Frame>
  <img src="https://mintcdn.com/onecheck/IlOcLn7Fdb-0IWzX/images/geospace/locator-sw-3-place.png?fit=max&auto=format&n=IlOcLn7Fdb-0IWzX&q=85&s=29182e66b5fbdbf55c592b9b5e435c38" alt="위치 배치 화면 — ① 배치 방식, ② 배치 대기·배치됨 목록" width="4400" height="2617" data-path="images/geospace/locator-sw-3-place.png" />
</Frame>

**(1) 배치 방식 확인**

화면 우측에서 배치 방식이 \[수동 배치]로 선택되어 있는지 확인합니다.

* 자동 배치는 현재 준비 중인 기능이므로 사용하지 않습니다.

**(2) 도면에 배치**

'배치 대기' 목록에서 로케이터를 선택하여 도면에 배치합니다. 로케이터를 도면 위 실제 설치 위치로 드래그하거나, 목록에서 로케이터를 선택한 후 도면의 해당 위치를 클릭합니다. 배치된 로케이터는 '배치됨' 목록으로 이동하며, 배치한 위치의 좌표가 자동으로 표시됩니다.

* 설치 전 준비 단계에서 설정한 기준 방향에 따라 좌측 하단 모서리가 좌표의 기준점(개념적으로 0, 0)이 됩니다.
* 우측으로 갈수록 X 좌표가 증가하고, '윗변'으로 갈수록 Y 좌표가 증가하므로 공간 내 좌표는 모두 양수로 표시되어야 합니다.

표시된 로케이터 좌표를 [설치 전 준비 단계에서 측정한 실측 거리](/geospace/site-survey#3-현장-실측)와 비교하여 실측된 거리에 맞도록 좌표를 수정합니다. 예를 들어, 좌우로 마주 보는 두 로케이터의 X 좌표 차이는 두 로케이터 사이의 실측 가로 거리와 일치해야 합니다.

* 로케이터를 도면의 모서리에 배치하는 것 자체가 중요한 것이 아닙니다. 기준점을 기준으로 실측한 로케이터 간 거리를 좌표에 반영하고, 그 결과가 도면상의 실제 설치 위치와 일치하도록 배치하는 것이 중요합니다.

* 좌표를 실측값에 맞게 조정했을 때 도면에 표시된 로케이터 위치가 실제 설치 위치와 눈에 띄게 어긋난다면 도면의 스케일이 맞지 않는 것입니다. 이 경우 [3. 공간 등록](/geospace/spaces#3-도면-등록-및-설정)으로 돌아가 정확한 도면을 등록한 후 두 점 스케일 설정을 다시 진행합니다.

실제 공간은 완벽한 사각형이 아닌 경우가 많으므로 로케이터 간 거리가 서로 다를 수 있습니다. 이 경우 각 로케이터의 좌표를 미세 조정하여 실측값과 최대한 일치하도록 설정합니다. 실제 측위가 정상적으로 동작하는지는 [7. 동작 검증](/geospace/verify)에서 확인할 수 있습니다.

<Info>
  **오프셋**<br />
  화면의 좌표는 실제 공간이 아닌 등록된 도면 이미지를 기준으로 인식합니다.
  따라서 도면에 정확한 공간만 표시된 것이 아니라 벽 두께나 기타 여백이 표현되어 있는 경우에는
  도면에서 실제 공간에 맞춰 배치하면 기준점 좌표가 (0, 0)이 아니라 (0.4, 0.25)처럼 표시될 수 있습니다.
  이때 개념적인 기준점의 좌표와 도면상의 좌표의 차이를 오프셋이라고 합니다.
  중요한 것은 각 로케이터의 좌표 간 거리가 실제 실측 거리와 일치하는지 여부입니다.
</Info>

<Info>
  **좌표 입력 예시**<br />
  가로 10 m × 세로 10 m × 높이 3 m 기준, 왼쪽 하단을 기준점으로 잡은 경우

  <Frame>
    <img src="https://mintcdn.com/onecheck/IlOcLn7Fdb-0IWzX/images/geospace/coord-room.svg?fit=max&auto=format&n=IlOcLn7Fdb-0IWzX&q=85&s=cc278b2079b772f12c8963b1b6ee4aa1" alt="왼쪽 아래를 기준점으로 잡은 10 m × 10 m 공간과 네 로케이터의 X · Y · Z 좌표" width="1180" height="820" data-path="images/geospace/coord-room.svg" />
  </Frame>

  | 로케이터 위치     | X  | Y  | Z |
  | ----------- | -- | -- | - |
  | 좌측 하단 (기준점) | 0  | 0  | 3 |
  | 우측 하단       | 10 | 0  | 3 |
  | 좌측 상단       | 0  | 10 | 3 |
  | 우측 상단       | 10 | 10 | 3 |
</Info>

<Info>
  목록 우측 상단의 연필 아이콘을 클릭하면 도면에 배치된 로케이터의 이름을 수정할 수 있습니다.
  기본값은 S/N(예: `GP26CAN500-00043`)이며, 설치 위치를 식별할 수 있는 이름으로 변경해 두면
  이후 좌표 확인 과정에서 대조하기 편리합니다.

  * 이 이름은 해당 층의 도면 배치에만 적용되며, [하드웨어 관리](/geospace/install#1-하드웨어-등록)에 등록된 장비 정보는 변경되지 않습니다.
</Info>

**(3) 설치 높이 입력**

<Frame>
  <img src="https://mintcdn.com/onecheck/IlOcLn7Fdb-0IWzX/images/geospace/placement-complete-example.png?fit=max&auto=format&n=IlOcLn7Fdb-0IWzX&q=85&s=41a5c6e607234d5fbcb1050527fe01dc" alt="배치 완료 화면 — 기본 설치높이와 배치됨 목록의 x · y · z 값" width="4400" height="2617" data-path="images/geospace/placement-complete-example.png" />
</Frame>

'배치됨' 목록 위의 **기본 설치높이(m)** 에 설치 높이를 입력하고 \[전체 적용]을 클릭하면 모든 로케이터에 같은 값이 적용됩니다.

* 높이가 다른 로케이터가 있는 경우 해당 행의 **z(m)** 값만 개별로 수정합니다.
* 위 그림은 로케이터마다 설치 높이가 조금씩 달라 z 값을 개별로 수정한 예시입니다.

<Info>
  도면을 변경하거나 최초 설정한 기준 방향을 변경할 수도 있습니다. 예를 들어 반시계 방향으로 90° 변경하여
  기존의 우측 벽을 '윗변'으로 설정할 수도 있습니다. 이때 도면 이미지를 교체하고, 변경된 기준 방향에 따라
  기준점(0, 0)의 위치도 다시 설정해야 하므로 위 과정을 모두 새로 진행해야 합니다.

  <Frame>
    <img src="https://mintcdn.com/onecheck/IlOcLn7Fdb-0IWzX/images/geospace/coord-north-rotated.svg?fit=max&auto=format&n=IlOcLn7Fdb-0IWzX&q=85&s=92ef76403a9998dfdcb30ba66effdc85" alt="같은 매장에서 기준 방향을 90도 틀어 잡았을 때 기준점 모서리가 A에서 D로 바뀌는 비교 그림" width="1200" height="780" data-path="images/geospace/coord-north-rotated.svg" />
  </Frame>
</Info>

<Info>
  **공간이 직사각형이 아닌 경우**<br />
  공간 형태가 불규칙하거나 기둥·집기 등으로 인해 벽면 모서리를 기준으로 측정하기 어려운 경우에는
  공간이 아닌 특정 로케이터를 기준점으로 설정하여 위치를 측정할 수 있습니다.

  * 로케이터 #1을 기준점(0, 0)으로 설정합니다.
  * 로케이터 #1에서 #2까지의 거리를 측정합니다. #2의 좌표는 (측정 거리, 0)으로 설정하며, 이 방향을 X축으로 사용합니다.
  * 직사각형 형태로 로케이터를 배치한 경우, 세로 거리를 추가로 측정합니다. #3의 좌표는 (0, 세로 거리), #4의 좌표는 (가로 거리, 세로 거리)로 설정합니다.

  <Frame>
    <img src="https://mintcdn.com/onecheck/IlOcLn7Fdb-0IWzX/images/geospace/site-measure-baseline.svg?fit=max&auto=format&n=IlOcLn7Fdb-0IWzX&q=85&s=e22c1198f95960d0c41de65d99f08098" alt="기준점 로케이터 #1을 정하고 #2까지 로케이터 사이 거리를 레이저로 측정하는 그림" width="1100" height="640" data-path="images/geospace/site-measure-baseline.svg" />
  </Frame>

  <Frame>
    <img src="https://mintcdn.com/onecheck/IlOcLn7Fdb-0IWzX/images/geospace/coord-anchor-origin.svg?fit=max&auto=format&n=IlOcLn7Fdb-0IWzX&q=85&s=e2ebbb92570cde781901e61d5eca8b44" alt="AN-500 4대 배치에서 로케이터 #1을 기준점으로 잡는 방식" width="960" height="600" data-path="images/geospace/coord-anchor-origin.svg" />
  </Frame>

  | 로케이터            | X   | Y   | Z |
  | --------------- | --- | --- | - |
  | AN-500 #1 (기준점) | 0   | 0   | 3 |
  | AN-500 #2       | 7.1 | 0   | 3 |
  | AN-500 #3       | 0   | 5.2 | 3 |
  | AN-500 #4       | 7.1 | 5.2 | 3 |
</Info>

로케이터 좌표 입력을 완료한 후 \[다음]을 클릭하여 클러스터 설정 단계로 이동합니다.

## 3) 클러스터

<Info>
  **시작 전 확인**<br />
  배치한 로케이터의 전원이 모두 켜져 있는지 확인합니다.
  화면에서 회색으로 표시되는 로케이터는 서버와 접속되지 않은 상태를 의미하며,
  현장에서 전원이 켜져 있다면 그대로 진행할 수 있습니다 (아래 장치 적용 참고).
</Info>

클러스터링은 여러 로케이터를 하나의 송출 그룹(클러스터)으로 구성하는 작업이며, 클러스터링을 완료해야 로케이터가 측위 신호를 송출합니다.

같은 클러스터에 속한 로케이터는 마스터 로케이터가 보내는 신호를 기준으로 서로 시각을 맞춥니다.
측위는 각 로케이터의 신호가 모바일 기기에 도착한 시간 차이로 계산되므로,
시각이 맞춰진 로케이터의 신호만 하나의 계산에 함께 사용할 수 있습니다.

**(1) 등록된 기기 확인**

<Frame>
  <img src="https://mintcdn.com/onecheck/IlOcLn7Fdb-0IWzX/images/geospace/cluster-connection-list.png?fit=max&auto=format&n=IlOcLn7Fdb-0IWzX&q=85&s=805377a1c8ce33ede04c33564469026b" alt="등록된 기기 확인 — 클러스터 대상 카드의 로케이터 목록과 접속 상태" width="4400" height="2612" data-path="images/geospace/cluster-connection-list.png" />
</Frame>

클러스터 탭에 진입하면 등록된 로케이터 목록이 표시됩니다.
로케이터 목록에서는 해당 층에 배치된 각 로케이터의 연결 상태를 확인할 수 있습니다.

* 목록에 해당 층에 배치된 로케이터가 모두 표시되는지 확인하고, 현장에서 각 로케이터의 전원 상태를 확인합니다.
* 목록 상단에는 "접속(최근 1분 이내)된 장치만 클러스터 대상에 포함됩니다. 미접속 장비는 회색으로 표시되며 제외됩니다."라는 안내가 표시됩니다.
* 이 안내에 따라 일부 로케이터가 미접속(회색)으로 표시되더라도, 현장에서 해당 로케이터의 LED가 점등되어 있으면 그대로 진행합니다.
* **\[다음]** 을 클릭하여 클러스터 구성으로 이동합니다.

**(2) 클러스터 구성**

클러스터 구성은 두 단계로 진행합니다. 먼저 **\[자동 클러스터 구성]** 에서 기준 거리를 입력하여 그룹을 생성합니다.
이후 **\[수동 클러스터 구성]** 에서 생성된 그룹을 확인하고 세션 ID와 마스터 로케이터를 지정합니다.
(마스터 로케이터(INP)와 세션 ID의 의미는 [0. 개요](/geospace/overview#3-용어) 참조)

<Danger>
  마스터 로케이터와 세션 ID 값은 서비스 도입 시 메일 등을 통해 별도로 안내됩니다.
  임의로 지정하지 말고 사전에 안내받은 값을 입력하십시오.
  안내받지 못한 경우 <span className="support-mail">[onesight-support@onecheck.co.kr](mailto:onesight-support@onecheck.co.kr)</span> 로 문의하십시오.
</Danger>

**① 자동 클러스터 구성**

입력한 거리를 기준으로 시스템이 클러스터를 1차로 구성합니다.

<Frame>
  <img src="https://mintcdn.com/onecheck/IlOcLn7Fdb-0IWzX/images/geospace/cluster-auto-config.png?fit=max&auto=format&n=IlOcLn7Fdb-0IWzX&q=85&s=b144ab1fd3c9bfee7a6ddb051c5dd1ef" alt="자동 클러스터 구성 — ① 도면 위 대각선 14.85 m 측정, ② 기본타입·클러스터 구성 거리 15·실행" width="4400" height="2612" data-path="images/geospace/cluster-auto-config.png" />
</Frame>

도면 우측 상단의 **줄자(거리 측정)** 버튼을 클릭한 후, 대각선으로 마주 보는 두 로케이터를 차례로 클릭합니다. **Enter** 를 누르면 측정이 종료되고 두 점 사이의 거리가 도면에 표시됩니다. (예: 14.85 m)

**기본타입**이 **\[장치 배치 기반]** 으로 선택되어 있는지 확인합니다.

<Info>
  기본타입의 \[거리데이터 기반]은 현재 준비 중인 기능이므로 사용하지 않습니다.
  본 문서의 절차는 \[장치 배치 기반]을 기준으로 작성되었습니다.
</Info>

**\[클러스터 구성 거리(m)]** 에 측정한 대각선 거리보다 약간 큰 값을 입력합니다. (예: 측정값 14.85 m → 15 입력)

* **\[추천]** 을 클릭하면 여유 있는 값이 자동으로 입력됩니다.

<Info>
  **클러스터 구성 거리**<br />
  배치한 로케이터를 하나의 클러스터로 묶기 위해 설정하는 값입니다. 설정한 거리 이내에 있는 로케이터가
  하나의 클러스터로 구성됩니다. 따라서 로케이터 4대를 하나의 클러스터로 묶으려면, 가장 멀리 떨어진 두
  로케이터 사이의 거리(대각선 거리)를 기준으로 설정하되, 안전하게 모든 로케이터가 포함될 수 있도록
  측정한 거리보다 조금 크게 입력합니다.
</Info>

마지막으로 **\[자동 클러스터 구성 실행]** 을 클릭하면 **\[수동 클러스터 구성]** 화면이 표시됩니다.

**② 수동 클러스터 구성**

이후 **\[자동 클러스터 구성]** 의 결과를 확인하고 최종 반영합니다.

<Frame>
  <img src="https://mintcdn.com/onecheck/IlOcLn7Fdb-0IWzX/images/geospace/cluster-config.png?fit=max&auto=format&n=IlOcLn7Fdb-0IWzX&q=85&s=548e3f4260b8d6a09cb84fb76577d7ad" alt="수동 클러스터 구성 — 클러스터 트리(세션 ID, P 마스터 표시, 연필, 편집 초기화, 저장)" width="4404" height="2621" data-path="images/geospace/cluster-config.png" />
</Frame>

그룹 행의 **세션 ID** 입력칸에 안내받은 값을 입력합니다.

클러스터 트리의 **연필 아이콘**을 클릭하여 마스터 로케이터를 설정합니다. 마스터 로케이터는 임의로 지정할 수 없으며, 반드시 사전에 안내받은 로케이터를 지정해야 합니다.

* 로케이터 목록에서 로케이터를 선택하면 해당 로케이터에 **P** 표시가 나타나며 마스터 로케이터로 지정됩니다.
* 마스터 로케이터는 클러스터마다 한 대만 지정할 수 있습니다.

기타 주요 버튼은 다음과 같습니다.

| 버튼 · 항목   | 위치                     | 기능                                                                                                                                                                                                                                                              |
| --------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| \[+]      | 클러스터 트리 맨 위 탭 줄의 오른쪽 끝 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>세션 ID가 다른 새 P그룹(탭)을 추가</span></span><span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>기본 구성(로케이터 4대 · 클러스터 1개)에서는 사용하지 않음</span></span> |
| \[+]      | 그룹 행 (세션 ID 옆)         | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>같은 그룹 안에 클러스터를 추가</span></span><span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>기본 구성에서는 사용하지 않음</span></span>                         |
| 체크박스      | 그룹 행 · 클러스터 행          | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>도면에 표시할지 여부</span></span>                                                                                                                                                  |
| 휴지통 · ✕   | 그룹 행 · 클러스터 행          | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>삭제. \[저장]을 클릭해야 반영</span></span>                                                                                                                                           |
| \[저장]     | 클러스터 트리 우측 상단          | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>편집 내용을 반영. 항목을 수정할 때마다 클릭 (세션 ID 입력 후 한 번, 마스터 지정 후 한 번)</span></span>                                                                                                     |
| \[편집 초기화] | 클러스터 트리 우측 상단          | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>마지막으로 저장한 상태로 되돌림. 저장하기 전의 편집 내용만 취소</span></span>                                                                                                                         |
| \[전체 삭제]  | 클러스터 구성 우측 상단          | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>클러스터 구성을 모두 삭제. \[자동 클러스터 구성]부터 다시 진행</span></span>                                                                                                                        |

**(3) 적용**

**\[장치 적용]** 을 클릭하면 설정 내용이 로케이터에 반영됩니다. 저장되지 않은 변경 사항이 있는 경우 먼저 저장 안내가 표시됩니다.

* 미접속 로케이터 경고가 표시되는 경우에도 현장에서 전원 상태가 정상임을 확인했다면 \[무시하고 장치 적용]으로 진행할 수 있습니다.
* 적용 완료 후 **\[완료]** 를 클릭합니다.
* 실제 측위 동작 여부는 [7. 동작 검증](/geospace/verify)에서 확인합니다.

장치 적용 후 상태는 다음과 같이 표시됩니다.

| 상태          | 의미                                                                                                                                     | 조치                                                                                                                                                                                                                                                                                    |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 적용됨 (완료 뱃지) | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>설정이 로케이터에 반영된 상태</span></span>                    | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>다음 단계로 진행</span></span>                                                                                                                                                                          |
| 미적용         | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>구성만 저장되고 아직 반영되지 않은 상태</span></span>              | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>\[장치 적용]을 실행</span></span>                                                                                                                                                                       |
| 설정 실패       | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>일부 로케이터에 반영 실패 — 층 상태가 '설정확인필요'로 표시</span></span> | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>로케이터의 전원·접속 상태 확인 후 재적용</span></span><span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>실패가 반복되는 경우 [7. 동작 검증](/geospace/verify)에서 실제 측위 동작으로 판단</span></span> |

<Info>
  장치 적용 후 '클러스터 · 설정확인필요'가 표시되는 경우에도 그대로 진행할 수 있습니다.
  실제 측위 동작 여부는 [7. 동작 검증](/geospace/verify)에서 확인합니다.
</Info>

## 체크리스트

<Note>
  아래 항목이 모두 확인되면 다음 단계로 진행할 수 있습니다.

  | # | 확인 항목                                                                               |  확인 |
  | - | ----------------------------------------------------------------------------------- | :-: |
  | 1 | 배치할 로케이터를 모두 추가했습니다.                                                                |  ☐  |
  | 2 | 로케이터를 도면에 배치하고 사전에 설정한 기준 방향과 기준점에 따라 각 로케이터의 좌표값(X·Y·Z)을 실제 로케이터 위치와 일치하도록 설정했습니다. |  ☐  |
  | 3 | 세션 ID와 마스터 로케이터를 설정하고 \[장치 적용] → \[완료]까지 진행했습니다.                                    |  ☐  |
</Note>
