Find Hint Coordinates

Capture a position on a Map or MapSet mesh and use it as the HintPosition for a MultiSet Localization query.

Overview

The Localization query API accepts a HintPosition 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.

The Hint Cursor (top-right) displays the live X / Y / Z position at the cursor. Click the readout to copy it.

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.

---

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.

Assign the downloaded mesh to the Map Mesh field of the MapPointInspector component.

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

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.

In Play mode the cursor shows the height and full position. Press C to copy.

---

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:

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