> ## 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(GCH) 파트너 키를 등록·검증해 실제 건물·도면·존 패스스루를 켜는 설정 화면입니다.

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

## 측위정보 연동이란?

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

## GeoSpace(GCH) 파트너 키

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

| 필드              | 설명                                                                       |
| --------------- | ------------------------------------------------------------------------ |
| GeoSpace 서버 URL | 기본값 `https://geospace.geoplan.io` {/* TODO(팀): 정식 GeoSpace 호스트 확인 필요 */} |
| 파트너 키           | `X-Partner-Key` 값. 예: `gpk_...`                                          |

## 등록 흐름

<Steps>
  <Step title="키 입력">
    발급받은 GeoSpace 파트너 키를 입력합니다.
  </Step>

  <Step title="검증 후 저장">
    **검증 후 저장**을 누르면 키 유효성을 확인한 뒤 저장합니다. 검증에 성공하면 이 키가 측위 연동에 사용됩니다.
  </Step>

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

## 연결 상태 배지

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

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

## 관련 문서

<CardGroup cols={2}>
  <Card title="구역 관리" icon="draw-polygon" href="/locator/areas">
    연동된 도면 위에서 존/포인트를 편집합니다.
  </Card>

  <Card title="모바일 SDK 키 관리" icon="key" href="/locator/sdk-keys">
    고객 앱이 위치 데이터를 보낼 때 쓰는 SDK 키를 발급합니다.
  </Card>
</CardGroup>