> For the complete documentation index, see [llms.txt](https://docs.multiset.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.multiset.ai/workflow/find-hint-coordinates.md).

# Find Hint Coordinates

## Overview

The Localization query API accepts a [HintPosition](/basics/localization/pose-prior-hintposition.md) that restricts the search scope to a radius around a known point in the map's coordinate system. This significantly improves localization speed and accuracy in large or visually repetitive spaces.

This page shows two ways to read the coordinates of any point on a Map (or MapSet) so you can use that value as the `hintPosition`:

* **MultiSet Developer Portal** : pick the point visually in the web 3D viewer.
* **Unity** : pick the point on the downloaded mesh inside a sample scene.

In both flows the value you copy is an `(x, y, z)` position in the map's left-handed (LHS / Unity) coordinate system, measured relative to the map origin. This is exactly the coordinate space the Localization query expects, so the captured value can be passed directly as the `hintPosition`.

***

## Method 1 : MultiSet Developer Portal

Use the web portal when you want to grab a hint coordinate quickly without opening Unity.

1. In the MultiSet web portal, open the 3D viewer using the **View Map** button.
2. Wait for the map mesh to finish loading in the scene.
3. Click the **Hint Cursor** button in the top-right corner of the viewer.
4. The viewer now displays the **hint position** for the current map (relative to the map origin) at the current cursor location. Move the cursor over the mesh to read the position for any point.
5. **Click to copy** the displayed cursor position to your clipboard.

<figure><img src="/files/TejUl1kVHpjLaRUSdI10" alt="MultiSet web portal 3D viewer showing the Hint Cursor button and the live X/Y/Z position with a Click to copy label"><figcaption><p>The Hint Cursor (top-right) displays the live <code>X / Y / Z</code> position at the cursor. Click the readout to copy it.</p></figcaption></figure>

{% hint style="warning" %}
The web viewer shows a reduced-resolution model for performance. The coordinates are accurate to the map's coordinate system; download the full mesh from the portal if you need finer visual detail while picking a point.
{% endhint %}

***

## Method 2 : Unity

Use Unity when you are already working in the SDK or want to pick the hint point against the same mesh your app uses.

### Step 1 — Open a sample scene with a mesh

Open any sample scene that can load a Map Mesh or MapSet Mesh, for example the **Localization** or **Navigation** scene.

### Step 2 — Enter the map code

Select the **LocalizationManager** component and enter your `mapCode` (or `mapSetCode`).

### Step 3 — Download the mesh

Select the **MapMeshDownloader** component and click **Download Mesh** in the Inspector. Wait until the Map Mesh or MapSet Mesh appears in the scene.

### Step 4 — Add the MapPointInspector component

Make sure a **MapPointInspector** component is present in the scene. If it is not, create an empty GameObject and add the `MapPointInspector` script to it.

Assign the downloaded Map Mesh (or MapSet Mesh) object to the **Map Mesh** field of the MapPointInspector component.

<figure><img src="/files/TUDKfUsOAg94MwNRyJQi" alt="Unity Inspector showing the MapPointInspector component with the Map Mesh field highlighted"><figcaption><p>Assign the downloaded mesh to the <strong>Map Mesh</strong> field of the MapPointInspector component.</p></figcaption></figure>

{% hint style="info" %}
The MapPointInspector picks a point on the map mesh in Play mode and reads the floor height (Y) plus the full position in map-space coordinates. The copy key defaults to **C** and can be changed in the component (Copy Pose Key).
{% endhint %}

### Step 5 — Enter Play mode and pick a point

1. Press **Play** to enter Play mode in the Editor.
2. Navigate around the scene using the **W, A, S, D** keys to reach the location on the map where you want to record the hint position.
3. A cursor appears on the mesh, with the position details displayed just below it, including the height `(Y)` and the full `X / Y / Z` position.
4. Press **C** on the keyboard to copy the current position to your clipboard.

<figure><img src="/files/M8oFbWshuZ5lm1CSflhF" alt="Unity Play mode showing the cursor on the map mesh with Height (Y) and the X/Y/Z position and a Press C to copy label"><figcaption><p>In Play mode the cursor shows the height and full position. Press <strong>C</strong> to copy.</p></figcaption></figure>

***

## Using the captured value

The copied position is an `(x, y, z)` coordinate in the map's LHS coordinate system. Pass it directly as the `hintPosition` in your Localization query:

```csharp
// where hintPosition is the (x, y, z) value copied from the portal or Unity
form.AddField("hintPosition", hintPosition);
```

For full details on how the hint narrows the search and related parameters such as `hintRadius`, see [Pose Prior : HintPosition](/basics/localization/pose-prior-hintposition.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.multiset.ai/workflow/find-hint-coordinates.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.