# Editor de Mapa

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

A funcionalidade de **Mapas** no Gaio permite criar visualizações geográficas diretamente dentro do seu fluxo de dados. É ideal para exibir informações regionais, segmentação de territórios, rotas de entrega ou distribuição de indicadores por localização.

***

## Como Usar o Editor de Mapas

***

### **1.  Acesse o Módulo de Mapas**

* No painel lateral esquerdo, vá até **Mapas**.
* Para criar um novo mapa, clique no botão de **“+”**.

***

### 2. **Configuração Inicial (Aba Settings)**

* **Título**: Insira o nome do mapa (ex.: *Brasil*, *Distribuição de Vendas*).
* **Descrição (opcional)**: Adicione contexto ou observações sobre o uso do mapa.

***

### 3. **Visualização do Mapa**

* O editor utiliza o **MapLibre**, baseado no **OpenStreetMap**.
* É possível mover, dar zoom e interagir diretamente com o mapa.
* Neste ambiente, há duas possibilidades:
  1. Criar um novo mapa desenhando **polígonos**, **linhas** ou **pontos**.
  2. Carregar arquivos **GeoJSON** ou **JSON** com mapas prontos.
* Você pode adicionar polígonos, pontos ou áreas personalizadas utilizando as ferramentas de desenho.
* Isso é útil para destacar zonas de interesse, regiões operacionais ou limites geográficos definidos por regras de negócio.
* As áreas destacadas representam regiões selecionadas, como **estados**, **cidades ou zonas personalizadas.**

***

### 4. Aba Drawings&#x20;

* Utilize as ferramentas de desenho para alterar ou excluir áreas destacadas.

***

### 5. **Utilize a Barra Superior**

A barra no canto superior esquerdo oferece ferramentas para:

* **Mostrar Uploader**
* **Baixar mapa**
* **Excluir forma selecionada**
* **Combinar formas**
* **Separar formas combinadas**
* **Publicar mapa**

***

### 6. **Salvar e Publicar**

* Clique em **Salvar** (botão laranja no canto superior direito) para armazenar seu mapa.
* O mapa agora pode ser utilizado em:
  * **Dashboards**
  * **Elementos de conteúdo** dentro do Gaio

***

### &#x20;**Dicas Estratégicas de Uso**

* Combine mapas com conjuntos de dados regionais (ex.: vendas, distribuição de clientes, indicadores sociais).
* Use ferramentas de desenho para definir:
  * Zonas de entrega
  * Territórios de vendas
  * Áreas de risco ou de performance
* Os mapas são totalmente responsivos e ideais tanto para dashboards operacionais quanto para apresentações executivas.


---

# 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/gaio-dataos-portuguese/tools/editor-de-mapa.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.
