> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.1/cliente-desktop/criacao-e-edicao-de-dashboards/componente-mapa.md).

# Componente Mapa

### Exemplo**:**

<div align="left"><img src="/files/DMS4bSyKZGiYIaXNKl5J" alt=""></div>

Após posicionado no dashboard, e escolhida a forma de criação, o componente *<mark style="color:blue;">Mapa</mark>* possui tela centralizada de edição.

* <mark style="color:orange;">**1)**</mark> Em *<mark style="color:blue;">Configurações> Séries</mark>*, inicia-se a escolha do tipo de mapa, que pode ser: *<mark style="color:blue;">**Polígono**</mark>*<mark style="color:blue;">,</mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">**Bolha**</mark>* e *<mark style="color:blue;">**Dispersão**</mark>*. Dentre estas opções, Mapas do tipo Polígonos, usam como base de seu desenho mapas:

<div align="left"><img src="/files/N4xdR7w0o7FBivflj8E8" alt=""></div>

* <mark style="color:orange;">**2)**</mark> Mapas via *<mark style="color:blue;">**Polígono**</mark>*: Com esta escolha, temos como resultado a distribuição de dados sobre um desenho mapeado e delimitado por linhas, formando áreas geométricas:

<div align="left"><img src="/files/TtJ0DgYxuQepV31ysp8M" alt=""></div>

Para implementação de desenhos mapeáveis com Polígonos, são necessários detalhes de configuração prévia:

1. Adicionar os arquivos de mapas dentro dos arquivos do Weknow. Todos os mapas que serão utilizados devem estar no formato *Shapefile* (.**shp**), acompanhado dos arquivos de banco de dados (.**dbf**) e index (.**shx**) do mesmo e estar armazenados na pasta de instalação do Weknow em \\\\...\Common\Configs\files\maps.

<div align="left"><img src="/files/dkjM8Ye0bWF6ybF70aRf" alt=""></div>

* *<mark style="color:blue;">Caso as pastas files e maps não existam, as mesmas devem ser criadas antes de salvar os arquivos do mapa</mark>*.

#### Atenção!

O Weknow não gera arquivos do tipo Shapefile, ou qualquer semelhante. Os arquivos de mapa devem ser gerados/adquiridos pelo cliente. Como sugestão, indicamos buscar em websites de organizações como a do IBGE: <<https://mapas.ibge.gov.br/bases-e-referenciais/bases-cartograficas/malhas-digitais>>.

* Em seguida, acessando Weknow Client Desktop, é necessário criar o mapa nas configurações (*Menu* >> *Configurações* >> *Configurações* >> *Mapas*). Para isso basta selecionar o arquivo adicionado nas pastas anteriormente e informar um *Nome*:

<div align="left"><img src="/files/Thq8OLo42bmElepQMu7c" alt=""></div>

Após esses passos iniciais é possível prosseguir na criação de um componente do tipo Mapa. No seu assistente, é necessário selecionar o mapa que deseja ser utilizado e definir um Vínculo com o metadado selecionado anteriormente.

<div align="left"><img src="/files/EvEzBUwhJ6OYIaP0vPVk" alt=""></div>

<div align="left"><img src="/files/CT0OoouiKW2093usdiXY" alt=""></div>

O *<mark style="color:blue;">Vínculo</mark>* se trata de um campo do metadado que possui os mesmos valores do *<mark style="color:blue;">Index</mark>* do mapa. Ou seja, para criar esse vínculo deve-se primeiro saber se o mapa e o metadado possuem algum campo equivalente. Como no exemplo acima, é selecionado o campo *<mark style="color:blue;">uf</mark>* da tabela *<mark style="color:blue;">person</mark>* e do mapa o index selecionado é a *<mark style="color:blue;">SIGLA</mark>*, dessa forma o vínculo está nos registros onde *<mark style="color:blue;">uf</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">=</mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">SIGLA</mark>*.

* <mark style="color:orange;">**3)**</mark> Mapas com *<mark style="color:blue;">**Bolhas**</mark>* ou *<mark style="color:blue;">**Dispersão**</mark>*: São mapas sem associação com shapefile, porém, podem trabalhar em paralelo a shapefiles estando em séries distintas que se complementem no resultado visual. Levam em consideração: rótulo, valor de agregação, e posições de Latitude e Longitude que devem ser dados do mapeamento de dados do mapa em questão.

A partir da escolha do estilo de mapa desejado, o mapa já será carregado em tela de edição, porém ainda não trará valores ou terá uma configuração de cores condicional. Para fazer isso, basta selecionar na opção *Cores* o modo *Escala* *baseada* *em* *valor* e selecionar o campo do metadado que servirá como *Valor* de cálculo para a escala.

<div align="left"><img src="/files/YB4KUY13gib6KW6eXqtT" alt=""></div>

#### Utilize os botões para auxílio nesta configuração:

“***\****” – Importa sequências de cores padrão da ferramenta, e que podem ser editadas para o mapa sem alterar o modelo de fábrica;

“***+***” – Insere nova faixa, onde então deverá ser editada a cor e Valor / Tipo associado;

“***-***” – Remove faixa de cor selecionada;

“***x***” – Limpa as configurações de cores desta regra de formatação condicional.

Ainda é possível configurar quais faixas apareceram na legenda do mapa e o seu texto personalizado, caso necessário. Para habilitar a legenda basta ir em *<mark style="color:blue;">Menu</mark>* *<mark style="color:blue;">Lateral</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">>></mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">Legenda</mark>* e selecionar a opção *<mark style="color:blue;">Visível</mark>*, já configurando o título e as posições.

<div align="left"><img src="/files/x3y9vI0eUHwGYRvmvz6I" alt=""></div>

Por fim, é possível selecionar qual o texto que aparecerá para cada seção do mapa. Essa configuração pode ser realizada em *<mark style="color:blue;">Textos</mark>*. Basta selecionar a opção *<mark style="color:blue;">Exibir</mark>* *<mark style="color:blue;">valores</mark>* e selecionar a informação que deseja mostrar no mapa. Essa informação pode vir do *<mark style="color:blue;">Metadado</mark>*, do *<mark style="color:blue;">Sistema</mark>* ou ainda do próprio *<mark style="color:blue;">Mapa</mark>*.

<div align="left"><img src="/files/QIQM2aFNeJ5jsvu0daJK" alt=""></div>

Note que além dos valores no próprio mapa, é possível configurar também a *Dica* *Flutuante* utilizando de valores do próprio mapa, como no exemplo acima.

No componente Mapa, ainda é possível configurar as opções de *<mark style="color:blue;">Eixos</mark>*<mark style="color:blue;">,</mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">Margens</mark>* e mais opções gerais como *<mark style="color:blue;">Filtros</mark>* e o *<mark style="color:blue;">Explorador</mark>* *<mark style="color:blue;">de</mark>* *<mark style="color:blue;">dados</mark>*.&#x20;

Ao encerrar as configurações necessárias, clique em **CONCLUIR**.