> 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.5-es_es/cliente-desktop/criacao-e-edicao-de-dashboards/componente-mapa.md).

# Componente Mapa

### Ejemplo:

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

Después de posicionar el componente en el dashboard y elegir la forma de creación, el componente *<mark style="color:blue;">Mapa</mark>* tiene una pantalla centralizada de edición.

* <mark style="color:orange;">**1)**</mark> En *<mark style="color:blue;">Configuraciones</mark>* >> *<mark style="color:blue;">Series</mark>*, se inicia la elección del tipo de mapa, que puede ser: *<mark style="color:blue;">**Polígono**</mark>*, *<mark style="color:blue;">**Burbuja**</mark>* y *<mark style="color:blue;">**Dispersión**</mark>*. Entre estas opciones, los Mapas del tipo Polígonos usan como base de su diseño mapas:

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

* <mark style="color:orange;">**2)**</mark> Mapas vía *<mark style="color:blue;">**Polígono**</mark>*: Con esta elección, tenemos como resultado la distribución de datos sobre un diseño mapeado y delimitado por líneas, formando áreas geométricas:

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

Para la implementación de diseños mapeables con Polígonos, se requieren detalles de configuración previa:

1. Agregar los archivos de mapas dentro de los archivos de Weknow. Todos los mapas que se utilizarán deben estar en formato *Shapefile* (.**shp**), acompañado de los archivos de base de datos (.**dbf**) e índice (.**shx**) del mismo y estar almacenados en la carpeta de instalación de Weknow en `\\...\Common\Configs\files\maps`.

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

* *<mark style="color:blue;">Si las carpetas files y maps no existen, deben crearse antes de guardar los archivos del mapa</mark>*.

#### ¡Atención!

Weknow no genera archivos del tipo Shapefile ni ningún formato similar. Los archivos de mapa deben ser generados/adquiridos por el cliente. Como sugerencia, recomendamos buscar en sitios web de organizaciones como el IBGE: <https://mapas.ibge.gov.br/bases-e-referenciais/bases-cartograficas/malhas-digitais>.

* Luego, accediendo al Weknow Client Desktop, es necesario crear el mapa en las configuraciones (*Menú* >> *Configuraciones* >> *Configuraciones* >> *Mapas*). Para ello, basta con seleccionar el archivo agregado en las carpetas anteriormente y proporcionar un *Nombre*:

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

Después de estos pasos iniciales, es posible proceder con la creación de un componente del tipo Mapa. En su asistente, es necesario seleccionar el mapa que se desea utilizar y definir un Vínculo con el metadato seleccionado anteriormente.

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

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

El *<mark style="color:blue;">Vínculo</mark>* se refiere a un campo del metadato que tiene los mismos valores que el *<mark style="color:blue;">Índice</mark>* del mapa. Es decir, para crear este vínculo, primero se debe verificar si el mapa y el metadato tienen algún campo equivalente. Como en el ejemplo anterior, se selecciona el campo *<mark style="color:blue;">uf</mark>* de la tabla *<mark style="color:blue;">person</mark>* y del mapa el índice seleccionado es la *<mark style="color:blue;">SIGLA</mark>*, de esta forma el vínculo está en los registros donde *<mark style="color:blue;">uf</mark>* = *<mark style="color:blue;">SIGLA</mark>*.

* <mark style="color:orange;">**3)**</mark> Mapas con *<mark style="color:blue;">**Burbujas**</mark>* o *<mark style="color:blue;">**Dispersión**</mark>*: Son mapas sin asociación con shapefile, pero pueden trabajar en paralelo con shapefiles estando en series distintas que se complementen en el resultado visual. Consideran: etiqueta, valor de agregación y posiciones de Latitud y Longitud que deben ser datos del mapeo del mapa en cuestión.

A partir de la elección del estilo de mapa deseado, el mapa ya se cargará en la pantalla de edición, pero aún no mostrará valores ni tendrá una configuración de colores condicional. Para hacer esto, basta con seleccionar en la opción *Colores* el modo *Escala basada en valor* y seleccionar el campo del metadato que servirá como *Valor* de cálculo para la escala.

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

#### Utilice los botones para ayudar en esta configuración:

“***\****” – Importa secuencias de colores predeterminadas de la herramienta, que pueden ser editadas para el mapa sin alterar el modelo de fábrica;

“***+***” – Inserta una nueva franja, donde se deberá editar el color y el Valor/Tipo asociado;

“***-***” – Elimina la franja de color seleccionada;

“***x***” – Limpia las configuraciones de colores de esta regla de formateo condicional.

También es posible configurar qué franjas aparecerán en la leyenda del mapa y su texto personalizado, si es necesario. Para habilitar la leyenda, basta con ir a *<mark style="color:blue;">Menú Lateral</mark>* >> *<mark style="color:blue;">Leyenda</mark>* y seleccionar la opción *<mark style="color:blue;">Visible</mark>*, configurando el título y las posiciones.

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

Por último, es posible seleccionar qué texto aparecerá para cada sección del mapa. Esta configuración puede realizarse en *<mark style="color:blue;">Textos</mark>*. Basta con seleccionar la opción *<mark style="color:blue;">Mostrar valores</mark>* y elegir la información que se desea mostrar en el mapa. Esta información puede provenir del *<mark style="color:blue;">Metadato</mark>*, del *<mark style="color:blue;">Sistema</mark>* o incluso del propio *<mark style="color:blue;">Mapa</mark>*.

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

Además de los valores en el propio mapa, es posible configurar también la *Sugerencia Flotante* utilizando valores del propio mapa, como en el ejemplo anterior.

En el componente Mapa, también es posible configurar las opciones de *<mark style="color:blue;">Ejes</mark>*, *<mark style="color:blue;">Márgenes</mark>* y más opciones generales como *<mark style="color:blue;">Filtros</mark>* y el *<mark style="color:blue;">Explorador de datos</mark>*.

Al finalizar las configuraciones necesarias, haga clic en **CONCLUIR**.