Publier une carte Lizmap depuis QGIS, étape par étape

Comment fonctionne la publication Lizmap

Une carte Lizmap n'est pas une copie de votre carte : c'est votre projet QGIS lui-même, lu par QGIS Server et affiché dans le navigateur par Lizmap Web Client. Publier, c'est donc déposer trois choses au bon endroit sur le serveur : le projet QGIS, ses données (sauf celles qui sont dans PostGIS) et un fichier de configuration Lizmap que le plugin crée à côté du projet.

Il vous faut une instance Lizmap en ligne. Si vous n'en avez pas, le guide Installer Lizmap soi-même ou choisir un hébergement présente les deux voies. Avec LizPack Map, l'hébergement Lizmap de LizPack, une instance est prête en quatre minutes environ, avec QGIS Server et une base PostGIS déjà reliés.

• QGIS Desktop, dans une version compatible avec le QGIS Server de l'instance.
• Le plugin Lizmap, installé depuis le gestionnaire d'extensions de QGIS.
• Une instance Lizmap en ligne et un compte qui peut y déposer des projets.
• Un projet QGIS qui s'affiche correctement sur votre poste, avec ses données rangées dans son dossier ou dans PostGIS.

Étape 1 : préparer le projet QGIS

La plupart des cartes qui s'affichent mal en ligne ont un problème de préparation, pas de serveur. Avant de penser à Lizmap, vérifiez votre projet :

• Chemins relatifs. Dans les propriétés du projet, enregistrez les chemins en relatif, et rangez les données dans le dossier du projet ou ses sous-dossiers. Un chemin vers votre disque C: n'existe pas sur le serveur.
• Système de coordonnées. Choisissez le système du projet en connaissance de cause ; pour superposer des fonds de plan web, la projection Web Mercator (EPSG:3857) est la plus simple.
• Formats. Préférez le GeoPackage aux Shapefile dispersés, et PostGIS pour les couches éditées ou volumineuses.
• Noms. Donnez aux couches des noms lisibles : ce sont eux que vos visiteurs verront dans la légende.
• Version de QGIS. Travaillez avec une version de QGIS Desktop compatible avec le QGIS Server de l'instance, idéalement la même.

Avant de passer au plugin, faites un dernier contrôle : fermez puis rouvrez le projet pour vérifier qu'aucune couche n'est signalée en erreur, supprimez les couches de travail inutiles, et vérifiez que les fonds de plan externes que vous utilisez sont accessibles depuis Internet. Un projet qui s'ouvre proprement sur un autre poste de votre service a toutes les chances de s'afficher proprement en ligne.

Étape 2 : configurer la carte avec le plugin Lizmap

Le plugin Lizmap, développé par 3Liz, s'installe depuis le gestionnaire d'extensions de QGIS (menu Extensions, Installer/Gérer les extensions, recherche de Lizmap). Il apparaît ensuite dans le menu et la barre d'outils Internet. N'installez pas dans QGIS Desktop l'extension nommée Lizmap server : elle ne sert que sur le serveur. Il décrit comment la carte doit se comporter en ligne et enregistre ces réglages dans un fichier placé à côté du projet. Dans l'ordre :

1. Ouvrez le plugin Lizmap depuis le menu Internet de QGIS et indiquez, si le plugin le propose, l'adresse de votre instance pour qu'il vérifie les versions.
2. Renseignez les informations générales de la carte : titre, résumé, emprise initiale et échelles.
3. Réglez les couches : celles qui sont visibles au démarrage, celles qui sont interrogeables, les fonds de plan, les couches de base.
4. Activez les outils utiles : recherche, impression à partir de vos mises en page, mesure, table attributaire, édition des couches PostGIS si besoin.
5. Enregistrez la configuration Lizmap, puis enregistrez le projet QGIS.

Le plugin signale lui-même les problèmes qu'il détecte (couche sans clé primaire, chemin absolu, version trop récente). Lisez ses avertissements avant de publier : ils évitent la plupart des cartes vides.

Deux panneaux du plugin méritent une attention particulière. Le panneau des fonds de plan permet de proposer des fonds externes, comme OpenStreetMap, sans les ajouter au projet. Le panneau des infobulles règle ce que les visiteurs voient en cliquant sur un objet : choisissez les champs utiles et masquez les autres. La documentation officielle du plugin, sur docs.lizmap.com, détaille chaque panneau.

Étape 3 : publier la carte Lizmap avec LizPack Publisher

Sur une installation classique, on copie le projet, sa configuration et ses données dans le répertoire de projets du serveur. Avec LizPack, l'extension gratuite LizPack Publisher fait ce travail depuis QGIS :

1. Dans QGIS, menu Extensions, cherchez LizPack et installez LizPack Publisher depuis le dépôt officiel. Il faut QGIS 3.16 au minimum.
2. Connectez-vous avec votre e-mail et votre mot de passe LizPack, puis choisissez l'instance sur laquelle travailler.
3. Le projet ouvert dans QGIS, lancez la publication : il est validé, puis envoyé sur l'instance avec ses données.
4. Ouvrez votre portail Lizmap : la carte y apparaît.

LizPack Publisher sert aussi au quotidien : parcourir les fichiers de l'instance, ouvrir un projet distant dans QGIS, envoyer un dossier complet en conservant sa structure. À partir du plan Pro, il permet d'ajouter les tables de la base PostGIS de l'instance comme couches et d'y importer une couche. Chaque opération est notée dans un journal que vous pouvez copier pour le support.

Vous préférez le navigateur ? Le gestionnaire de fichiers en ligne de l'espace client permet de déposer, organiser et remplacer projets et données sans extension.

Publier des couches PostGIS

Les fichiers conviennent pour des données stables. Dès qu'une couche est modifiée souvent, partagée entre plusieurs projets ou éditée en ligne, PostGIS devient le bon choix : la carte Lizmap lit directement la base, sans republication, et plusieurs personnes peuvent y travailler en même temps.

1. Créez dans QGIS une connexion à la base PostGIS de votre instance. Avec LizPack Map, chaque instance a sa base PostgreSQL et PostGIS ; à partir du plan Pro, vous vous y connectez depuis QGIS Desktop ou pgAdmin, en connexion chiffrée.
2. Importez vos couches dans la base. LizPack Publisher permet, à partir du plan Pro, d'importer une couche dans la base de l'instance et de la diagnostiquer, puis d'ajouter les tables comme couches du projet.
3. Vérifiez que chaque table a une clé primaire et un index spatial : sans clé primaire, l'interrogation et l'édition échouent ; sans index, la carte ralentit.
4. Remplacez dans le projet les couches fichiers par les couches PostGIS, réglez les styles, enregistrez, puis republiez.

Utilisez dans le projet une connexion qui fonctionne aussi depuis le serveur. Une couche PostGIS pointant vers une base installée sur votre propre poste ne s'affichera pas en ligne.

Organisez la base dès le début : un schéma par thème ou par service, des noms de tables en minuscules et sans espaces, et des noms de colonnes explicites. Ces conventions évitent bien des erreurs entre QGIS, Lizmap et les autres logiciels qui liront la même base, et elles facilitent le travail de la personne qui reprendra le projet après vous. Gardez aussi une trace de ce que contient chaque table, de sa source et de la date de sa dernière mise à jour.

Permettre l'édition en ligne

Lizmap permet de saisir et de modifier des données directement dans le navigateur, sans QGIS. C'est utile pour un signalement, un inventaire de terrain simple ou la mise à jour d'un état par un service qui n'utilise pas de SIG. La configuration se fait dans le panneau d'édition du plugin Lizmap :

1. Préparez la couche dans PostGIS, avec une clé primaire et des types de champs adaptés.
2. Dans QGIS, configurez le formulaire d'attributs de la couche : ordre des champs, listes de valeurs, champs obligatoires, valeurs par défaut. Lizmap reprend ce formulaire en ligne.
3. Dans le plugin Lizmap, ajoutez la couche à l'édition et choisissez les actions autorisées : créer, modifier les attributs, modifier la géométrie, supprimer.
4. Limitez l'édition aux groupes d'utilisateurs concernés.
5. Enregistrez la configuration, enregistrez le projet, republiez, puis testez avec un compte du groupe autorisé.

Commencez avec peu de champs et des listes de valeurs fermées, et testez le formulaire avec les personnes qui le rempliront réellement : des données saisies proprement dès le départ valent mieux qu'un formulaire exhaustif que personne ne remplit. Pour une collecte hors ligne sur téléphone, l'application QField est plus adaptée ; LizPack Field l'associe à la même base PostGIS.

Impression et atlas

Les visiteurs d'un portail Lizmap peuvent imprimer la carte à partir des mises en page que vous avez créées dans QGIS. Le gabarit, les logos, la légende, l'échelle et les textes viennent donc de QGIS : ce que vous voyez dans le composeur est ce que vos utilisateurs obtiennent.

• Prévoyez peu de mises en page, bien nommées : par exemple une A4 portrait et une A3 paysage, plutôt qu'une dizaine de variantes.
• Utilisez des textes dynamiques (date, titre du projet) plutôt que des textes figés qu'il faudra corriger.
• Vérifiez la résolution : une impression en haute résolution coûte du temps de calcul au serveur.
• Pensez à l'atlas : le plugin Lizmap a un panneau dédié à l'atlas, utile pour parcourir une série d'objets, par exemple une fiche par commune ou par parcelle.

Étape 4 : régler les droits et partager

Décidez d'abord qui doit voir la carte. Dans l'administration de Lizmap, vous réglez pour chaque répertoire de projets les groupes qui peuvent le consulter, et vous créez les comptes de vos utilisateurs. Une carte publique ne demande aucune connexion ; une carte interne se réserve à un groupe.

Pour aller plus loin, les modules Lizmap ajoutent des fonctions au portail, comme des tableaux de bord composés dans QGIS. Le guide Créer un tableau de bord Lizmap explique comment.

1. Dans l'administration Lizmap, créez les groupes qui correspondent à vos publics : par exemple un groupe par service.
2. Créez les comptes des utilisateurs et rattachez chacun à son ou ses groupes.
3. Pour chaque répertoire de projets, accordez aux groupes le droit de voir les projets, et seulement à eux.
4. Connectez-vous avec un compte de test de chaque groupe pour vérifier ce qu'il voit.

Mettre à jour une carte Lizmap déjà publiée

Une carte publiée vit : on ajoute une couche, on corrige un style, on change un fond de plan. La règle est simple : on modifie toujours dans QGIS, jamais sur le serveur, puis on republie. Le projet de votre poste reste la référence.

1. Ouvrez le projet dans QGIS et faites vos modifications.
2. Si vous avez ajouté ou renommé des couches, rouvrez le plugin Lizmap pour les régler, puis enregistrez sa configuration.
3. Enregistrez le projet QGIS.
4. Republiez : le projet, sa configuration et les données modifiées remplacent les anciennes versions sur l'instance.
5. Rechargez la carte dans le navigateur pour vérifier le résultat, y compris sur un téléphone si vos utilisateurs la consultent en déplacement.

Les couches stockées dans PostGIS font exception : leurs données sont lues directement dans la base. Une ligne ajoutée ou modifiée dans la table apparaît sur la carte sans republier le projet. C'est l'une des meilleures raisons de passer vos couches vivantes en PostGIS plutôt qu'en fichiers. Seuls les changements de structure, de style ou de configuration demandent une nouvelle publication.

Les problèmes les plus fréquents

Pour chercher la cause d'un problème, commencez par les avertissements du plugin Lizmap dans QGIS, puis par le journal des opérations de LizPack Publisher, qui note chaque envoi et se copie en un clic pour une demande au support. Vérifiez enfin la carte dans une fenêtre de navigation privée : vous verrez ce que voit un visiteur non connecté.

Questions fréquentes