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

# Positioning Connection

> Register and validate a GeoSpace partner key to enable real building, floor plan, and zone pass-through.

> [!NOTE]
>
> This page is available to **Manager** and above only (permission `manage` — Owner or Manager).

## What is Positioning Connection?

**Positioning Connection** (a panel in Settings) is where you register and validate the partner key for **GeoSpace**, the positioning partner.
GeoSpace supplies building, floor plan, and zone data, which OneS1ght passes straight through (pass-through) to show the real floor plan in [Areas](/en/console/areas).
You must register a partner key to turn off simulation mode and edit zones/points on the actual store floor plan.

## GeoSpace partner key

The GeoSpace server verifies the partner key from the `X-Partner-Key` header on each request. Registering this key in the console uses it for your organization's (tenant's) positioning integration.

| Field | Description |
| - | - |
| GeoSpace server URL | Defaults to `https://geospace.geoplan.io` |
| Partner key | The `X-Partner-Key` value. Example: `gpk_...` |

## Registration flow

**1. Enter the key**

Enter the GeoSpace partner key you were issued.

**2. Validate & save**

Press **Validate & save** to verify the key and store it. On success, this key is used for positioning integration.

**3. Replace or delete**

A registered key can be **replaced** or **deleted**. Deleting the tenant key falls back to the server default key if one exists.

## Connection status badges

| Badge | Meaning |
| - | - |
| Not connected — simulation mode | No partner key, so it runs in simulation instead of a real floor plan. |
| Connected · Tenant key | Integrated with the partner key registered by this organization. |
| Connected · Server default key | Integrated with the default key configured on the server. |

> [!NOTE]
>
> The last validation time is shown alongside the status. If the integration fails, check the outbound network, the partner key, and the allowed-hosts setting.

## Related

> **[Areas](/en/console/areas)**
>
> Edit zones/points on the connected floor plan.

> **[Mobile SDK Keys](/en/console/sdk-keys)**
>
> Issue SDK keys used by your app to send location data.


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