Tarjetas de mapa

La tarjeta Map representa en el mapa las filas de una tabla que tienen coordenadas como marcadores. Puede dibujar sobre un mapa geográfico o sobre una imagen, como un plano de planta, colorear cada marcador según un estado o un valor, delimitar zonas y dibujar rutas que se pueden reproducir. Las soluciones listas para usar la emplean para sitios, estaciones meteorológicas y seguimiento de personal.

Datos

Slot	Contiene	Obligatorio
Points	Una fila por marcador con columnas de latitud y longitud	Sí
Zones	Una fila por zona con un contorno: una lista de esquinas [latitude, longitude]	No
Routes	Una fila por ruta con un trayecto: una lista de puntos [latitude, longitude] en orden, opcionalmente un tercer valor (una hora)	No
Dirección del plano	La imagen de un mapa de imagen, a partir de un valor	No

Buenas fuentes para Points: Status under an asset (sitios en su color de estado), Latest values of many devices con claves lat y lng, o Devices (live connection state) cuando sus dispositivos tienen coordenadas. Una fila sin coordenadas válidas se omite; si no hay ninguna, la tarjeta muestra «No rows with valid coordinates.»

Configure Latitude column (por defecto lat), Longitude column (lng) y Label column (label). La Row id column identifica el marcador en las acciones de clic.

Tipo de mapa

Map	Dibuja
Geographic (por defecto)	Teselas del mapa. Map style: Follow the theme, Light, Light, no labels, Dark, Streets (colour), Satellite.
Image (floor plan)	Una imagen en lugar de teselas. Las columnas de latitud y longitud contienen entonces y y x en píxeles de la imagen, desde su esquina superior izquierda. Configure Image (una ruta interna o una dirección https), Image width (px) e Image height (px).

Marcadores y colores

Ajuste	Valores y valores por defecto
Marker	Pin (por defecto), Dot, Circle, Icon; Marker size (px) de 8 a 64 (24)
Group nearby markers	Desactivado. Activado: los marcadores superpuestos se convierten en una burbuja con un contador; un clic amplía la vista. Distancia de agrupación de 10 a 200 px (40).
Colour from	One colour, A status column (por defecto), Ranges on a value
Status column	Por defecto status. Su valor elige el color: un valor indicado en Status colours, una palabra de estado (Online, Warning, Offline…), un nombre de color (success, warning, error, info, neutral, primary) o un color CSS.
Status colours	Hasta 20 filas: Value, Colour, Shown as, Glyph (un icono en lugar del marcador), Picture (una imagen, tiene prioridad sobre el glifo)
Value column	Con Ranges on a value: la columna cuyo valor elige un rango de color
Show a legend	Activada, abajo a la izquierda. Cuenta los marcadores por estado y se oculta con un solo color.

Nombres y descripciones emergentes

Ajuste	Valores y valores por defecto
Show names	Always, Alerts only (los marcadores cuyo estado indica aviso o peor), Never (por defecto)
Open tooltips on	Hover (por defecto), Click (la descripción permanece abierta para poder usar su enlace), Never
Tooltip fields	Hasta 6 columnas mostradas como filas de etiqueta y valor
Marker link, Link text	Una ruta interna como /admin/devices/{id}; {column} toma el valor de la fila pulsada

Modo de privacidad

Para mapas de personas, active Privacy mode. «Los nombres quedan fuera de la página: un marcador se etiqueta con su función, y la columna de etiqueta y las columnas siguientes se excluyen de las descripciones, enlaces y clics.» Configure la Role column (un trabajador, un visitante) y las Columns that identify (un número de credencial, una empresa, un teléfono; hasta 8). La Alert column indica la columna que señala que un marcador tiene un problema (warning, critical, alarm, SOS, fall).

Vista y controles

Ajuste	Valores y valores por defecto
Fit the view to the markers	Activado, con 32 px alrededor de ellos
Centre latitude, Centre longitude, Zoom	Dónde se sitúa el mapa cuando no encaja (zoom de 1 a 18, por defecto 4); zoom mínimo y máximo
Zoom buttons	Activados, arriba a la izquierda
Layer switch	Activado. Permite a los usuarios mostrar u ocultar marcadores, zonas y rutas cuando hay más de uno.
Zoom with the mouse wheel	Desactivado: la rueda desplaza el panel más allá del mapa; use los botones o un pellizco

Zonas

Enlace Zones a una tabla cuyas filas tengan una columna de contorno (por defecto positions) de al menos tres esquinas. Configure Zone name column, Zone colour (primary, info, success, warning, error, neutral, o una Zone colour column) y Zone fill opacity (0.2).

Rutas y reproducción

Enlace Routes a filas con una columna de trayecto (por defecto positions). Route width (px) de 1 a 12 (3), Dashed routes desactivado. Active Replay controls para reproducir, pausar y desplazarse por las rutas: un punto en movimiento sigue cada una, con su inicio y su fin marcados, a 1×, 2×, 5× o 10×. Cuando cada punto tiene una hora, la reproducción sigue el reloj.

Ejemplo: reproducir por dónde fue un localizador hoy. La solución de seguimiento de personal construye su ruta así:

1. Enlace Points con el lat y el lng más recientes del localizador.
2. Enlace Routes a Device readings over time (live) con las claves lat,lng.
3. Añada un script de cálculo que empareje las dos series por hora en una sola fila de ruta, [lat, lng, time] por punto, del más antiguo al más reciente, conservando como máximo 256 puntos. Consulte Compute scripts.
4. Active Replay controls.

Instale la solución para obtener este panel listo: Personnel tracking.

Clics y arrastre de marcadores

Un clic en un marcador puede ejecutar acciones (When a map marker is clicked): establecer el parámetro de dispositivo o de sitio del panel, abrir una página de detalle, abrir otro panel. En un mapa de imagen, Markers can be dragged permite al usuario soltar un marcador donde corresponde; el comando de la tarjeta (When a marker is dropped) recibe { id, x, y } en píxeles enteros. Sin comando, los marcadores permanecen en su sitio.

Solución de problemas

Lo que ve	Causa
«Bind a table with latitude and longitude columns in this widget’s settings.»	El slot de puntos está vacío.
«No rows with valid coordinates.»	Las columnas de latitud y longitud faltan, están vacías o fuera de rango. Compruebe los nombres de las columnas.
Todos los marcadores tienen el mismo color	La columna de estado contiene valores que la tarjeta no reconoce, así que toman el único color de la tarjeta. Añádalos a Status colours.
El mapa desplaza la página en lugar de ampliarse	Zoom with the mouse wheel está desactivado. Use los botones o actívelo.