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

> [!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]
>
> **도면을 등록하지 않은 경우** \\
>
> [공간 등록](/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. [하드웨어 등록](/locator/hardware)이 완료된 로케이터
> 2. 해당 층 도면에 아직 배치되지 않은 로케이터
> 3. 하드웨어 선택 목록의 검색창 오른쪽 **'온라인' 스위치**가 켜져 있을 때 표시되는 로케이터
>
> 로케이터가 목록에 표시되지 않는 경우 위 조건을 확인합니다.\\
>
> '온라인' 스위치가 꺼져 있으면 목록에서 제외될 수 있으므로, 배치 단계에서는 켜 둡니다.

> [!NOTE]
>
> **구성을 초기화한 뒤 로케이터가 보이지 않을 때** \\
>
> 단계 표시줄(1 하드웨어 · 2 위치 배치 · 3 클러스터) 오른쪽 끝의 빨간 휴지통을 클릭하면 이 층의 구성이 초기화되어 '이 층 등록' 목록이 비워집니다.
> 초기화해도 로케이터의 [하드웨어 등록](/locator/hardware)은 지워지지 않고 \[하드웨어 관리] 목록에 그대로 남아 있습니다(목록에서 어느 층에 배치되어 있는지도 확인할 수 있습니다).
> 로케이터가 사라진 것으로 착각해 다시 프로비저닝하지 말고, 하드웨어 선택 목록에서 로케이터를 다시 클릭해 이 층에 추가합니다.

## 2) 위치 배치

> [!NOTE]
>
> [설치 전 준비](/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) 배치 방식 확인**

화면 우측의 배치 방식에서 **\[수동 배치]** 또는 **\[자동 배치]**를 선택할 수 있습니다.

* 사각형 공간에 로케이터 4대를 배치하는 환경에서는 자동 배치를 실행한 뒤에도 도면 테두리에 맞춰 위치를 다시 정렬해야 하므로, 처음부터 도면에 직접 좌표를 입력하는 **\[수동 배치]**가 더 빠르고 정확합니다. 아래 탭에서 원하는 배치 방식을 선택하여 진행합니다.
* **\[자동 배치]**는 넓고 복잡한 공간에 여러 대의 로케이터를 설치할 때, 로케이터끼리 무선 신호로 거리를 측정해 전체적인 배치 틀(상대 위치)을 먼저 잡아주는 기능입니다.

**수동 배치 · 기본**

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

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

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

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

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

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

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

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

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

> [!NOTE]
>
> **좌표 입력 예시** \\
>
> 가로 10 m × 세로 10 m × 높이 3 m 기준, 왼쪽 하단을 기준점으로 잡은 경우
>
> ![왼쪽 아래를 기준점으로 잡은 10 m × 10 m 공간과 네 로케이터의 X · Y · Z 좌표](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/6.placement-coord-room.svg?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=b80bb7186b1aa7a7ff2c4c5ce0911831)
>
> | 로케이터 위치 | X | Y | Z |
> | - | - | - | - |
> | 좌측 하단 (기준점) | 0 | 0 | 3 |
> | 우측 하단 | 10 | 0 | 3 |
> | 좌측 상단 | 0 | 10 | 3 |
> | 우측 상단 | 10 | 10 | 3 |

> [!NOTE]
>
> 목록 우측 상단의 연필 아이콘을 클릭하면 도면에 배치된 로케이터의 이름을 수정할 수 있습니다.
> 기본값은 S/N(예: `GP26CAN500-00043`)이며, 설치 위치를 식별할 수 있는 이름으로 변경해 두면
> 이후 좌표 확인 과정에서 대조하기 편리합니다.
>
> * 이 이름은 해당 층의 도면 배치에만 적용되며, [하드웨어 관리](/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/jSUe4ZC1WxNcJHaZ/images/geospace/6.placement-coord-north-rotated.svg?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=fb0ed1ab5173ca14d9c88a70290c8cc6)

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

**자동 배치**

> [!NOTE]
>
> **시작 전 확인**
>
> * 자동 배치는 로케이터들이 서로 신호를 주고받아 실제 거리를 측정하는 방식이므로, **로케이터를 실제 설치 위치에 부착하고 전원과 Wi-Fi 연결 상태(하단 LED 파랑)를 확인한 뒤** 진행해야 합니다.
> * 현재 네트워크에 접속된 로케이터만 자동 배치 대상에 포함되며, 로케이터 사이에 두꺼운 벽 등 신호를 통과시키지 못하는 장애물이 있으면 거리 측정이 되지 않아 자동 배치가 원활하지 않을 수 있습니다.
> * 로케이터마다 설치 높이가 서로 다른 경우, 높이차를 보정하여 수평 거리를 계산하므로 자동 배치 실행 전에 \[수동 배치] 탭의 '배치됨' 목록에서 각 로케이터의 설치 높이 \*\*z(m)\*\*가 정확히 입력되어 있는지 확인합니다. (기본값: 3 m)

화면 우측의 배치 방식에서 **\[자동 배치]**를 선택하면 상단에 **1 접속 목록 → 2 거리 수집 → 3 자동 배치 → 4 수동 마무리**의 4단계가 표시됩니다.

**(2) 접속 목록 확인**

![자동 배치 접속 목록 확인 화면 (자동 배치 대상 카드의 로케이터 목록과 접속 상태)](https://mintcdn.com/onecheck/tGdGfTl-PD7Qquye/images/geospace/6.placement-auto-connection-list.png?fit=max\&auto=format\&n=tGdGfTl-PD7Qquye\&q=85\&s=dddf894672beae1b1387485c173be313)

'자동 배치 대상' 목록에서 이 층에 등록된 로케이터의 접속 상태를 확인합니다.

* 최근 1분 이내 서버와 통신한 로케이터만 **접속**(초록)으로 표시되며 자동 배치 대상에 포함됩니다.
* 미접속(회색)으로 표시되는 로케이터는 자동 배치에서 제외되므로, 전원과 Wi-Fi 연결을 확인한 뒤 목록 우측 상단의 새로고침 버튼을 클릭해 접속 상태로 만든 후 진행합니다.
* 접속된 로케이터가 2대 이상인지 확인한 후 하단의 **\[다음]**을 클릭합니다.

**(3) 거리 수집**

![자동 배치 거리 수집 화면 (장치간 거리 수집 카드와 거리 데이터 수집 버튼)](https://mintcdn.com/onecheck/tGdGfTl-PD7Qquye/images/geospace/6.placement-auto-distance-collect.png?fit=max\&auto=format\&n=tGdGfTl-PD7Qquye\&q=85\&s=8aba2326236f33c2e3291f7d5bcb0fd0)

설치된 로케이터들이 서로 신호를 주고받아 로케이터 간 직선거리를 측정합니다.

1. **\[거리 데이터 수집]**을 클릭합니다.
   * 로케이터 1대당 60초 이내(4대 기준 전체 약 180 \~ 240초)가 소요되며, 화면에 진행률과 `완료 N/M대`, `거리 취득 K쌍`이 표시됩니다.
   * 수집 중에는 **\[정지]**를 클릭하여 중단할 수 있습니다.
2. 모든 로케이터의 측정이 끝나고 **'수집 완료'**가 표시되면 하단의 **\[다음]**을 클릭합니다.

> [!NOTE]
>
> **일부 로케이터가 계속 미수집되는 경우 / 거리 데이터 직접 입력**
>
> * 로케이터 4대의 위치가 정확히 산출되려면 모든 로케이터 쌍의 거리가 고르게 수집되어야 합니다. 일부 로케이터의 거리 측정이 누락되어 버튼이 주황색 \*\*\[미수집 N대 · 재수집]\*\*으로 표시되면, 해당 버튼을 클릭해 다시 수집합니다.
> * 재수집을 반복해도 미수집 로케이터가 남는 경우에는 아래 두 가지 방법 중 하나로 진행합니다.
>   1. 배치 방식 우측의 **\[장치간 거리데이터]** 버튼을 클릭한 후, 패널 하단의 **\[+ 장치(From) 추가하여 거리 입력]** 또는 목록의 **연필 아이콘**을 클릭해 누락된 로케이터 간 실측 거리(m)를 직접 입력하고 \*\*\[저장]\*\*합니다. (CSV 파일로 업로드할 수도 있습니다.)
>   2. 상단의 **\[수동 배치]** 탭으로 전환하여 도면에 직접 배치합니다. (4대 규모에서는 수동 배치로 전환하는 것이 더 빠릅니다.)

**(4) 자동 배치 및 배경도 정합**

측정된 거리 데이터로 로케이터들의 배치 모양을 먼저 만든 뒤, 이를 도면의 실제 설치 위치에 맞게 옮겨 맞춥니다.

**① 자동 배치 실행 및 결과 확인**

![자동 배치 실행 화면 (장치 자동배치 카드와 자동 배치 실행 버튼)](https://mintcdn.com/onecheck/tGdGfTl-PD7Qquye/images/geospace/6.placement-auto-run.png?fit=max\&auto=format\&n=tGdGfTl-PD7Qquye\&q=85\&s=9a96a11a4501f27915dec1140951f9e7)

1. **\[자동 배치 실행]**을 클릭하면 측정된 거리(최소 3쌍 이상)를 바탕으로 도면 위에 로케이터들이 배치되고, 아래에 **'정합성 검증'** 결과가 함께 표시됩니다.
2. '정합성 검증' 카드에서 측정된 거리와 도면에 찍힌 위치가 얼마나 잘 일치하는지 확인합니다.
   * 오차가 작으면(정합도 95% 이상) 초록색 **'양호'**, 오차가 크면 주황색 **'미흡'**으로 표시됩니다.
3. 결과 배지가 **'미흡'**이거나 도면에 찍힌 로케이터들의 모양이 실제 설치 형태와 다르게 보이면, **\[다시 위치 배치 및 정합성 검증하기]**를 클릭합니다.
   * 클릭할 때마다 기준(출발점)이 되는 로케이터를 바꿔가며 위치를 다시 계산합니다.
   * 여러 번 계산한 뒤 카드 우측의 **\[‹] \[›]** 화살표로 결과를 넘겨보며 실제 설치 모양에 가장 가까운 결과를 선택합니다.

> [!NOTE]
>
> **자동 배치 실행 시 로케이터가 도면(방) 바깥으로 벗어나 표시되는 이유** \\
>
> \[자동 배치 실행]은 도면의 벽선이나 방 영역(박스)을 자동으로 인식하지 않습니다. 첫 번째 로케이터를 **도면 정중앙**에 먼저 배치한 뒤 측정된 거리만큼 나머지 로케이터를 펼쳐서 배치하므로, 실행 직후에는 로케이터들이 도면의 방 바깥으로 벗어나 표시됩니다.
>
> * 로케이터들을 도면의 방 안으로 넣으려면 바로 아래의 **② 배경도 정합 (\[2점지정으로 일괄 배치])** 단계에서 기준 로케이터 2개를 도면 모서리에 맞춰 정렬해야 합니다.
> * 만약 일부 로케이터의 거리 데이터가 누락(미수집)된 상태로 실행하면 정합도는 '양호'로 표시되더라도 네 로케이터의 배치 모양 자체가 사각형으로 만들어지지 않으므로, **2 거리 수집** 단계에서 모든 로케이터 쌍의 거리가 수집(또는 \[장치간 거리데이터]에서 보완)되었는지 먼저 확인합니다.

**② 배경도 정합**

거리 데이터로 산출된 위치는 로케이터 간의 상대적인 간격만 반영된 상태이므로, 배경 도면의 실제 위치와 방향에 맞게 정렬해야 합니다. **\[2점지정으로 일괄 배치]** 또는 **\[수동 배치]** 중 하나를 선택하여 진행합니다.

* **\[2점지정으로 일괄 배치] (기본)**: 도면 위에서 두 로케이터의 실제 설치 위치를 지정하여 전체 배치를 한 번에 맞춥니다.
  1. **기준점 1**: 첫 번째 기준이 될 로케이터를 목록(또는 도면)에서 선택한 후, 우측의 **지도핀 아이콘**을 도면 위 실제 설치 위치로 드래그하거나 도면의 해당 위치를 클릭합니다. 모든 로케이터가 함께 이동합니다.
  2. **기준점 2**: 두 번째 로케이터를 선택하면 도면 위에 기준점 1로부터 측정 거리만큼의 가이드 원이 표시됩니다. 우측의 **지도핀 아이콘**을 가이드 원 위로 드래그하거나 원 근처를 클릭하면 원 위로 자동 스냅되며, 기준점 1을 축으로 전체 로케이터가 회전합니다.
  3. **축 반전 선택**: 두 기준점을 잇는 선을 축으로 나머지 로케이터의 위치가 실제와 맞는지 확인합니다. 실제 위치와 같으면 **\[현재 그대로]**를 클릭하고, 거울상(반대편)으로 뒤집혀 있으면 우측의 반전 버튼(**\[상하반전]**, **\[좌우반전]**, **\[대각선 반전]**)을 클릭합니다.

* **\[수동 배치] (이동·회전·대칭 직접 조정)**: 기준 로케이터를 축으로 전체 배치를 직접 이동·회전·반전하여 도면에 맞춥니다.

  | 항목 | 기능 |
  | - | - |
  | 기준 | ·회전 및 대칭의 중심축이 될 로케이터를 선택 (도면에서 하이라이트 표시) |
  | 이동 | ·전체 로케이터를 이동할 가로(X)·세로(Y) 거리(m)를 입력하고 \[적용] 클릭 |
  | 회전 | ·기준 로케이터를 중심으로 회전할 각도(도)를 입력하고 \[적용] 클릭 |
  | 대칭 | ·기준 로케이터를 중심으로 \[상하반전] 또는 \[좌우반전] 클릭 |
  | 그리드 | ·설정한 X·Y 간격(m)의 격자에 맞춰 로케이터 위치를 \[정렬] |

배경도 정합을 완료한 후 하단의 **\[다음]**을 클릭합니다.

**(5) 수동 마무리**

* 모든 로케이터의 배치가 완료되면 **'모든 장치 배치 완료'**가 표시됩니다.
  * 설치 높이가 기본값(3 m)과 다른 경우 **\[수동 배치]** 탭으로 전환하여 '배치됨' 목록에서 **기본 설치높이(m)** 또는 개별 **z(m)** 값을 입력한 뒤, 하단의 **\[다음]**을 클릭하여 클러스터 설정 단계로 이동합니다.
* 미접속 등으로 자동 배치에서 제외된 로케이터가 남아 있는 경우 **'나머지 수동 배치'** 안내가 표시됩니다. **\[수동 배치로 이동]**을 클릭하여 남은 로케이터를 도면에 직접 배치한 후 **\[다음]**을 클릭합니다.

## 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) 클러스터 구성**

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

> [!CAUTION]
>
> 마스터 로케이터와 세션 ID 값은 서비스 도입 시 메일 등을 통해 별도로 안내됩니다.
> 임의로 지정하지 말고 사전에 안내받은 값을 입력하십시오.
> 안내받지 못한 경우 [support@ones1ght.com](mailto:support@ones1ght.com) 로 문의하십시오.

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

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

![자동 클러스터 구성 — ① 도면 위 대각선 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)

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

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

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

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

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

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

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

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

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

![수동 클러스터 구성 — 클러스터 트리(세션 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** 표시가 나타나며 마스터 로케이터로 지정됩니다.
* 마스터 로케이터는 클러스터마다 한 대만 지정할 수 있습니다.

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

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

**(3) 적용**

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

* 미접속 로케이터 경고가 표시되면 그 로케이터는 클러스터에서 빠집니다. 전원과 Wi-Fi 연결을 확인해 접속 상태로 만든 뒤 다시 적용합니다.
* 적용 완료 후 **\[완료]**를 클릭합니다.
* 실제 측위 동작 여부는 [동작 검증](/locator/verify)에서 확인합니다.

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

| 상태 | 의미 | 조치 |
| - | - | - |
| 구축 완료 | ·설정이 로케이터에 반영된 상태 | ·다음 단계로 진행 |
| 미적용 | ·구성만 저장되고 아직 반영되지 않은 상태 | ·\[장치 적용]을 실행 |
| 설정 실패 | ·일부 로케이터에 반영 실패 — 층 상태가 '설정확인필요'로 표시 | ·로케이터의 전원·접속 상태 확인 후 재적용·실패가 반복되는 경우 [동작 검증](/locator/verify)에서 실제 측위 동작으로 판단 |

> [!NOTE]
>
> 최초 1회는 상태가 \*\*'구축 완료'\*\*가 되어야 등록이 끝난 것입니다.
> '미적용'이나 '설정확인필요'로 남아 있으면 전원과 Wi-Fi 연결을 확인하고 다시 적용합니다.
> 실제 측위 동작 여부는 [동작 검증](/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.