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

# 개요

> 모바일 측위 인프라 구축 매뉴얼의 적용 범위와 표기 규칙, 주요 용어 및 전체 구성을 안내합니다.

## 1) 문서 정보

| 항목 | 내용 |
| - | - |
| 적용 기준 | ·GeoSpace 및 OneS1ght 2026년 10월 화면 기준 |
| 대상 장비 | ·AN-500 로케이터 |
| 대상 독자 | ·현장 설치 담당자 및 운영 담당자 |
| 버전 | ·v1.4 |

**버전 이력**

**v1.4**

| 일자 | 주요 변경 |
| - | - |
| 2026-10-08 | ·Demo Kit 신설 (사전 준비 · 현장 설치 · 동작 확인)·트러블슈팅 증상별 재정리 및 구축 완료 뒤 로케이터 위치 조정 절차 추가·하드웨어 등록에 iPhone 개인용 핫스팟(테더링) 사용 안내, 프로비저닝 사용 시점·공장 초기화 사용 조건 추가·동작 검증에 앱 스토어 설치 안내 추가, 모바일 측위 데이터 조회 페이지 신설 및 수집 데이터 확인 절 추가·설치 물품에 보조 배터리 대체 안내 추가 (라인테이프·종이테이프는 선택), 도면 미등록 시 실측값 준비 체크 항목 추가 |

**v1.3**

| 일자 | 주요 변경 |
| - | - |
| 2026-09-22 | ·펌웨어 OTA 적용 문서 신설 (파일 등록, 대상 선정, 진행·적용 확인)·하드웨어 등록에 연결 실패(장치 응답 시간 초과) 시 재시도 안내 추가 |

**v1.2**

| 일자 | 주요 변경 |
| - | - |
| 2026-09-18 | ·검증 앱 개편 반영 (자동 감지 측위, 권한 안내, 신호 상실 화면, 이벤트 로그)·OneS1ght 조직 설정 기반 Geospace 연동 및 SDK 키 발급·등록 절차 반영·공간 관리(존 편집) 화면 구성·존 만들기·존 이벤트 설정 전면 갱신 |

**v1.1**

| 일자 | 주요 변경 |
| - | - |
| 2026-09-15 | ·하드웨어 등록(GeoSpace Mobile 앱 프로비저닝) 단계 신설 및 전체 8단계 재편·도면 실측 크기 입력 및 거리 측정 확인 절차 반영·LED 상태 정의(상단·하단) 반영 |

**v1.0**

| 일자 | 주요 변경 |
| - | - |
| 2026-08-21 | ·최초 작성 (2026년 8월 화면 기준) |

## 2) 적용 범위 및 전제

본 매뉴얼은 다음을 전제로 작성되었습니다.

* 로케이터 4대를 감지 영역의 각 모서리에 배치하는 구성(약 15 m × 15 m 공간 기준)을 기준으로 설명합니다. 로케이터 수량이 증가하거나 공간 형태가 불규칙한 경우 별도 설정이 필요할 수 있으므로, 이 경우 [support@ones1ght.com](mailto:support@ones1ght.com) 로 문의하시기 바랍니다.
* 본 매뉴얼은 모바일 디바이스를 이용한 다운링크 방식(DL-TDoA)을 기준으로 설명합니다. 다운링크 방식은 로케이터가 송출한 신호를 모바일 기기가 수신하여 위치를 계산하는 방식입니다.
* 사람 또는 자산에 태그를 부착하는 업링크 방식은 장비 및 구성이 다르므로 본 매뉴얼에서는 다루지 않습니다.

## 3) 용어

| 용어 | 설명 |
| - | - |
| 가시선(LOS, Line of Sight) | ·로케이터와 수신 기기 사이에 장애물 없이 신호가 직선으로 도달할 수 있는 상태 |
| 감지 영역 | ·로케이터가 배치된 측위 영역으로, 해당 영역 내에서 위치를 측정 |
| 기준 방향 | ·공간의 방향을 정의하기 위한 기준이 되는 윗변으로, 도면의 방향과 좌표 체계를 설정할 때 사용 |
| 다운링크(DL-TDoA) | ·로케이터가 송출한 신호를 모바일 기기가 수신하여 위치를 계산하는 방식 |
| 도면 스케일링 | ·도면 이미지상의 거리와 실제 공간의 거리(m)를 일치시키는 작업 |
| 로케이터(Locator) | ·벽면 또는 삼각대 등에 설치하여 UWB 신호를 송출하는 장비 |
| 마스터 로케이터(INP) | ·클러스터에서 신호 송출의 기준이 되는 로케이터·마스터 로케이터가 먼저 신호를 송출하면 나머지 로케이터(RES)가 정해진 순서에 따라 이어서 송출하며, 모바일 기기는 각 신호의 도착 시간 차이로 위치를 계산 |
| 세션 ID | ·클러스터를 식별하는 값 |
| 시뮬레이션 모드 | ·파트너 키가 등록되지 않은 상태에서 샘플 도면을 사용하여 설정 및 기능을 확인하는 모드 |
| 기준점(0, 0) | ·기준 방향을 바라봤을 때 왼쪽 아래 모서리에 해당하는 좌표 시작점 |
| 오프셋 | ·개념적인 기준점(0, 0)과 도면상 좌표의 차이. 도면 이미지에 벽 두께나 여백이 포함된 경우 발생 |
| 클러스터 | ·여러 로케이터를 하나의 송출 그룹으로 묶어 구성한 단위 |
| 파트너 키(gpk\_) | ·GeoSpace에서 발급 후 OneS1ght에 등록하는 연동용 키 |
| 프로비저닝 | ·GeoSpace Mobile 앱으로 로케이터에 Wi-Fi 정보를 설정하여 GeoSpace 서버에 접속하고 등록하는 과정 |
| 호스트 | ·로케이터의 본체. 부팅·네트워크·서버 연결을 담당하며, 내부의 UWB 모듈과 별도의 펌웨어로 관리 |
| GeoSpace | ·건물·층 도면에 실제 설치된 로케이터의 위치를 일치시키고, 로케이터 좌표 및 이벤트 영역 등의 정보를 관리하는 소프트웨어·모바일 SDK에서 사용할 수 있도록 해당 정보를 제공 |
| OneS1ght | ·GeoSpace에서 수집된 측위 데이터를 분석하고 활용하는 클라우드 서비스 |
| SDK 키(ock\_sdk\_) | ·고객 애플리케이션에서 SDK가 API를 호출할 때 사용하는 인증 키 |
| Zone(구역) | ·도면 위에 지정하는 영역으로, 진입·이탈·체류 이벤트의 기준으로 사용 |

## 4) 전체 구성

측위 인프라 구축은 다음 순서로 진행합니다. 각 단계는 이전 단계의 완료를 전제로 합니다.

| 단계 | 내용 | 작업 환경 |
| - | - | - |
| [설치 전 준비](/locator/site-survey) | 현장 확인 및 도면·필요 물품 준비 | 현장 |
| [계정 등록](/locator/onboarding) | 사용자 등록 및 라이선스 확인 | GeoSpace |
| [공간 등록](/locator/spaces) | 건물·층 등록 및 도면 설정 | GeoSpace |
| [로케이터 현장 설치](/locator/install) | 로케이터 현장 설치 및 전원 연결 | 현장 |
| [하드웨어 등록](/locator/hardware) | 로케이터를 GeoSpace에 자산으로 등록 | 현장 · GeoSpace |
| [측위 기능 활성화](/locator/placement) | 설치 위치를 측정하여 도면에 반영하고 로케이터를 클러스터로 구성 | 현장 · GeoSpace |
| [측위 정보 연동](/locator/connect) | OneS1ght에 등록 및 측위 정보 연동 | GeoSpace · OneS1ght |
| [동작 검증](/locator/verify) | 정상 동작 확인 | 현장 |

설치 및 운영 중 발생하는 문제는 [트러블슈팅](/locator/troubleshooting)에서 증상별로 확인할 수 있습니다.
새 펌웨어가 배포된 경우 [펌웨어 OTA 적용](/locator/firmware-ota)에서 절차를 확인할 수 있습니다.


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