|Documentation

Publier vos cartes

Déposer un projet sur votre instance

Publier une carte, c'est déposer votre projet QGIS et ses données dans l'espace de fichiers de l'instance. Vous pouvez le faire depuis QGIS avec l'extension LizPack Publisher, ou depuis l'espace client avec le gestionnaire de fichiers, comme ci-dessous.

  1. Sur la fiche de l'instance, cliquez sur Fichiers. Le gestionnaire de fichiers s'ouvre à la Racine de l'espace.
  2. Créez un dossier pour le projet avec le bouton Nouveau dossier de la barre d'outils, puis ouvrez-le.
  3. Cliquez sur Envoyer : la fenêtre Envoyer propose Envoyer un dossier, pour envoyer d'un coup le dossier du projet, ou Envoyer des fichiers. Vous pouvez aussi glisser les fichiers ou les dossiers directement dans la liste.
  4. La fenêtre de suivi montre l'envoi, puis le Traitement par le serveur, qui contrôle les projets. Fermez-la quand elle affiche Terminé.

Le projet doit être enregistré au format .qgs et accompagné de son fichier de configuration Lizmap (voir la page suivante). Ses données partent avec lui : des fichiers rangés dans le même dossier, désignés par des chemins relatifs, ou des tables dans la base de l'instance. Pour les gros volumes, la base est préférable : le rendu est plus rapide et plusieurs projets lisent la même table sans la recopier.

Une couche qui pointe vers un fichier resté sur votre ordinateur s'affichera vide en ligne : le serveur n'a pas accès à votre disque. Le validateur de projet repère ces chemins avant le dépôt.

Ce que le dépôt contrôle

Chaque projet .qgs est examiné à son arrivée. Deux défauts le font refuser : des connexions PostgreSQL qui ne visent pas la base de cette instance (hôte, base, port, utilisateur et mot de passe de la fiche), et des couches qui n'ont pas toutes le même système de coordonnées, fonds de carte mis à part. La fenêtre s'intitule alors Envoi incomplet et donne, sous Détails, les couches et les valeurs en cause. Les autres fichiers de l'envoi sont bien enregistrés.

Les autres défauts n'empêchent pas la publication. La fenêtre annonce Publié et nomme les couches à surveiller, celles qui rendront la carte lente.

Vous n'avez rien à modifier dans les connexions à la base. Votre projet garde l'adresse publique de la base, celle de la fiche ; au dépôt, nous le faisons passer par le réseau interne de l'instance, et un projet téléchargé depuis Fichiers retrouve l'adresse publique, prêt à rouvrir dans QGIS.

La page d'accueil du portail : les projets publiés, rangés par répertoire Lizmap, chacun avec son image, son titre et le bouton qui ouvre la carte.

La page d'accueil du portail range les projets par répertoire Lizmap. Si un projet déposé n'y apparaît pas, vérifiez qu'il a bien son fichier de configuration, puis, dans l'administration Lizmap, que son dossier est déclaré comme répertoire et que votre compte a le droit de le voir.

Le fichier de configuration Lizmap

Un projet publié tient en deux fichiers rangés côte à côte : le projet QGIS, par exemple commune.qgs, et sa configuration Lizmap, commune.qgs.cfg. Le second dit comment la carte se comporte en ligne : couches visibles au départ, outils offerts aux visiteurs, emprise du premier affichage, fonds de carte.

Ce fichier se produit dans QGIS avec l'extension Lizmap, au moment où vous réglez la carte web. Cette extension n'est pas la nôtre ; sa documentation décrit chaque option.

Sans fichier de configuration, le projet ne s'affiche pas sur le portail. Ce n'est pas une panne de l'instance : rien n'indique au portail qu'il doit publier ce projet.

Après toute modification dans QGIS ou dans l'extension Lizmap, redéposez les deux fichiers ensemble. Le gestionnaire signale les Fichiers existants ; Remplacer écrase l'ancienne version, sans retour possible.

Si votre projet affiche des couches de votre espace GeoServer LizPack, nous ajustons la configuration au dépôt : ces couches passent par votre instance au lieu d'être appelées directement par le navigateur, et vos identifiants GeoServer ne partent pas chez vos visiteurs.

La carte en ligne : groupes, cases de visibilité, légende et choix du fond de carte reprennent l'organisation du projet et de sa configuration.
L'extension LizPack Publisher envoie depuis QGIS le projet, sa configuration et ses données en une fois : voir Publier depuis QGIS.

Réutiliser vos cartes ailleurs

Chaque projet publié est aussi servi par les protocoles normalisés de la cartographie en ligne. D'autres logiciels peuvent ainsi afficher ou interroger vos couches sans copie des données.

  • WMS : la carte sous forme d'images, pour l'afficher dans un autre logiciel ou un autre site.
  • WFS : les objets eux-mêmes, avec leurs attributs, pour les interroger ou les analyser.
  • WMTS : des tuiles à échelles fixes, pour un affichage rapide.

L'adresse d'un projet suit toujours le même modèle : https://votre-nom.lizpack.com/index.php/lizmap/service?repository=répertoire&project=projet, où répertoire est le répertoire Lizmap et projet le nom du fichier sans .qgs. Dans QGIS, ajoutez-la comme connexion WMS/WMTS ou WFS. La carte QGIS Server de la fiche de l'instance rappelle l'adresse de l'instance et les Protocoles annoncés.

Un projet public se consomme sans identifiant. Un projet restreint demande un compte de votre portail, avec ses droits.

Un projet public expose par WFS ses données telles quelles, attributs compris. Si certaines ne doivent pas sortir, restreignez l'accès au projet : ne comptez pas sur le fait que personne ne trouvera l'adresse.

Valider un projet avant de le publier

Le validateur examine un projet QGIS sans le publier : rien n'est enregistré, rien n'est mis en ligne. Il lit le projet et interroge les tables qu'il utilise dans la base de l'instance. Il sert avant un dépôt, ou pour comprendre pourquoi une carte déjà publiée s'affiche mal.

La validation : choisissez un projet déjà déposé, ou déposez un fichier de votre ordinateur. Rien n'est publié.
  1. Dans le gestionnaire de fichiers de l'instance (Fichiers sur sa fiche), ouvrez Plus d'actions, les trois points de la barre d'actions, puis choisissez Valider le projet.
  2. Si le dossier ouvert contient un seul projet .qgs, l'analyse commence aussitôt. Sinon, la page Validation de projet demande Quel projet analyser ? : choisissez un projet de l'instance, ou déposez un fichier .qgs de votre ordinateur.
  3. Patientez quelques secondes pendant l'analyse : la page affiche l'étape en cours.

Seuls les fichiers .qgs sont acceptés. Un projet .qgz analysé depuis votre ordinateur doit d'abord être réenregistré au format .qgs dans QGIS.

Lire le rapport

Si les connexions du projet ne visent pas la base de l'instance, un bandeau l'annonce en tête : Ce projet serait refusé au dépôt, avec la liste des connexions fautives. Une rangée de filtres suit : Tous, puis un filtre par gravité avec son nombre de signalements. Cliquer sur un filtre ne montre que cette gravité ; cliquer à nouveau, ou sur Tous, rétablit la liste complète.

Le rapport : une rangée de filtres, puis une section par nature de signalement, avec ses couches, sa conséquence et sa solution à copier.
GravitéCe qu'elle signifieExemples
BloquantLa couche ou la carte ne s'affichera pas correctement, ou pas du tout.Couche temporaire, chemin de votre ordinateur, table absente de la base, système de coordonnées manquant, couches dans des projections différentes, trop de mises en page.
ImportantLa carte risque d'être lente ou de tomber en erreur.Table sans clé primaire entière, expression qui interroge d'autres couches pour chaque objet, système de coordonnées différent de celui de la base, étendue nulle.
RemarqueRien ne casse aujourd'hui, mais l'affichage ralentira avec le volume.Grande couche dessinée à toutes les échelles, statistiques de table jamais calculées, polygones très détaillés.

Les signalements de même nature sont réunis dans une seule section : le tableau des couches concernées, ce que l'on constate pour chacune, la Conséquence et la Solution à appliquer dans QGIS ou dans la base. Au-delà de cinq couches, un lien sous la liste affiche les autres. Quand la solution est une commande, Copier la copie, toutes couches comprises. Corrigez les sections Bloquant en premier, enregistrez le projet, puis relancez l'analyse. Quand il ne reste rien, la page affiche Aucun défaut détecté.

Exporter en CSV et Exporter en JSON enregistrent le rapport sur votre poste. Le CSV s'ouvre dans un tableur ; joignez-le à votre message si vous écrivez au support à propos de ce projet. Retour aux fichiers ramène au gestionnaire de fichiers.