Publier un indicateur¶

Vous avez produit un indicateur : une carte de végétation, une classification LCZ, une série de températures de surface. Cette section explique comment le rendre visible aux collectivités : comment il entre dans le catalogue STAC, comment il est servi en WMS / WFS et comment il s'affiche dans le géoportail UrbiVerde.

La façon de publier dépend du tier de votre service. Le tier dit ce que votre indicateur apporte à l'utilisateur final, et donc sous quelle forme il lui parvient.

Tier	Ce que livre le service	Diffusion principale	Guide
Tier 1 - Observation	Une observation de l'état du territoire : végétation, températures, LCZ, qualité de l'air, pollution lumineuse, population, réseaux…	Géoportail (map product). Une application en complément si besoin.	Publier un service Tier 1
Tier 2 - Ecosystem services	Des indicateurs construits sur les observations Tier 1 : réduction de la pollution, rafraîchissement urbain, biodiversité…	Géoportail pour les couches d'indicateurs, application pour l'analyse et la comparaison de scénarios	à venir
Tier 3 - Climate impact	Des projections à horizon futur : climat local 2050, rafraîchissement projeté…	Application interactive : choix de l'horizon et du scénario, simulation, comparaison	à venir

La plateforme offre deux façons de diffuser un indicateur, et elles se combinent :

le géoportail, par le service de publication de la plateforme. Vous préparez vos données, et la plateforme produit la carte, les services WMS / WFS et l'entrée dans le catalogue. C'est la voie naturelle d'un produit, une carte que l'on consulte ;
votre propre application interactive, hébergée par AntFlow Spaces. pour une diffusion interactive et personnalisée.

Plus le tier monte, plus la diffusion glisse de la première vers la seconde. Une observation Tier 1 se lit sur une carte. Une projection Tier 3 se manipule : l'élu choisit un horizon et un scénario climatique, teste un verdissement, compare les résultats. Une carte figée ne rend pas cela, et un service Tier 3 se livre donc d'abord comme une application. Il peut publier en plus quelques couches de référence au catalogue, par exemple la projection 2050 du scénario médian, pour qu'elles restent découvrables.

Commencez par le Tier 1

Les services Tier 2 et Tier 3 réutilisent les produits du Tier 1 (voir service chaining dans le SR). Un Tier 1 bien publié, avec un chemin S3 propre et un catalogue STAC cohérent, rend donc tout le reste plus simple.

Le catalogue STAC¶

Tout indicateur publié est référencé dans le catalogue STAC de la plateforme, https://stac.urbiverde.com, quelle que soit la façon dont vous le publiez. STAC (SpatioTemporal Asset Catalog) est le standard ouvert de description des données géospatiales : chaque fiche dit ce que représente la donnée, où et quand elle a été observée, qui l'a produite et où trouver ses fichiers.

Un catalogue ouvert, pour l'instant

Le catalogue est aujourd'hui ouvert : il se consulte et s'alimente sans authentification. Une version sécurisée est en cours de mise en place. Elle exigera un jeton OIDC délivré par le Keycloak de la plateforme (realm Urbiverde), à présenter dans l'en-tête Authorization: Bearer <jeton> de chaque requête.

À quoi il sert¶

Usage	Ce que le catalogue apporte
Le géoportail	Ses couches sont générées à partir du catalogue, à chaque consultation : une fiche publiée apparaît, une fiche retirée disparaît.
L'accès aux données	Le producteur et la ville d'une fiche déterminent qui la voit dans le géoportail.
La découverte	Recherche par ville, indicateur, date ou emprise, depuis n'importe quel client STAC : QGIS, STAC Browser, `pystac-client`…
La réutilisation	Les services Tier 2 et Tier 3, comme les applications, retrouvent les produits et leurs fichiers sans connaître leur rangement sur S3.

Comment il est organisé¶

Objet STAC	Représente	Exemple
Collection	un indicateur, sur une ville, livré par un producteur	`lcz-toulouse-cerema`
Item	une date de cet indicateur	`lcz-toulouse-cerema-2022`

Le géoportail range les Items en ville → indicateur → date, à partir des propriétés urbiverde:city et urbiverde:indicator, et de la période du STAC de base (datetime, ou start_datetime + end_datetime) : une année entière s'affiche 2022, un mois entier 2022-06, sinon le jour 2026-06-27.

Bonnes pratiques pour référencer un indicateur¶

Des noms issus du référentiel commun. Ville et indicateur s'écrivent en minuscules, sans accent, avec - comme séparateur, et de la même façon chez tous les producteurs : saint-denis et st-denis créent deux villes dans le géoportail.
Un nom de producteur stable. Le name du providers de rôle producer détermine l'accès aux données et entre dans les identifiants : gardez exactement la même graphie d'une publication à l'autre.
Des identifiants prévisibles : <indicateur>-<ville>-<producteur> pour la Collection, <collection>-<date> pour l'Item. Republier le même identifiant remplace la fiche au lieu de créer un doublon. Ne réutilisez jamais un identifiant pour une autre donnée.
Une date par Item, décrite par les champs STAC datetime, ou start_datetime + end_datetime. C'est la période observée, pas la date du traitement. Dans les identifiants, gardez un seul format (YYYY, YYYYMM ou YYYYMMDD) par indicateur.
Une emprise exacte (bbox, geometry, en WGS 84) : elle sert à la recherche spatiale et au cadrage de la carte.
Une description par Item (source, méthode, millésime) et une licence explicite sur la Collection.
Des extensions STAC standard plutôt que des champs maison, déclarées dans stac_extensions. Les champs urbiverde:* sont réservés à la plateforme.

La publication QGIS calcule ces champs pour vous, à partir du chemin S3 et du XML ISO. En publication cloud native, c'est vous qui les écrivez.

Interroger le catalogue¶

# Toutes les Collections
curl https://stac.urbiverde.com/collections

# Les items d'une Collection
curl https://stac.urbiverde.com/collections/lcz-toulouse-cerema/items

# Les Items d'une ville
curl -X POST https://stac.urbiverde.com/search \
  -H "Content-Type: application/json" \
  -d '{"filter-lang": "cql2-json", "filter": {"op": "=", "args": [{"property": "properties.urbiverde:city"}, "toulouse"]}}'

Tous les endpoints et leurs paramètres sont décrits dans la documentation interactive de l'API (Swagger) : https://stac.urbiverde.com/api.html.