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

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

<Info>
  This page is available to **Manager** and above only (permission `manage` — Owner or Manager).
</Info>

## What is Positioning Data?

**Positioning Data** is the screen where you register and validate the partner key for **GeoSpace (GCH)**, 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/locator/areas).
You must register a partner key to turn off simulation mode and edit zones/points on the actual store floor plan.

## GeoSpace (GCH) 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` {/* TODO(팀): 정식 GeoSpace 호스트 확인 필요 */} |
| Partner key         | The `X-Partner-Key` value. Example: `gpk_...`                                    |

## Registration flow

<Steps>
  <Step title="Enter the key">
    Enter the GeoSpace partner key you were issued.
  </Step>

  <Step title="Validate & save">
    Press **Validate & save** to verify the key and store it. On success, this key is used for positioning integration.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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

## Related

<CardGroup cols={2}>
  <Card title="Areas" icon="draw-polygon" href="/en/locator/areas">
    Edit zones/points on the connected floor plan.
  </Card>

  <Card title="Mobile SDK Keys" icon="key" href="/en/locator/sdk-keys">
    Issue SDK keys used by your app to send location data.
  </Card>
</CardGroup>