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

# 측위 연결 (설정)

> GeoSpace 파트너 키를 등록·검증해 실제 건물·도면·존 패스스루를 켜는 설정 화면입니다.

> [!NOTE]
>
> 이 페이지는 **관리자(Manager)** 이상만 접근할 수 있습니다(권한 `manage` — 최고 관리자(Owner) 또는 관리자).

## 측위 연결이란?

**측위 연결**은 콘솔 **설정 → Geospace 연동** 카드의 **\[모바일 측위 설정]** 으로 여는 화면으로, 측위 파트너인 **GeoSpace**의 파트너 키를 등록·검증합니다.
GeoSpace는 건물·도면·존 정보를 제공하는 파트너이며, OneS1ght는 이 데이터를 그대로 통과(패스스루)시켜 [공간 관리](/console/areas)에 실제 도면을 표시합니다.
파트너 키를 등록해야 시뮬레이션 모드가 해제되고 실제 매장 도면 위에서 존/포인트를 편집할 수 있습니다.

## GeoSpace 파트너 키

GeoSpace 서버는 요청 시 `X-Partner-Key` 헤더로 파트너 키를 확인합니다. 이 키를 콘솔에 등록하면 해당 조직(테넌트)의 측위 연동에 사용됩니다.

| 필드 | 설명 |
| - | - |
| GeoSpace 서버 URL | 기본값 [`geospace.geoplan.io`](https://geospace.geoplan.io) |
| 파트너 키 | `X-Partner-Key` 값. 예: `gpk_...` |

## 등록 흐름

**1. 키 입력**

발급받은 GeoSpace 파트너 키를 입력합니다.

**2. 연결 테스트 → 저장**

**\[연결 테스트]** 로 키 유효성을 확인한 뒤 **\[저장]** 을 누릅니다. 저장되면 이 키가 측위 연동에 사용됩니다.

**3. 교체 · 삭제**

등록된 키는 **교체**하거나 **삭제**할 수 있습니다. 테넌트 키를 삭제하면 서버 기본 키가 있을 경우 그것으로 폴백됩니다.

![Geospace 연동 관리 창](https://mintcdn.com/onecheck/5u3BErG_mEDOJqyL/images/geospace/7.connect-console-link-modal.png?fit=max\&auto=format\&n=5u3BErG_mEDOJqyL\&q=85\&s=e6e372d49d8a54a93ac16cebf85aedca)

> [!NOTE]
>
> 파트너 키 발급부터 등록까지의 단계별 절차(화면 캡처 포함)는 [6. 측위 연결 · 키 발급](/locator/connect)을 참고하세요.

## 연결 상태 배지

| 배지 | 의미 |
| - | - |
| 미연결 — 시뮬레이션 모드 | 파트너 키가 없어 실제 도면 대신 시뮬레이션으로 동작합니다. |
| 연결됨 · 테넌트 키 | 이 조직이 등록한 파트너 키로 연동 중입니다. |
| 연결됨 · 서버 기본 키 | 서버에 설정된 기본 키로 연동 중입니다. |

> [!NOTE]
>
> 최근 검증 시각이 함께 표시됩니다. 연동이 되지 않으면 아웃바운드 네트워크와 파트너 키, 허용 호스트 설정을 확인하세요.

## 관련 문서

> **[구역 관리](/console/areas)**
>
> 연동된 도면 위에서 존/포인트를 편집합니다.

> **[모바일 SDK 키 관리](/console/sdk-keys)**
>
> 고객 앱이 위치 데이터를 보낼 때 쓰는 SDK 키를 발급합니다.


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