# Selecting a map

## Map Flow

Maps are large files and are generated and stored on the cloud. If you want to put a map on your edge device, you first need to download it from the cloud to your local machine. This can take a long time even with a good internet connection depending on the size of the map.

After the map is downloaded, you can upload it to the edge device. It will be stored there until you delete it. You can select any of the maps on the edge device as the active map simply by selecting it in the maps tab of the app.

## Map Library

All maps linked to your account can be viewed from the Maps panel on the Vozilla GCS App. Any previously generated map can be downloaded to your device. You will also be able to see and map generations that have failed, as well as archive maps that you are not using.

To download a map onto your device. First navigate to the maps panel. This can be done from anywhere using the spotlight search

<figure><img src="/files/X3KvpQJ8uoa5QFmkO28e" alt=""><figcaption></figcaption></figure>

Then, Download the map using the download button

<figure><img src="/files/OYGTpBbyspD02JAqImtN" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Maps are downloaded as a single **.tar.gz** file to be uploaded to your device.
{% endhint %}

## Uploading maps to the edge device

Once a map has been downloaded to your local machine, you can upload it to the edge device.

<figure><img src="/files/mtF5UyhgYdXgQpBAV691" alt=""><figcaption></figcaption></figure>

After being uploaded, the new map is automatically selected as the active map and the home position is set.


---

# Agent Instructions: 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:

```
GET https://docs.theseus.us/gcs-software/vozilla-2.0/maps/selecting-a-map.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
