Intégrer ses données dans la carte Sta²re

Cette procédure s'adresse aux partenaires du projet Sta²re qui déposent leurs indicateurs sur la carte (page Dépôt d'indicateurs). Elle indique quelles données peuvent être déposées, comment les préparer, comment les déposer, et ce qui se passe ensuite.

1. Avant de commencer

• Clé de partenaire : chaque organisme reçoit de l'OR2S une clé secrète (au moins 16 caractères). Elle identifie l'organisme : ne pas la diffuser. La page de dépôt la garde seulement le temps de l'onglet.
• Droits sur les données : ne déposer que des données que l'organisme peut diffuser publiquement (licence ouverte, ou accord du producteur). Indiquer la source et la licence dans les métadonnées.
• Outils : un navigateur récent suffit pour déposer. QGIS (gratuit) est utile pour préparer les fichiers et enregistrer un style.
• Territoire : la carte couvre le territoire transfrontalier franco-belge (Hauts-de-France, Grand Est, Wallonie). Découper les données européennes ou nationales à ce territoire avant le dépôt.

2. Quelles données déposer ?

La carte dessine des surfaces colorées par classes. Quatre sortes de données s'y prêtent :

Non pris en charge pour l'instant : les points (stations de mesure, sites Seveso, antennes, captages), les lignes (cours d'eau, routes), les services web (WFS, API), les géodatabases ESRI (.gdb), les fichiers Parquet et les tuiles vectorielles. Voir 3.6 pour s'en rapprocher.

3. Préparer ses fichiers

3.1 Règles communes

• Système de coordonnées déclaré dans le fichier (.prj du shapefile, système du GeoPackage ou du GeoTIFF). Systèmes reconnus : Lambert 93 (EPSG:2154), Lambert belge 72 (EPSG:31370), Lambert belge 2008 (EPSG:3812), LAEA Europe (EPSG:3035), UTM 31 N (EPSG:25831, 32631), WGS 84 (EPSG:4326), ETRS89 et RGF93 géographiques (EPSG:4258, 4171). Un fichier sans système, ou dans un autre système, peut être déposé : la page demande alors de choisir le système (reprojeter d'abord dans QGIS si le système n'est pas dans la liste).
• Taille : 300 Mo au plus par fichier déposé (2 Go une fois l'archive décompressée, 5 000 fichiers au plus). Les archives .zip imbriquées ne sont pas ouvertes.
• Noms de fichiers : sans importance pour l'affichage (le libellé est saisi au dépôt), mais explicites pour l'OR2S (ex. no2_moyenne_annuelle_2024.tif).
• Notice : joindre la notice du producteur en PDF et, si possible, un raccourci Internet (.url) vers la fiche de métadonnées, dans le même dossier de l'archive que la couche : ils seront proposés dans la fiche de l'indicateur.
• Plusieurs couches : une archive .zip peut réunir plusieurs couches, de formats différents ; chacune est vérifiée et importée séparément.

3.2 Cartes de zones : shapefile, GeoPackage, GeoJSON

• Shapefile : compresser dans un .zip les fichiers .shp, .shx, .dbf (obligatoires), .prj (système de coordonnées) et .cpg (encodage des textes : sans lui, les accents peuvent être mal lus).
• GeoPackage (.gpkg, déposé seul ou dans un .zip) : chaque table de polygones devient une couche. Les tables de points ou de lignes sont signalées comme non importables. Les noms de colonnes de plus de 10 caractères sont raccourcis (le nom d'origine reste affiché).
• GeoJSON (.geojson ou .json, 200 Mo au plus) : une FeatureCollection en longitude / latitude WGS 84 (norme RFC 7946). Les entités qui ne sont pas des polygones sont ignorées.
• La colonne de classement porte la classe (texte, ex. « Fort / Moyen / Faible ») ou une valeur numérique (classée au dépôt, voir 4.3). Sans style ni classement automatique, une colonne ne doit pas avoir plus de 50 valeurs distinctes.
• Couches très détaillées (plus de 200 000 polygones, ex. carroyage à 10 m) : indiquer au dépôt une maille de généralisation (ex. 100 m). Chaque maille prend alors la classe la plus élevée qu'elle contient.

3.3 Rasters (GeoTIFF)

• Une seule bande ; géoréférencement dans le GeoTIFF ou dans un fichier .tfw (raster non tourné).
• Déclarer la valeur « sans donnée » (QGIS : Propriétés › Transparence, ou à l'export « Valeur sans donnée ») : sinon les pixels hors territoire sont dessinés.
• Raster de classes (entiers, 256 valeurs au plus) : chaque valeur est une classe ; fournir de préférence un style QGIS « Palette / valeurs uniques » pour les libellés et les couleurs.
• Raster continu (réels, ou plus de 256 valeurs) : il est classé par intervalles, avec le classement automatique de la page de dépôt, ou avec un style QGIS « Pseudo-couleur à bande unique » en interpolation Discrète.
• Découper le raster au territoire (QGIS : Raster › Extraction › Découper un raster selon une emprise) et éviter les résolutions inutilement fines : au-delà de 150 millions de pixels, une maille est demandée au dépôt (chaque maille prend la moyenne de ses pixels). Pour un raster de classes trop grand, le rééchantillonner avant le dépôt.

3.4 Tableaux de valeurs par unité territoriale

Un tableau est dessiné sur les polygones d'un référentiel installé par l'OR2S (communes, secteurs statistiques, IRIS, EPCI…). La liste à jour des référentiels et la forme de leurs codes sont affichées sur la page de dépôt (« Référentiels disponibles pour les tableaux »). Si le découpage voulu manque, le demander à l'OR2S.

Référentiels installés à la rédaction de cette procédure (géographies de l'OR2S) :

Les codes doivent suivre le découpage de l'année du référentiel : une commune créée ou fusionnée depuis n'est pas reconnue (elle est signalée à l'aperçu). Les codes « commune inconnue » (59999, 99999…) ne sont pas dessinés. Secteurs statistiques et quartiers belges : pas encore de référentiel, le demander à l'OR2S.

• Format : CSV (séparateur « ; », « , » ou tabulation, détecté automatiquement ; UTF-8 de préférence) ou Excel .xlsx (première feuille du classeur). Un fichier .txt délimité est lu comme un CSV.
• Une ligne d'en-tête (noms des colonnes), puis une ligne par unité. Dans un classeur Excel, les lignes de titre au-dessus du tableau sont ignorées ; supprimer en revanche les lignes de total, de notes ou de sources sous le tableau.
• Une colonne de codes : code INSEE de la commune, code NIS (Statbel), code de secteur statistique, code IRIS, SIREN de l'EPCI… Les zéros de tête perdus par un tableur (2001 au lieu de 02001) sont tolérés.
• Une colonne de valeurs par indicateur : nombres en notation française ou anglaise (« 12,5 », « 12.5 », « 1 234,5 », « 12,5 % »). Les cellules vides, « s », « nd », « - », « secret »… sont considérées comme sans valeur (l'unité n'est pas dessinée). Pour cartographier plusieurs colonnes d'un même tableau, déposer le fichier une fois par colonne.
• France et Belgique : les codes français et belges se recouvrent (INSEE 62xxx, NIS 62xxx) ; déposer un tableau par pays, ou précéder chaque code du pays (FR02001, BE57081) pour le référentiel franco-belge.
• Ne pas mettre de données personnelles ni de valeurs soumises au secret statistique : la carte est publique.

Exemple de tableau CSV prêt à déposer :

Code commune;Commune;Densité de population;Part des 65 ans et plus (%)
02001;Abbécourt;84,2;21,5
02002;Achery;56,0;19,8
02003;Acy;s;23,1

3.5 Style QGIS (facultatif)

Pour garder ses propres classes, libellés et couleurs, joindre dans l'archive un style QGIS (.qml) portant de préférence le nom de la couche : dans QGIS, Propriétés de la couche › Symbologie › Style › Enregistrer le style… (format QML). Rendus reconnus : catégorisé, gradué et symbole unique (vecteur) ; palette et pseudo-couleur (raster). Les styles ArcGIS (.lyr) et SLD ne sont pas lus : les ouvrir dans QGIS et les enregistrer en .qml. Sans style, la page propose un classement automatique (valeurs numériques) ou une couleur par valeur.

3.6 Données non prises en charge : comment s'en rapprocher

4. Déposer pas à pas

4.1 Identification et envoi

1. Ouvrir la page Dépôt d'indicateurs (lien « Déposer des indicateurs » de la carte) et saisir la clé de partenaire.
2. Choisir le fichier puis « Déposer et vérifier ». Le serveur décompresse l'archive, convertit les GeoPackage et GeoJSON, et vérifie chaque couche ; une barre indique l'avancement de l'envoi.

4.2 Vérification des couches

Chaque couche trouvée est présentée sur une fiche :

• Valide : rien à signaler ; À vérifier : avertissements à lire (la couche reste importable) ; Non importable : erreurs à corriger dans le fichier, puis le déposer de nouveau.
• Les colonnes (valeurs distinctes, exemples, nombres) et la projection reconnue sont rappelées.

4.3 Réglages

Colonne de classement (cartes de zones)

Colonne portant la classe ou la valeur à cartographier ; « aucune » dessine toute la couche d'une seule couleur.

Unités territoriales, colonne des codes, colonne des valeurs (tableaux)

Le référentiel et la colonne des codes sont proposés d'après la part de codes reconnus (affichée sous la liste). Choisir la colonne des valeurs à cartographier.

Couleurs et classes

• Style QGIS : un .qml joint au dépôt (voir 3.5) ;
• Classement automatique (valeurs numériques) : méthode quantiles (autant d'unités par classe, conseillée pour comparer), intervalles égaux (classes de même amplitude) ou seuils naturels (regroupe les valeurs proches) ; de 2 à 9 classes ; palette de couleurs. Les bornes sont arrondies. Le style produit est gardé avec la couche et pourra être retouché par l'OR2S ;
• Une couleur par valeur : pour une colonne de quelques catégories (50 au plus).

Maille

Cartes de zones très détaillées : généralisation sur une grille (classe la plus élevée par maille). Rasters continus : moyenne des pixels par maille. Exemple : 100 m.

Système de coordonnées

Demandé seulement si le fichier n'en déclare pas de reconnu.

4.4 Aperçu

« Aperçu sur la carte » dessine la couche avec les réglages choisis. Vérifier la position (une couche décalée ou hors du territoire signale un mauvais système de coordonnées), les classes, et pour un tableau le nombre d'unités dessinées et les codes non reconnus. Cliquer sur une zone affiche sa classe, ou pour un tableau le nom de l'unité et sa valeur. Une grande couche peut demander une ou deux minutes de conversion.

4.5 Métadonnées et import

• Obligatoires : libellé dans l'arbre (titre de l'indicateur) et source(s) : producteur, millésime, licence (ex. « Statbel, population au 1er janvier 2025, licence ouverte »).
• Conseillées : définition (ce que mesure l'indicateur, méthode), unité (ex. « hab./km² », « µg/m³ », « % » : elle s'affiche à côté des valeurs), grand thème et sous-thème.
• Cocher les couches à importer, ajouter un commentaire pour l'OR2S si besoin, puis « Importer les couches cochées ».

5. Après l'import

• Les indicateurs apparaissent sur la carte dans la rubrique « Non validés », sous le nom de l'organisme, avec la mention « non validé » dans la fiche et la légende. Une grande couche peut mettre quelques minutes à s'afficher (conversion sur le serveur).
• L'OR2S valide ensuite l'indicateur : il le range dans l'arborescence thématique de la carte, ou revient vers l'organisme pour une correction.
• Corriger un indicateur importé : déposer de nouveau le fichier corrigé et prévenir l'OR2S pour qu'il retire l'ancienne version (le dépôt ne remplace jamais un indicateur existant).
• Un dépôt vérifié mais non importé est effacé du serveur au bout de 24 heures.

6. Messages fréquents

Annexe A – La base de données Sta²re : quel format pour quelle donnée

Correspondance entre les données recensées dans la base Sta²re (STA²RE_Base de données_V1) et la façon de les déposer. Les données déjà intégrées par l'OR2S sont indiquées.

Annexe B – Automatiser le dépôt (API)

La page de dépôt s'appuie sur une API utilisable directement, par exemple pour publier chaque année une nouvelle version d'un indicateur. Chaque requête porte la clé dans l'en-tête X-Stare-Cle. Remplacer https://<site> par l'adresse de la carte.

# 1. Vérifier la clé ; liste des référentiels, méthodes de classement et palettes
curl -H "X-Stare-Cle: VOTRE_CLE" https://<site>/api/depots/partenaire

# 2. Déposer un fichier (corps brut) : la réponse décrit le dépôt (id) et ses couches (c1, c2…)
curl -H "X-Stare-Cle: VOTRE_CLE" -H "Content-Type: application/octet-stream" \
     --data-binary @densite.csv "https://<site>/api/depots?nom=densite.csv"

# 3. Aperçu (facultatif) : 202 tant que la conversion n'est pas finie, redemander
curl -H "X-Stare-Cle: VOTRE_CLE" -H "Content-Type: application/json" \
     -d '{"couche":"c1","referentiel":"Communes_BE","colonneCode":"Code NIS","colonne":"Densité",
          "methode":"quantiles","nombreClasses":5,"palette":"YlOrRd"}' \
     https://<site>/api/depots/ID_DU_DEPOT/apercu

# 4. Import
curl -H "X-Stare-Cle: VOTRE_CLE" -H "Content-Type: application/json" \
     -d '{"couches":[{"couche":"c1","referentiel":"Communes_BE","colonneCode":"Code NIS","colonne":"Densité",
          "methode":"quantiles","nombreClasses":5,"palette":"YlOrRd",
          "libelle":"Densité de population","sources":"Statbel, 2025","unite":"hab./km²"}],
          "commentaire":"Mise à jour annuelle"}' \
     https://<site>/api/depots/ID_DU_DEPOT/import

Réglages d'une couche (corps de l'aperçu et de chaque élément de couches à l'import) :

Autres routes : GET /api/depots/ID (analyse d'un dépôt en cours), DELETE /api/depots/ID (abandon), GET /api/depots/referentiels (référentiels). En cas d'erreur, la réponse 400 contient la liste erreurs ; 401 : clé absente ou invalide ; 404 : dépôt inconnu ou expiré.