Connexion au serveur QGIS CartograFit

Ce guide vous accompagne pour configurer une connexion WFS dans QGIS afin d'accéder à vos données CartograFit en temps réel.

Option QGIS Server requise

Ce guide s'adresse aux utilisateurs ayant souscrit à l'option QGIS Server. Si vous n'avez pas cette option, consultez le guide Télécharger vos données pour accéder à vos fichiers.

Prérequis

• QGIS 3.22+ installé sur votre ordinateur
• Abonnement CartograFit avec l'option QGIS Server active
• Connexion internet stable

Vue d'ensemble

L'option QGIS Server vous donne accès à un serveur WFS hébergé par CartograFit. Ce serveur est pré-configuré avec vos données et accessible via une connexion sécurisée par token JWT.

┌─────────────┐     WFS/JWT      ┌─────────────────────┐
│    QGIS     │ ───────────────► │  Serveur CartograFit │
│  (votre PC) │                  │    (cloud managé)    │
└─────────────┘                  └─────────────────────┘

Étape 1 : Récupérer vos informations de connexion

1. Connectez-vous à CartograFit
2. Accédez à Mes Abonnements
3. Sélectionnez l'abonnement avec l'option QGIS Server
4. Cliquez sur Accès QGIS

Vous trouverez sur cette page :

Information	Description
URL du serveur	Adresse de votre serveur WFS (propre à votre organisation)
Nom du serveur	Identifiant de votre instance
Token JWT	Clé d'authentification (à générer)

Étape 2 : Générer un token JWT

1. Sur la page Accès QGIS, cliquez sur Générer un token
2. Le token s'affiche à l'écran
3. Cliquez sur Copier pour le copier dans le presse-papiers

Sécurité du token

• Le token JWT est personnel et confidentiel
• Ne partagez jamais votre token
• Les tokens ont une durée de validité limitée (généralement 24h)
• Vous pouvez générer un nouveau token à tout moment

Étape 3 : Configurer QGIS

Ouvrir le gestionnaire de sources de données

1. Lancez QGIS
2. Menu Couche → Gestionnaire des sources de données (ou Ctrl+L)
3. Sélectionnez WFS / OGC API - Features dans le panneau de gauche

Créer une nouvelle connexion

1. Cliquez sur Nouveau
2. Remplissez les informations :

Champ	Valeur
Nom	CartograFit (ou un nom de votre choix)
URL	L'URL fournie sur la page Accès QGIS

Configurer l'authentification

1. Dans la section Authentification, cliquez sur l'icône + (créer une configuration)
2. Sélectionnez le type HTTP Header
3. Remplissez :

Champ	Valeur
Nom	CartograFit JWT
Header	Authorization
Valeur	Bearer VOTRE_TOKEN_JWT

Format du token

Le préfixe Bearer (avec l'espace) est obligatoire.

Exemple correct :

Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

4. Cliquez sur OK pour enregistrer la configuration d'authentification
5. Cliquez sur OK pour enregistrer la connexion

Étape 4 : Tester et ajouter les couches

Tester la connexion

1. Dans le gestionnaire de sources de données, sélectionnez votre connexion CartograFit
2. Cliquez sur Connecter
3. Si la connexion réussit, les couches disponibles s'affichent

Couches disponibles

Selon votre abonnement, vous aurez accès à :

Couche	Type	Description
parking_areas	Point/Polygon	Places de stationnement détectées
h3_cells	Polygon	Cellules H3 avec statistiques agrégées
roads	LineString	Routes avec informations de densité
urban_furniture	Point	Mobilier urbain (bancs, arbres, etc.)
road_markings	Point/LineString	Marquages routiers

Ajouter des couches

1. Sélectionnez les couches souhaitées (maintenez Ctrl pour sélection multiple)
2. Cliquez sur Ajouter
3. Les couches apparaissent dans votre projet QGIS

Optimisation des performances

Filtrage spatial

Pour de meilleures performances, limitez les données à votre zone de travail :

1. Avant d'ajouter une couche, cochez Utiliser uniquement les entités dans l'emprise de la vue
2. Ou définissez un filtre CQL dans les options avancées :

BBOX(geometry, 55.2, -21.4, 55.8, -20.8)

Limite d'entités

Par défaut, WFS limite le nombre d'entités téléchargées. Pour modifier :

1. Clic droit sur la couche → Propriétés
2. Onglet Source
3. Modifiez Limite des entités téléchargées

Cache réseau

Pour améliorer les temps de chargement :

1. Menu Préférences → Options
2. Onglet Réseau
3. Augmentez la taille du cache si nécessaire

Renouvellement du token

Les tokens JWT expirent après une durée limitée. Quand votre token expire :

1. Retournez sur CartograFit
2. Accédez à Accès QGIS de votre abonnement
3. Générez un nouveau token
4. Dans QGIS :
   • Menu Préférences → Options → Authentification
   • Modifiez la configuration CartograFit JWT
   • Remplacez l'ancien token par le nouveau

Configuration sauvegardée

QGIS conserve votre configuration de connexion. Seul le token JWT devra être mis à jour périodiquement.

Dépannage

Erreur 401 - Non autorisé

Causes possibles :

• Token JWT expiré
• Token mal formaté (préfixe Bearer manquant)

Solution :

1. Générez un nouveau token depuis CartograFit
2. Vérifiez que le format est Bearer [token] avec l'espace

Erreur 403 - Accès refusé

Causes possibles :

• Option QGIS Server non active sur votre abonnement
• Permissions insuffisantes

Solution : Contactez le support pour vérifier votre abonnement.

Connexion lente

Solutions :

• Activez le filtrage spatial
• Réduisez la limite d'entités
• Vérifiez votre connexion internet
• Augmentez le cache réseau QGIS

Couches vides

Causes possibles :

• Emprise de vue hors zone de données
• Filtres trop restrictifs

Solution :

1. Zoomez sur la zone couverte par votre abonnement
2. Vérifiez les filtres appliqués

Impossible de se connecter

Vérifications :

1. L'URL du serveur est correcte (copiée depuis CartograFit)
2. Votre connexion internet fonctionne
3. Aucun proxy ou pare-feu ne bloque la connexion

Comparaison avec les fichiers téléchargeables

Critère	Fichiers (GeoPackage)	QGIS Server (WFS)
Accès	Téléchargement manuel	Connexion temps réel
Mises à jour	Notification + re-téléchargement	Automatique
Hors ligne	Oui	Non
Performances	Optimal (local)	Dépend de la connexion
Styles	Intégrés (GeoPackage)	Configurés sur le serveur

Quelle méthode choisir ?

• Fichiers : travail hors ligne, performances maximales, contrôle des versions
• WFS : données toujours à jour, travail collaboratif, pas de gestion de fichiers

Ressources complémentaires

• Télécharger vos données (fichiers)
• Import GeoPackage dans QGIS
• Types de données CartograFit
• Documentation officielle QGIS WFS

Support

En cas de problème avec votre connexion QGIS Server :

✉️Nous contacter