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

# 6. 측위 정보 연동

> 파트너 키를 발급하고 OneS1ght에 등록하여 측위 인프라와 OneS1ght를 연계합니다.

## 1) 파트너 키 발급

파트너 키(`gpk_...`)는 OneS1ght가 GeoSpace의 건물·도면·Zone 정보를 가져올 때
사용하는 테넌트 인증 키입니다.

<Frame>
  <img src="https://mintcdn.com/onecheck/IlOcLn7Fdb-0IWzX/images/geospace/partner-key-issue.png?fit=max&auto=format&n=IlOcLn7Fdb-0IWzX&q=85&s=972dd50a8101d6fc9ee3d8a0ff530de5" alt="파트너 API 화면 — 메뉴 진입 후 키 발급" width="4400" height="2617" data-path="images/geospace/partner-key-issue.png" />
</Frame>

\[파트너 API] 메뉴로 진입 후 화면 우측 상단의 \[+ 키 발급] 버튼을 클릭합니다. 새 파트너 키(`gpk_...`)가 생성되면 키를 복사합니다.

<Info>
  키 값은 파트너 API 메뉴에서 언제든지 다시 확인할 수 있습니다.
</Info>

## 2) OneS1ght에 등록

아래 절차에 따라 OneS1ght에 파트너 키를 등록하여 GeoSpace와의 연동을 설정합니다.

<Frame>
  <img src="https://mintcdn.com/onecheck/IlOcLn7Fdb-0IWzX/images/geospace/console-geospace-link.png?fit=max&auto=format&n=IlOcLn7Fdb-0IWzX&q=85&s=35f9102db1e560bee8a14dd2ce7a8e34" alt="OneS1ght 설정 화면의 Geospace 연동 카드" width="4400" height="2617" data-path="images/geospace/console-geospace-link.png" />
</Frame>

1. OneS1ght([`console.ones1ght.com`](https://console.ones1ght.com))에 로그인합니다. OneS1ght 로그인이 처음인 경우 [시작하기(초대·로그인)](/quickstart)을 먼저 진행합니다.

2. OneS1ght 사이드바에서 \[설정]으로 이동한 후 화면을 아래로 스크롤하여 GeoSpace 연동 카드의 \[모바일 측위 설정]을 클릭합니다. 연동 관리 팝업이 표시됩니다.

<Frame>
  <img src="https://mintcdn.com/onecheck/IlOcLn7Fdb-0IWzX/images/geospace/console-geospace-link-modal.png?fit=max&auto=format&n=IlOcLn7Fdb-0IWzX&q=85&s=0b6df9e7e9ef4eda865dfbc4ae44ef52" alt="Geospace 연동 관리 창 — 서버 주소와 파트너 키를 입력하고 연결 테스트 후 저장" width="4400" height="2617" data-path="images/geospace/console-geospace-link-modal.png" />
</Frame>

3. 아래 항목을 입력하고 \[저장]을 클릭합니다. \[저장]을 클릭한 후 화면 상단 상태가 '연결됨'으로 표시되는지 확인합니다. '연결됨'으로 표시되면 연동 설정이 완료된 것입니다.

| 항목                    | 입력 값                                                                                                                                                                           |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| GeoSpace 서버           | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>[`geospace.geoplan.io`](https://geospace.geoplan.io)가 입력되어 있는 경우 그대로 사용합니다.</span></span> |
| 파트너 키 (X-Partner-Key) | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>앞서 GeoSpace에서 발급한 파트너 키(`gpk_...`)를 입력합니다.</span></span>                                  |
| 연결 테스트                | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>\[연결 테스트]를 클릭하여 입력한 키의 유효성을 확인합니다.</span></span>                                          |

<Info>
  이미 파트너 키가 등록된 조직의 경우 파트너 키 입력란을 비워두어도 됩니다.
  빈 값으로 저장하면 기존 키가 유지됩니다.
</Info>

<Danger>
  파트너 키 발급과 등록은 별도의 작업입니다.

  * 발급: GeoSpace에서 연동용 파트너 키를 생성하는 작업
  * 등록: 발급된 파트너 키를 OneS1ght에 입력하고 저장하는 작업

  GeoSpace에서 키를 발급한 후 OneS1ght에 등록까지 완료해야 연동 설정이 완료됩니다.<br />
  키를 발급만 하고 등록하지 않은 경우 시뮬레이션 모드로 동작하며, 실제 매장 도면 대신
  샘플 도면이 표시될 수 있습니다.
</Danger>

## 체크리스트

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

  | # | 확인 항목                                                  |  확인 |
  | - | ------------------------------------------------------ | :-: |
  | 1 | 연동 관리 화면의 상태가 '연결됨'으로 표시됩니다.                           |  ☐  |
  | 2 | [공간 관리](/locator/areas)에서 GeoSpace에 업로드한 실제 도면이 표시됩니다. |  ☐  |
</Note>