Cartes

La carte Map place sur un graphique les lignes de tableau qui ont des coordonnées sous forme de marqueurs. Elle peut s’afficher sur une carte géographique ou sur une image, comme un plan d’étage, colorer chaque marqueur selon un statut ou une valeur, délimiter des zones et tracer des itinéraires pouvant être rejoués. Les solutions prêtes à l’emploi l’utilisent pour les sites, les stations météo et le suivi du personnel.

Données

Emplacement	Contient	Obligatoire
Points	Une ligne par marqueur avec des colonnes de latitude et de longitude	Oui
Zones	Une ligne par zone avec un contour : une liste de [latitude, longitude] pour les coins	Non
Routes	Une ligne par itinéraire avec un tracé : une liste de points [latitude, longitude] dans l’ordre, éventuellement une troisième valeur (une heure)	Non
Adresse du plan	L’image d’une carte image, à partir d’une valeur	Non

Sources utiles pour Points : Statut sous un actif (sites dans leur couleur de statut), Dernières valeurs de nombreux appareils avec les clés lat et lng, ou Appareils (état de connexion en direct) si vos appareils portent des coordonnées. Une ligne sans coordonnées valides est ignorée ; sans aucune, la carte affiche « Aucune ligne avec des coordonnées valides. »

Réglez Colonne de latitude (par défaut lat), Colonne de longitude (lng) et Colonne d’étiquette (label). La Colonne d’identifiant de ligne identifie le marqueur dans les actions de clic.

Type de carte

Map	Affiche
Géographique (par défaut)	Tuiles de carte. Style de carte : Suivre le thème, Clair, Clair, sans étiquettes, Sombre, Rues (couleur), Satellite.
Image (plan d’étage)	Une image au lieu des tuiles. Les colonnes de latitude et de longitude contiennent alors y et x en pixels de l’image, depuis son coin supérieur gauche. Réglez Image (un chemin interne ou une adresse https), Largeur de l’image (px) et Hauteur de l’image (px).

Marqueurs et couleurs

Réglage	Valeurs et valeurs par défaut
Marqueur	Épingle (par défaut), Point, Cercle, Icône ; Taille du marqueur (px) de 8 à 64 (24)
Regrouper les marqueurs proches	Désactivé. Activé : les marqueurs qui se chevauchent deviennent une bulle avec un nombre ; un clic zoome. Distance de regroupement de 10 à 200 px (40).
Couleur selon	Une couleur, Une colonne de statut (par défaut), Plages sur une valeur
Colonne de statut	Par défaut status. Sa valeur choisit la couleur : une valeur nommée dans Couleurs de statut, un mot de statut (Online, Warning, Offline…), un nom de couleur (success, warning, error, info, neutral, primary) ou une couleur CSS.
Couleurs de statut	Jusqu’à 20 lignes : Valeur, Couleur, Affiché comme, Glyphe (une icône à la place du marqueur), Image (une image, prime sur le glyphe)
Colonne de valeur	Avec Plages sur une valeur : la colonne dont la valeur choisit une plage de couleur
Afficher une légende	Activée, en bas à gauche. Elle compte les marqueurs par statut et se masque avec une seule couleur.

Noms et infobulles

Réglage	Valeurs et valeurs par défaut
Afficher les noms	Toujours, Alertes seulement (les marqueurs dont le statut indique un avertissement ou pire), Jamais (par défaut)
Ouvrir les infobulles au	Survol (par défaut), Clic (l’infobulle reste ouverte pour pouvoir utiliser son lien), Jamais
Champs de l’infobulle	Jusqu’à 6 colonnes affichées en lignes libellé et valeur
Lien du marqueur, Texte du lien	Un chemin interne tel que /admin/devices/{id} ; {column} prend la valeur de la ligne cliquée

Mode confidentialité

Pour les cartes de personnes, activez le Mode confidentialité. « Les noms restent hors de la page : un marqueur est étiqueté avec son rôle, et la colonne d’étiquette et les colonnes ci-dessous sont exclues des infobulles, des liens et des clics. » Réglez la Colonne de rôle (un ouvrier, un visiteur) et les Colonnes d’identification (un numéro de badge, une entreprise, un téléphone ; jusqu’à 8). La Colonne d’alerte nomme la colonne qui indique qu’un marqueur est en difficulté (warning, critical, alarm, SOS, fall).

Vue et commandes

Réglage	Valeurs et valeurs par défaut
Ajuster la vue aux marqueurs	Activé, avec 32 px autour
Latitude du centre, Longitude du centre, Zoom	Où la carte se place lorsqu’elle ne s’ajuste pas (zoom de 1 à 18, par défaut 4) ; zoom minimum et maximum
Boutons de zoom	Activés, en haut à gauche
Sélecteur de calques	Activé. Permet aux visiteurs d’afficher ou de masquer les marqueurs, zones et itinéraires lorsqu’il y en a plusieurs.
Zoomer avec la molette de la souris	Désactivé : la molette fait défiler le tableau au-delà de la carte ; utilisez les boutons ou un pincement

Zones

Liez Zones à un tableau dont les lignes ont une colonne de contour (par défaut positions) d’au moins trois coins. Réglez la Colonne du nom de zone, la Couleur de zone (primary, info, success, warning, error, neutral, ou une Colonne de couleur de zone) et l’Opacité de remplissage de zone (0.2).

Itinéraires et rejeu

Liez Routes à des lignes ayant une colonne de tracé (par défaut positions). Épaisseur de l’itinéraire (px) de 1 à 12 (3), Itinéraires en pointillés désactivé. Activez les Commandes de rejeu pour lire, mettre en pause et faire défiler les itinéraires : un point mobile suit chacun, avec son début et sa fin marqués, à 1×, 2×, 5× ou 10×. Lorsque chaque point porte une heure, le rejeu suit l’horloge.

Exemple : rejouer le trajet d’un traceur aujourd’hui. La solution de suivi du personnel construit son itinéraire ainsi :

1. Liez Points aux derniers lat et lng du traceur.
2. Liez Routes à Relevés d’appareil dans le temps (en direct) avec les clés lat,lng.
3. Ajoutez un script de calcul qui associe les deux séries par heure en une seule ligne d’itinéraire, [lat, lng, time] par point, du plus ancien au plus récent, en conservant au maximum 256 points. Voir Scripts de calcul.
4. Activez les Commandes de rejeu.

Installez la solution pour obtenir ce tableau prêt à l’emploi : Suivi du personnel.

Clics et déplacement des marqueurs

Un clic sur un marqueur peut lancer des actions (Lorsqu’un marqueur de carte est cliqué) : définir le paramètre appareil ou site du tableau, ouvrir une page de détail, ouvrir un autre tableau. Sur une carte image, Les marqueurs peuvent être déplacés permet à un visiteur de déposer un marqueur à son emplacement ; la commande de la carte (Lorsqu’un marqueur est déposé) reçoit { id, x, y } en pixels entiers. Sans commande, les marqueurs restent en place.

Dépannage

Ce que vous voyez	Cause
« Liez un tableau avec des colonnes de latitude et de longitude dans les réglages de ce widget. »	L’emplacement des points est vide.
« Aucune ligne avec des coordonnées valides. »	Les colonnes de latitude et de longitude sont absentes, vides ou hors plage. Vérifiez les noms des colonnes.
Tous les marqueurs ont la même couleur	La colonne de statut contient des valeurs que la carte ne connaît pas : elles prennent la couleur unique de la carte. Ajoutez-les dans Couleurs de statut.
La carte fait défiler la page au lieu de zoomer	Zoomer avec la molette de la souris est désactivé. Utilisez les boutons ou activez-le.