> 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/wedocs-4.0/client-desktop/criacao-e-edicao-de-dashboards/componente-mapa.md).

# Componente Mapa

Weknow Client Desktop –  Criação e Edição de Dashboards - Componente Mapa

### Exemplo**:**

<div align="left"><img src="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2Fev65sV25iQ7058Xy64aC%2Fimage.png?alt=media&amp;token=5795226b-d0ed-4587-9159-6d3b9fe3dd82" 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></mark>* *<mark style="color:blue;">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="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FTsSWjXweOmyMLQfH3Zzy%2Fimage.png?alt=media&amp;token=c1c8ce56-a3a2-4a69-a6c4-21bb23547bc1" 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="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FsLZaeaSMU1HTiYBKp58m%2Fimage.png?alt=media&amp;token=8b9210da-d72d-4c52-a9ad-09b49281f132" 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="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FqaeH987uTgM25RTjtnrP%2Fimage.png?alt=media&amp;token=5f36d385-0c79-4620-9f18-a38af941c768" 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="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FEsYuZKpnlFaRUyHebu3z%2Fimage.png?alt=media&amp;token=80b98f94-7322-4244-bb29-78842f60c22f" 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="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FadLSVySsSdmUKp7CYl6Y%2Fimage.png?alt=media&amp;token=37782447-43ee-4587-884e-5a8215008dfc" alt=""></div>

<div align="left"><img src="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FUnmI8H84z8vASSBiYtYv%2Fimage.png?alt=media&amp;token=0c2d03ae-f281-4a3d-a0e3-1983a0cae402" 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="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2F3eBDlltepFAnsibINpP9%2Fimage.png?alt=media&amp;token=a6404ad2-3a68-4b29-9ed3-7bfb108a71b1" 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="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2FdpMfRDWlE06Pc3V2QByz%2Fimage.png?alt=media&amp;token=916f79d9-2dea-42d4-b9b7-84948257057d" 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="https://2553013097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrGrTmg7jp5aor5PmbcG%2Fuploads%2F97kDxotcDbLxklYKAXgF%2Fimage.png?alt=media&amp;token=fda842e9-39e4-4c9d-a243-c5be4fe544dc" 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**.