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

# 측위 정보 연동

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

## 1) 파트너 키 발급

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

![파트너 API 화면 — 메뉴 진입 후 키 발급](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/7.connect-partner-key-issue.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=7c77012658e7ef3a7911368a990d5269)

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

> [!NOTE]
>
> 키 값은 파트너 API 메뉴에서 언제든지 다시 확인할 수 있습니다.

## 2) SDK 키 발급

SDK 키(`gsk_...`)는 OneS1ght가 GeoSpace의 앵커·세션 정보를 조회할 때 사용하는 인증 키입니다.

![GeoSpace 모바일 SDK 화면 — 모바일 메뉴와 SDK 키의 키 발급 버튼](https://mintcdn.com/onecheck/5u3BErG_mEDOJqyL/images/geospace/7.connect-sdk-key-issue.png?fit=max\&auto=format\&n=5u3BErG_mEDOJqyL\&q=85\&s=ca2206312d2be08f357dc96d61547ebf)

\[모바일] 메뉴로 진입 후 SDK 키의 \[+ 키 발급] 버튼을 클릭합니다. 새 SDK 키가 생성되면 키를 복사합니다.

## 3) OneS1ght에 등록

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

![OneS1ght 조직 설정 화면 — 조직 설정 메뉴와 Geospace 연동의 Intelligence Hub (모바일) 설정 변경 버튼](https://mintcdn.com/onecheck/5u3BErG_mEDOJqyL/images/geospace/7.connect-console-link.png?fit=max\&auto=format\&n=5u3BErG_mEDOJqyL\&q=85\&s=ffc21d53e91e3cd4ab50078280c315f3)

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

2. OneS1ght 사이드바에서 \[조직 설정]으로 이동합니다.
   API 연동의 Geospace 연동에서 Intelligence Hub (모바일)의 \[설정 변경]을 클릭하면
   'Geospace 연동 관리' 팝업이 표시됩니다.

![Geospace 연동 관리 팝업 — 상태·등록일·마지막 검증, GeoSpace 서버·파트너 키·SDK 키·Google Map 키 입력과 연결 테스트·저장](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)

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

| 항목 | 입력 값 |
| - | - |
| GeoSpace 서버 | ·[`geospace.geoplan.io`](https://geospace.geoplan.io)가 입력되어 있는 경우 그대로 사용합니다. |
| 파트너 키 (X-Partner-Key)필수 | ·앞서 GeoSpace에서 발급한 파트너 키(`gpk_...`)를 입력합니다. |
| SDK 키필수 | ·앵커·세션 조회에 사용하는 GeoSpace SDK 키입니다.·이미 등록된 경우 비워두면 현재 값이 유지됩니다. |
| Google Map 키선택 | ·앱이 실내 도면 대신 구글 지도를 표시할 때 사용하는 키입니다. 비워두면 현재 값이 유지됩니다. |
| 연결 테스트 | ·\[연결 테스트]를 클릭하여 입력한 키의 유효성을 확인합니다. |

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

> [!CAUTION]
>
> 파트너 키 발급과 등록은 별도의 작업입니다.
>
> * 발급: GeoSpace에서 연동용 파트너 키를 생성하는 작업
> * 등록: 발급된 파트너 키를 OneS1ght에 입력하고 저장하는 작업
>
> GeoSpace에서 키를 발급한 후 OneS1ght에 등록까지 완료해야 연동 설정이 완료됩니다.\\
>
> 키를 발급만 하고 등록하지 않은 경우 연동 상태가 미연결로 표시되며,
> 공간 관리에서 실제 매장 도면을 볼 수 없습니다.

## 체크리스트

> [!NOTE]
>
> 아래 항목이 모두 확인되면 다음 단계로 진행할 수 있습니다.
>
> | # | 확인 항목 | 확인 |
> | - | - | :-: |
> | 1 | 연동 관리 화면의 상태가 '연결됨'으로 표시됩니다. | ☐ |
> | 2 | [공간 관리](/console/areas)에서 GeoSpace에 업로드한 실제 도면이 표시됩니다. | ☐ |


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