Ce service permet de télécharger des données Hydroweb au format ASCII, JSON or CSV.
Il est nécessaire de télécharger une première fois les données manuellement (voir section 7.1) afin de signer l'acceptation des termes de la licence.
L'URL du service d'accès sécurisé aux données est le suivant:
https://hydroweb.theia-land.fr/hydroweb/authdownload
Il faut ajouter à cet URL un point d'interrogation « ? » suivi d'une ou plusieurs options présentées ci-après.
L'une des 2 options suivantes est obligatoire:
products: indique les produits dont on souhaite télécharger les données.
La requête retourne soit un fichier de données unique (si un seul produit est demandé), soit un fichier ZIP contenant
l'ensemble des données correspondant aux produits demandés (1 fichier par produit).
On pourra indiquer:
la liste des références de produit (séparés par des virgules).
lakes, lakes_operational ou lakes_research: télécharger les données de tous les lacs, lacs opérationnels ou de type recherche
rivers, rivers_operational ou rivers_research: télécharger les données de toutes les stations virtuelles, SV opérationnelles ou de type recherche
list: donne la liste des produits disponibles au téléchargement au format CSV. On pourra indiquer:
all: liste complète
lakes, lakes_operational ou lakes_research: liste uniquement les lacs, les lacs opérationnels ou de type recherche
rivers, rivers_operational ou rivers_research: liste uniquement les stations virtuelles, les SV opérationnelles ou de type recherche
Si l’option list est indiquée dans la requête, le service authdownload est accessible sans authentification préalable.
Par contre, le téléchargement de données (via l’option products) ne pourra fonctionner qu'après s'être authentifié sur le site Hydroweb en cliquant sur le bouton "Se connecter" OU bien en saisissant ses identifiant/mot de passe directement dans l'URL comme suit:
https://hydroweb.theia-land.fr/hydroweb/authdownload?products=[...]&user=[...]&pwd=[...]
Autrement, un message d’erreur HTTP 500 s’affichera.
L'utilisateur doit avoir également signé la licence Theia qui est proposée lors d'une première inscription ou d'un premier téléchargement depuis le site web.
Les options suivantes sont facultatives:
sdate = date de début (au format YYYY-MM-DD)
edate = date de fin (au format YYYY-MM-DD)
user = login de l'utilisateur (adresse mail). A noter que cette option n'est pas indispensable si l'utilisateur s'est déjà authentifié sur le site web. Dans ce cas, le service authdownload est capable de retrouver la session active de la personne réalisant la requête.
pwd = mot de passe de l'utilisateur
format = format des fichiers de données: txt (format ASCII, c'est le format classique utilisé dans Hydroweb) ou csv ou json, txt par défaut.
validation = critère de validation: expert, automatic ou insitu
updated = date de dernière mise à jour (au format YYYY-MM-DD)
Exemples:
Obtenir la liste des données fleuves de type recherche disponibles:
https://hydroweb.theia-land.fr/hydroweb/authdownload?list=rivers_research
Télécharger la SV R_GARONNE_GARONNE_KM0001 au format CSV en utilisant ses identifiants Theia (XXX/YYY)
https://hydroweb.theia-land.fr/hydroweb/authdownload?products=R_GARONNE_GARONNE_KM0001&format=CSV&user=XXX&pwd=YYY
Télécharger (toujours en étant authentifié) tous les données lacs opérationnels au format JSON de l’année 2015
https://hydroweb.theia-land.fr/hydroweb/authdownload?products=lakes_operational&format=json&sdate=2015-01-01&edate=2015-12-31&user=xxx&pwd=xxx