> For the complete documentation index, see [llms.txt](https://multiset.gitbook.io/multiset/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://multiset.gitbook.io/multiset/basics/rest-api-docs/map-scale.md).

# Map Scale

You can now upload **360° videos without any physical scale markers**. The capture is processed into a map, and once the map is **active** you set its real-world scale yourself: measure something in the map whose length you know and enter that length **in metres**. MultiSet applies the corresponding **metric scale factor** so the map's geometry and stored metrics match the real world.

This is useful whenever a marker-less 360 capture needs its true scale set (or corrected) after processing.

{% hint style="info" %}
Map scaling is available only for **standalone Insta360 maps** that are currently **active**. A map that belongs to a MapSet or a version chain cannot be scaled directly.
{% endhint %}

### Where to find it

In the Developer Portal, open the map's **Map Details** page and click **View Splat** in the toolbar:

<figure><img src="/files/waRquFO0ycuaX4PsvrOw" alt="Map Details toolbar with the View Splat button highlighted"><figcaption><p>Map Details toolbar. Open <strong>View Splat</strong>.</p></figcaption></figure>

Then click the **Scaling** button (top right of the Splat View) to open the measure-to-scale tool:

1. Click the two ends of something you know the real size of: a door, a window, a tile.
2. Drag the dots to line them up exactly.
3. Enter its real length **in metres** and confirm.

MultiSet computes the scale factor from your measurement and applies it to the map. You can also apply scaling programmatically with the API below.

<figure><img src="/files/F3130FP7p0AW9W9U2EIX" alt="Splat viewer with the Scaling button highlighted at the top right"><figcaption><p>Inside the Splat View, click <strong>Scaling</strong> (highlighted, top right) to open the measure-to-scale tool. Measure something of a known real length, enter its length in metres, and confirm to scale the map.</p></figcaption></figure>

### Map Scale API

Make a `POST` request to **`/v1/vps/map/{mapId}/scale`** with your authentication token and a single scale factor. `{mapId}` accepts the map id or map code.

* **`scaleFactor`**: number, **required**, must be greater than `0`. Values below `1` shrink the map, above `1` enlarge it (e.g. `0.85` scales the map to 85% of its current size).

The operation is **asynchronous**: the endpoint responds immediately with `202 Accepted` and sets the map to `pending`. The map returns to `active` once scaling completes, or `failed` if it could not be applied.

#### Sample Request

```bash
curl -X POST "https://api.multiset.ai/v1/vps/map/{mapId}/scale" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{ "scaleFactor": 0.85 }'
```

#### Sample Response

```json
{
    "mapId": "67e12d4bff7ecf561f2f8a0c",
    "scaleFactor": 0.85,
    "status": "pending"
}
```

### Behaviour

* The map is set to `status: "pending"` while scaling runs, then flips to `active` on success or `failed` if it could not be applied.
* Scaling is multiplicative. Each call scales relative to the map's **current** size, so applying `0.85` twice results in `0.85 × 0.85`.
* Requests are rejected if the map is not found, not owned by your account, not an Insta360 map, not currently active, or part of a MapSet or version chain.

{% openapi src="/files/T4Pf8FEkIHZXF1GEdFYm" path="/vps/map/{mapId}/scale" method="post" %}
[map-scale.yaml](https://3163433004-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FokTDI7QVY04Zvb1pQ8Ry%2Fuploads%2Fgit-blob-0431d6de65dca67c72a9d5dffbee977a2b570dac%2Fmap-scale.yaml?alt=media)
{% endopenapi %}


---

# 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://multiset.gitbook.io/multiset/basics/rest-api-docs/map-scale.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.