# Spécifications WCS

Un service `WCS` permet de récupérer des données maillées brutes (non stylisées
contrairement au WMS). L’utilisation de ce service permet des analyses plus poussées
alors que le `WMS` sert principalement à récupérer des cartes mises en forme à des fins
d’affichage.

## Opérations

|Opération       |Description                                                                      |
|----------------|---------------------------------------------------------------------------------|
|GetCapabilities |Permet de récupérer l’ensemble des services WCS disponibles pour un serveur      |
|DescribeCoverage|Permet de récupérer une liste des couches rasters disponibles dans le service WCS|
|GetCoverage     |Permet de récupérer une couche selon des paramètres spécifiés par le client      |

### GetCapabilities (WCS)

#### Requêtes type :

La réponse est conçue pour vous fournir toutes les informations nécessaires sur la couverture, par exemple *NO2*, y compris ce qu'elle représente, où et quand elle s'applique, et comment elle peut être récupérée et utilisée.

**GetCapabilities WCS**
`https://namek.airparif.fr/geoserver/prev_horair/wcs?service=wcs&version=1.0.0&request=GetCapabilities&authkey={clé}`

- Description `<wcs:description>`:

Le texte "Generated from ImageMosaic" indique que les données ont été générées à partir d'un processus ou d'une structure appelée "ImageMosaic". Cela suggère que la couverture représente une mosaïque d'images, souvent utilisée pour combiner plusieurs sources de données géospatiales en une seule couche.

- Nom et Étiquette `<wcs:name>` et `<wcs:label>`:

Le nom de la couverture est "prev_horair", un identifiant unique pour ce jeu de données dans un contexte particulier (catalogue ou base de données).

L'étiquette s'appelle simplement *indice*, qui est un nom plus lisible ou abrégé du même jeu de données.

- Enveloppe de coordonnées géographiques `<wcs:lonLatEnvelope>`:

Le système de référence utilisé pour les coordonnées est spécifié par *"urn:ogc:def:crs:OGC:1.3
"*, qui correspond à un système de coordonnées géographiques basé sur les longitudes et latitudes, compatible avec WGS 84.

Les deux balises <gml:pos> spécifient les coins opposés d'un rectangle englobant qui délimite la couverture spatiale des données, exemple :
*Deuxième position* : longitude 3.5738172704429196, latitude 49.24313647618603.
*Première position* : longitude 1.4428659418791216, latitude 48.11390451554756.

- Plage temporelle `<gml:timePosition>`:

La couverture est également limitée par une période temporelle, allant du J+0 H+0 UTC jusqu'a J+2 H+48 UTC. Cela signifie que les données couvrent une plage de temps précise.

- Mots-clés `<wcs:keywords>`:

Les mots-clés associés à ces données sont "polluant", "WCS", et "ImageMosaic". Ces mots-clés sont utilisés pour faciliter la recherche et le classement de ces données dans un catalogue ou une base de données.

**DescribeCoverage (WCS)**

`https://namek.airparif.fr/geoserver/prev_horair/wcs?service=wcs&version=1.0.0&request=DescribeCoverage&coverage=prev_horair:NO2&authkey={clé}`

Le serveur retourne une réponse `XML` détaillée qui décrit les propriétés et les métadonnées de la couverture demandée, dans ce cas *`prev_horair:NO2`*. Voici ce qu'une réponse typique pourrait inclure et ce que chaque partie signifie:

- Coverage Offering `(<wcs:CoverageOffering>)`:

C'est l'élément principal qui encapsule tous les détails sur la couverture. Il décrit les propriétés de la couverture disponible via le service WCS.

- Description et nom `(<wcs:description>, <wcs:name>, <wcs:label>)`:

*Description* : Fournit une description textuelle de la couverture, expliquant ce qu'elle représente. Par exemple, elle pourrait indiquer "Niveaux de concentration de NO2 générés à partir des modèles atmosphériques."

*Nom* : C'est l'identifiant utilisé pour désigner cette couverture spécifique. Dans ce cas, c'est *prev_horair:NO2*, ce qui suggère que les données concernent les niveaux de NO2 (dioxyde d'azote) dans l'air, issues du jeu de données ou modèle "prev_horair".

*Label* : Il s'agit d'un nom plus convivial pour la couverture.

- Domaine temporel `<wcs:temporalDomain>, <gml:timePosition>`:

Si la couverture est dépendante du temps, cet élément définit l'étendue temporelle des données, y compris les dates et heures de début et de fin ou plusieurs instants temporels.

- Formats supportés `<wcs:supportedFormats>`:

Liste les formats de données dans lesquels la couverture peut être récupérée (par ex., GeoTIFF, NetCDF, etc.). Cela aide le client à comprendre comment les données peuvent être téléchargées ou traitées.

- Jeu de valeurs `<wcs:rangeSet>, <wcs:axisDescription>`:

Décrit l'étendue des valeurs couvertes par les données. Pour le NO2, cela pourrait inclure les niveaux de concentration dans une certaine unité (par ex., µg/m³).

- Systèmes de coordonnées supportés `<wcs:supportedCRSs>`:

Indique les systèmes de coordonnées supportés pour demander les données. Cela vous indique dans quel CRS les données peuvent être demandées, ce qui est crucial pour l'analyse spatiale.