Ce repository documente le service de calcul de bassins versants mis en place dans le cadre du pôle INSIDE. Il a vocation à accueillir les documentations et aides à l'utilisation, les codes exemples de clients, et à fédérer les issues.
Le service offre la possibilité de calculer un bassin versant en tout point du territoire français et ce, selon différentes configurations préparées à l'avance : 1 configuration = 1 choix préalable de données d'entrées (MNT, réseau hydrographique ayant servi à brûler éventuellement le MNT...) et de paramétrage d'algorithmes aux différentes étapes du prétraitement ("brûlage", calcul de direction, lissage, accumulation...).
Il se compose principalement d'un service OGC:WPS, offrant les méthodes de description des capacités, de calcul et de récupération des bassins versants. Il est également complété par un lot de services annexes facilitant son utilisation (service OGC:WMS des données prétraitées, telles que les bassins versants élémentaires, le réseau hydrographique modélisé...).
Endpoint du service : http://reseau.eaufrance.fr/geotraitements/bassin-versant/services/wps/ows?
Les paragraphes suivants décrivent les différentes procédures mises en œuvre sur le calcul de bassins versants (ou BV dans la suite de la documentation). Ces traitements spatiaux sont confectionnées sur la base d'un MNT (Modèle Numérique de Terrain) et éventuellement de données de référence fournissant le réseau hydrographique connu, le tout prétraité ; chaque prétraitement, associé à un choix de données d'entrée (MNT, réseau hydrographique) et d'algorithmie (types d'algorithmes et paramètres aux différentes étapes de prétraitement) donne une configuration distincte, sur la base de laquelle des calculs de bassins versants peuvent être demandés au service ici décrit.
Les procédures s’appuient sur les qualités sémantiques et géométriques des données d'entrée.
La procédure sie:getconfiglist (Voir le DescribeProcess) retourne la liste des configurations utilisables ensuite comme paramètre d'entrée pour la plupart des traitements. A appeler avant toute autre chose, à moins que l'on se satisfasse de la configuration par défaut.
Aucun
Identifiant Définition result Liste des configurations disponibles
Procédure 2 : Calcul de BV à partir de points et téléchargement des résultats (Identifier=sie:pts2watershed)
La procédure sie:pts2watershed »_ (voir le DescribeProcess) lance le calcul d'un BV pour chaque point (exutoire) passé en entrée sur la base d'une configuration choisie (parmi celles renvoyées par la méthode sie:getconfiglist), et retourne les résultats dans le format demandé (voir le DescribeProcess pour connaître les formats supportés). Derrière cette méthode, le point envoyé en entrée est ramené (snappé) sur le réseau hydrographique modélisé, en suivant la plus forte pente jusqu'à retrouver un tronçon.
| Nom du paramètre | Nature | Définition |
|---|---|---|
| compute_points | Obligatoire | Géométries des points à partir desquels calculer les BV. Ces géométries peuvent être exprimées dans plusieurs formats (listes des formats supportés dans le DescribeProcess de la méthode), certains pouvant embarquer le système de référence (SRS), d'autres ne le pouvant pas |
| input_EPSG | Facultatif | Code EPSG à attribuer aux géométries envoyées via le paramètre compute_points. A utiliser quasi exclusivement lorsque les géométries fournies ne stipulent pas par ailleurs leur SRS. Dans cette version du service, tout autre SRS que le 2154 (Lambert93) sera refusé et lèvera une erreur |
| configuration_id | Obligatoire | Identifiant de la configuration à utiliser pour ce calcul (récupéré d'un appel préalable à sie:getconfiglist) |
| Identifiant | Définition |
|---|---|
| result | Résultats de calcul au format demandé |
| MimeType | Définition |
|---|---|
| application/wfs-collection-1.0 ou text/xml; subtype=wfs-collection/1.0 | Document XML - GML conforme au schéma WFS 1.0 |
| application/wfs-collection-1.1 ou text/xml; subtype=wfs-collection/1.1 | Document XML - GML conforme au schéma WFS 1.1 |
| application/json | Document GeoJSON |
| application/zip | Archive ZIP |
Procédure 3 : Calcul de BV à partir de points et récupération du WMS associé (Identifier=sie:pts2watershedtoken_and_wms)
La procédure sie:pts2watershedtoken_and_wms (Voir le DescribeProcess) lance le calcul d'un BV pour chaque point (exutoire) passé en entrée sur la base d'une configuration choisie (parmi celles renvoyées par la méthode sie:getconfiglist), mais ne retourne pas les résultats directement dans le flux de réponse. Retourne un jeton correspondant à ce calcul (pour réexploitation future) ainsi que les paramètres d'appel (URL et LayerName) d'un service WMS affichant ces résultats. Derrière cette méthode, le point envoyé en entrée est ramené (snappé) sur le réseau hydrographique modélisé, en suivant la plus forte pente jusqu'à retrouver un tronçon.
| Nom du paramètre | Nature | Définition |
|---|---|---|
| compute_points | Obligatoire | Géométries des points à partir desquels calculer les BV. Ces géométries peuvent être exprimées dans plusieurs formats (listes des formats supportés dans le DescribeProcess de la méthode), certains pouvant embarquer le système de référence (SRS), d'autres ne le pouvant pas |
| input_EPSG | Facultatif | Code EPSG à attribuer aux géométries envoyées via le paramètre compute_point. A utiliser quasi exclusivement lorsque les géométries fournies ne stipulent pas par ailleurs leur SRS. Dans cette version du service, tout autre SRS que le 2154 (Lambert93) sera refusé et lèvera une erreur |
| configuration_id | Obligatoire | Identifiant de la configuration à utiliser pour ce calcul (récupéré d'un appel préalable à sie:getconfiglist) |
| Identifiant | Définition |
|---|---|
| token | Identifiant du calcul / de la requête, à utiliser ensuite comme jeton pour appeler d'autres services par la suite (export...) |
| wms_url | URL du serveur WMS/WFS à appeler par la suite pour afficher ou récupérer une représentation des BV calculés |
| wms_layer | Nom de la couche du serveur WMS/WFS à appeler par la suite pour afficher ou récupérer une représentation des BV calculés |
A partir de ces 3 éléments, il est possible de composer par exemple une URL complète pour afficher les BV en question comme suit :
<wms_url>?SERVICE=WMS&VERSION=1.1.1&REQUEST=GetMap&LAYERS=<wms_layer>&TOKEN=<id>&...
| MimeType | Définition |
|---|---|
| application/wfs-collection-1.0 ou text/xml; subtype=wfs-collection/1.0 | Document XML - GML conforme au schéma WFS 1.0 |
| application/wfs-collection-1.1 ou text/xml; subtype=wfs-collection/1.1 | Document XML - GML conforme au schéma WFS 1.1 |
| application/json | Document GeoJSON |
| application/zip | Archive ZIP |
La procédure sie:token2watershed (Voir le DescribeProcess) permet de télécharger le résultat (ensemble de BV) d'une requête formulée précédemment en lui fournissant le jeton (obtenu lors de la requête initiale), et le format d'export choisi parmi ceux supportés (décrits dans le DescribeProcess).
| Nom du paramètre | Nature | Définition |
|---|---|---|
| token | Obligatoire | Identifiant d'un calcul / d'une requête exécutée précédemment, et dont on veut exporter les résultats |
| Identifiant | Définition |
|---|---|
| result | Résultats de la requête en question, au format demandé |
| MimeType | Définition |
|---|---|
| application/wfs-collection-1.0 ou text/xml; subtype=wfs-collection/1.0 | Document XML - GML conforme au schéma WFS 1.0 |
| application/wfs-collection-1.1 ou text/xml; subtype=wfs-collection/1.1 | Document XML - GML conforme au schéma WFS 1.1 |
| application/json | Document GeoJSON |
| application/zip | Archive ZIP |
Ce service (OGC:WMS) permet d'afficher les données prétraitées servant de bases au calcul de bassins versants. Il est donc dépendant de la configuration (d'où le recours à un WMS paramétré).
Cette couche permet d'afficher, pour une configuration donnée, le réseau hydrographique modélisé (flux d'accumulation), obtenu par prétraitement principalement du MNT pris en entrée.
- URL de base : http://mapsref.brgm.fr/wxs/rhf/simulation?
- Nom de la couche : reseau
- Paramètre configuration : CONFIG_ID (non standard OGC:WMS)
- Exemple d'appel GetMap : http://mapsref.brgm.fr/wxs/rhf/simulation?LAYERS=reseau&TRANSPARENT=true&VERSION=1.1.1&FORMAT=png&SERVICE=WMS&REQUEST=GetMap&STYLES=&EXCEPTIONS=application%2Fvnd.ogc.se_inimage&SRS=EPSG%3A2154&CONFIG_ID=19&BBOX=615081.48646148,6753484.2160684,616536.694009,6754674.8404254&WIDTH=550&HEIGHT=450
Cette couche permet d'afficher, pour une configuration donnée, l'ensemble des bassins versants élémentaires précalculés.
- URL de base : http://mapsref.brgm.fr/wxs/rhf/bvelementaires?
- Nom de la couche : bv_elementaires
- Paramètre configuration : CONFIG_ID (non standard OGC:WMS)
- Exemple d'appel GetMap : http://mapsref.brgm.fr/wxs/rhf/bvelementaires?LAYERS=bv_elementaires&TRANSPARENT=true&VERSION=1.1.1&FORMAT=png&SERVICE=WMS&REQUEST=GetMap&STYLES=&EXCEPTIONS=application%2Fvnd.ogc.se_inimage&SRS=EPSG%3A2154&BBOX=613421.22694136,6752064.7272513,617059.24581016,6755041.2881439&WIDTH=550&HEIGHT=450