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

# 7. Positioning Data Integration

> Issue a partner key and register it in OneS1ght to connect the positioning infrastructure with OneS1ght.

## 1) Issuing a Partner Key

The partner key (`gpk_...`) is the tenant authentication key OneS1ght uses to fetch
building, plan, and zone information from GeoSpace.

![Partner API screen: issuing a key after entering the menu](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/7.connect-partner-key-issue.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=7c77012658e7ef3a7911368a990d5269)

Open the \[Partner API] menu and click the \[+ Issue Key] button at the top right of the screen. When the new partner key (`gpk_...`) is generated, copy it.

> [!NOTE]
>
> You can view the key value again at any time in the Partner API menu.

## 2) Issuing an SDK Key

The SDK key (`gsk_...`) is the authentication key OneS1ght uses to look up anchor and session information in GeoSpace.

![GeoSpace mobile SDK screen: the Mobile menu and the issue key button for the SDK key](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)

Open the \[Mobile] menu and click the \[+ Issue Key] button for the SDK key. When the new SDK key is generated, copy it.

## 3) Registering in OneS1ght

Follow the steps below to register the partner key and SDK key in OneS1ght and set up the GeoSpace integration.

![OneS1ght organization settings screen: the Organization settings menu and the Edit settings button for Intelligence Hub (Mobile) under Geospace Integration](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. Log in to OneS1ght ([`console.ones1ght.com`](https://console.ones1ght.com)). If this is your first OneS1ght login, complete [Getting Started (invitation · login)](/en/quickstart.md) first.

2. In the OneS1ght sidebar, go to \[Organization settings].
   Under API integrations, in Geospace Integration, click \[Edit settings] for Intelligence Hub (Mobile)
   to open the 'Manage Geospace integration' popup.

![Manage Geospace integration popup: status, registered date, last validated; GeoSpace server, partner key, SDK key, Google Map key inputs with test connection and save](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. Fill in the fields below and click \[Save]. After clicking \[Save], confirm the status at the top of the screen shows 'Connected'. Once it shows 'Connected', the integration is set up.

| Field | Input |
| - | - |
| GeoSpace server | ·If [`geospace.geoplan.io`](https://geospace.geoplan.io) is pre-filled, use it as is. |
| Partner key (X-Partner-Key)Required | ·Enter the partner key (`gpk_...`) issued in GeoSpace earlier. |
| SDK keyRequired | ·The GeoSpace SDK key used for anchor and session lookups.·If one is already registered, leave blank to keep the current value. |
| Google Map keyOptional | ·The key used when the app shows Google Maps instead of the indoor plan. Leave blank to keep the current value. |
| Test connection | ·Click \[Test connection] to verify the keys you entered. |

> [!NOTE]
>
> If your organization already has a partner key registered, you may leave the partner key field blank.
> Saving with a blank value keeps the existing key.

> [!CAUTION]
>
> Issuing and registering the partner key are separate tasks.
>
> * Issuing: generating the integration partner key in GeoSpace
> * Registering: entering the issued partner key in OneS1ght and saving it
>
> The integration is only set up once the key issued in GeoSpace has also been registered in OneS1ght.\\
>
> If the key is issued but not registered, the integration status shows as Not connected,
> and Space Management cannot show your actual store plan.

## Checklist

> [!NOTE]
>
> Once all items below are confirmed, you can move on to the next step.
>
> | # | Item | Check |
> | - | - | :-: |
> | 1 | The integration screen status shows 'Connected'. | ☐ |
> | 2 | [Space Management](/en/console/areas.md) shows the actual plan uploaded to GeoSpace. | ☐ |


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