# Map Editor

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

The **Maps** feature in Gaio allows you to create geographic visualizations directly within your data flow. It's ideal for displaying regional information, territory segmentation, delivery routes, or indicator distribution by location.

***

## How to Use the Map Editor

***

### **1.**  Access the Maps Module

* In the left-hand panel, go to **Maps**.
* to create a new map, click the plus button

***

### 2. Initial Setup (Settings Tab)

* **Title**: Enter the name of the map (e.g., Brazil, Sales Distribution).
* **Description** *(optional)*: Add context or usage notes for the map.

***

### 3. Map Visualization

* The editor uses **MapLibre** based on **OpenStreetMap**.
* You can **pan**, **zoom**, and **interact** with the map directly.
* In this environment there are two possibilities:
  1. Create a new map by drawing the polygons, line or point.
  2. Load GeoJSON, JSON maps.
* Add polygons, points, or custom areas using drawing tools.
* Useful for highlighting zones of interest, operational regions, or business-driven geographical boundaries.
* Highlighted areas represent selected regions like **states**, **cities**, or **custom zones**.

### 4. Drawings Tab

* Use drawing tools to change or delete you Highlighted areas.

### 5. Use the Top Toolbar

The top-left bar provides tools to:

* **Show Uploader**
* **Download**
* **Delete selected shape**
* **Combined shapes**
* **Separate combined shapes**
* **Public**

### 6. Save and Publish

* Click **Save** (orange button in the top-right) to store your map.
* The map can now be used in:
  * **Dashboards**
  * **Content elements** inside Gaio

***

### &#x20;Strategic Usage Tips

* Combine maps with regional datasets (e.g. sales, customer distribution, social indicators).
* Use drawing tools to define:
  * **Delivery zones**
  * **Sales territories**
  * **Risk or performance zones**
* Maps are fully responsive and ideal for both **operational dashboards** and **executive presentations**.


---

# 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.gaiodataos.com/tools/map-editor.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.