Bêta 0.2.0-beta.2, pas encore pour un process critique. Voir la roadmap
PNeX logo
Documentation de la version en développement, pas encore publiée. Voir la version stable (0.1.0)

Carte & POIs

Carte des sites avec clustering, objets rattachés, appareils placés, et vos propres fond de carte, géocodeur et calcul d’itinéraire

Surveiller › Carte montre les sites de l'organisation sur une carte. Chaque point d'intérêt (POI) porte un pictogramme, un libellé, une localisation libre (« Bât. A — Étage 2 — Salle 204 ») et des objets attachés : appareils, médias, visites et tableaux de bord. Le même arbre s'ouvre en liste depuis la page Sites (Vue liste / Vue carte).

Appareils placés sur un POI

Un appareil n'est pas un POI : il est placé sur un POI (+ Attacher un objet → Device), avec un emplacement précis optionnel (« Rack 3 — Allée B »). Un repère peut porter plusieurs appareils, mais un appareil n'a qu'un seul placement : l'attacher ailleurs propose de le déplacer ici après confirmation. Supprimer un POI laisse ses appareils à replacer. Médias, visites et tableaux de bord, eux, peuvent être attachés à plusieurs POIs.

Tiroir de POI avec appareil, visite, tableau de bord et panorama rattachés

Sélecteur d'objet à rattacher

Recherche, filtres et clustering

  • Rechercher un repère… cherche aussi dans les slugs et emplacements des appareils placés.
  • Filtres : Attachés à un device, Avec position GPS, et Type (pictogramme).
  • Clustering calculé côté serveur pour les grandes flottes.
Carte avec la liste des repères et ses filtres, et le panneau du repère sélectionné
Carte avec la liste des repères et ses filtres, et le panneau du repère sélectionné

Une couche de positions GPS live des appareils (socle du geofencing) est prévue : aucun firmware n'envoie encore de position GPS. Le filtre Avec position GPS (POIs dont un appareil placé transmet sa position) ne retient donc rien pour l'instant.

Fournisseurs géo

L’organisation branche ses propres moteurs cartographiques, comme elle apporte son propre LLM : un fond de carte sous les points, un géocodeur (adresse vers position et inversement) et un calcul d’itinéraire. PneX n’en fournit aucun. Tant qu’aucun fond n’est ajouté, la carte affiche un fond uni avec « Aucun fond de carte : ajoutez un fournisseur de fond… », et la recherche d’adresse est indisponible.

Les fournisseurs se règlent dans Réglages › Organisations → Gérer (détail de l’organisation), section Fournisseurs géo, par un Owner ou un Admin :

  • Ajouter un fournisseur géo : Nom, Type (Fond de carte ; Nominatim ou Photon pour le géocodage ; Valhalla ou GraphHopper pour l’itinéraire), l’URL (une URL du style MapLibre pour un fond, par exemple chez MapTiler ; l’URL de base du service sinon), puis cochez les Usages qu’il assure (Fond de carte, Géocodage, Adresse d’un point, Itinéraire…) et Par défaut pour ceux que l’organisation doit utiliser.
  • Clé d’API (facultative) : saisie ou choisie dans le coffre. Elle est ajoutée aux URL du fournisseur sous le Nom du paramètre de la clé dans l’URL (key par défaut, comme l’attendent Google et MapTiler ; Mapbox utilise access_token).
  • Un fond peut avoir une URL du style sombre (facultatif) : la carte l’utilise quand l’application est en mode sombre (Profil).
  • Géocodeurs et calculateurs d’itinéraire acceptent des Paramètres (un par ligne, clé=valeur), par exemple accept-language=fr pour Nominatim, un nombre de Requêtes par seconde max (1 par défaut, la règle du Nominatim public) et l’option Le fournisseur autorise la conservation des résultats.
  • Tester charge le style du fond, ou géocode / calcule un itinéraire vers un lieu connu, et affiche la latence ou la raison de l’échec.

Le premier fournisseur d’un usage devient son défaut ; ★ marque les défauts. Members et Viewers voient la liste et utilisent la carte, sans pouvoir modifier les fournisseurs.

Sur la carte

  • Rechercher une adresse… (en haut à gauche) géocode via le géocodeur par défaut, avec des résultats au fil de la frappe. Un clic sur un résultat recentre la carte ; + POI crée un point d’intérêt prérempli avec cette adresse et ses coordonnées.
Recherche d’adresse : les résultats arrivent au fil de la frappe, chacun avec + POI
Recherche d’adresse : les résultats arrivent au fil de la frappe, chacun avec + POI
  • En mode + Ajouter un POI, un clic sur la carte préremplit la localisation avec l’adresse du point quand un géocodage inverse (Adresse d’un point) est configuré.
  • Avec plusieurs fonds, un sélecteur en haut à droite permet d’en changer ; le choix est mémorisé sur cet appareil.
  • L’itinéraire est pour l’instant en voiture seulement. Le calculateur se configure et se teste ici ; la carte ne trace pas encore d’itinéraire.

Le proxy géo du serveur

Le navigateur n’appelle jamais un géocodeur ni un calculateur d’itinéraire : chaque requête passe par le serveur PneX, qui ajoute la clé, met les réponses en cache et respecte le budget de requêtes de chaque fournisseur. Les clés de géocodage et d’itinéraire ne quittent donc jamais le serveur. Le serveur refuse aussi les adresses de fournisseur qui pointent vers lui-même ou ses services internes : utilisez l’adresse LAN de la machine qui fait tourner votre moteur.

La clé d’un fond de carte est une clé navigateur : le navigateur charge lui-même les tuiles, chaque membre peut donc la voir. Restreignez-la à votre adresse PneX dans la console du fournisseur, comme pour toute clé Google Maps ou MapTiler.

Construite sur MapLibre GL, la carte est une page de premier ordre, pas un widget embarqué.

On this page