> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/gaio-dataos-portuguese/tools/editor-de-mapa.md).

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