Connexion au serveur QGIS CartograFit

Ce guide vous accompagne pour configurer une connexion à votre serveur QGIS CartograFit managé.

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.

Services disponibles selon votre offre

Offre	WFS	WMS
Mutualisée	✓
Dédiée	✓	✓

• WFS (Web Feature Service) : données vectorielles brutes, stylées dans votre SIG
• WMS (Web Map Service) : tuiles pré-rendues avec styles CartograFit côté serveur

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 QGIS 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/WMS/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 WFS	Adresse de votre serveur WFS (toutes offres)
URL WMS	Adresse de votre serveur WMS (offre Dédiée uniquement)
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

Connexion WFS (toutes offres)

Étape 3 : Configurer la connexion WFS

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 WFS

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 WFS

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 WFS 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 WFS

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

---

Connexion WMS (offre Dédiée uniquement)

Offre Dédiée requise

L'accès WMS est disponible uniquement avec l'offre QGIS Server Dédiée. Si vous avez l'offre Mutualisée, seul le WFS est disponible.

Le WMS (Web Map Service) fournit des tuiles cartographiques pré-rendues avec les styles CartograFit appliqués côté serveur. Avantages :

• Affichage instantané : pas de calcul de style côté client
• Styles professionnels : symbologie CartograFit optimisée
• Performances : idéal pour les grandes couvertures géographiques
• Fond de carte : parfait comme couche de contexte

Configurer la connexion WMS

1. Menu Couche → Gestionnaire des sources de données (ou Ctrl+L)
2. Sélectionnez WMS / WMTS dans le panneau de gauche
3. Cliquez sur Nouveau
4. Remplissez les informations :

Champ	Valeur
Nom	CartograFit WMS
URL	L'URL WMS fournie sur la page Accès QGIS

5. Configurez l'authentification de la même manière que pour le WFS (HTTP Header avec Authorization: Bearer VOTRE_TOKEN)
6. Cliquez sur OK

Ajouter des couches WMS

1. Sélectionnez la connexion CartograFit WMS
2. Cliquez sur Connecter
3. Les couches stylées s'affichent
4. Sélectionnez les couches souhaitées et cliquez sur Ajouter

Couches WMS disponibles

Couche	Description
parking_areas	Places de stationnement avec symbologie par type
h3_cells	Cellules H3 avec dégradé de densité
roads	Routes colorées selon la densité de stationnement
urban_furniture	Mobilier urbain avec icônes
road_markings	Marquages routiers stylés

WFS vs WMS : quelle couche utiliser ?

Critère	WFS	WMS
Données	Vectorielles (attributs accessibles)	Raster (image)
Styles	À configurer localement	Pré-rendus côté serveur
Sélection d'entités	✓ Possible	✗ Non
Édition	Lecture seule	N/A
Performances	Variables selon le nombre d'entités	Excellentes
Export	Vers tous formats	Image uniquement

Combiner WFS et WMS

Utilisez le WMS comme fond de carte pour un affichage rapide et le WFS pour les analyses nécessitant l'accès aux attributs.

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 des méthodes d'accès

Critère	Fichiers (GeoPackage)	WFS	WMS
Accès	Téléchargement manuel	Temps réel	Temps réel
Mises à jour	Notification + re-téléchargement	Automatique	Automatique
Hors ligne	Oui	Non	Non
Performances	Optimal (local)	Variables	Excellentes
Styles	Intégrés	À configurer	Pré-rendus
Attributs	✓ Accessibles	✓ Accessibles	✗ Non
Offre	Base	Mutualisée/Dédiée	Dédiée uniquement

Quelle méthode choisir ?

• Fichiers : travail hors ligne, performances maximales, contrôle des versions
• WFS : données vectorielles toujours à jour, analyses et requêtes attributaires
• WMS : affichage rapide de grandes zones, fond de carte stylé, performances optimales

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