1. Trouver tous les piézomètres existant à Mâcon :
Le code INSEE de la commune de Mâcon est 71270. L'URL à interroger est : http://hubeau.eaufrance.fr/api/v1/niveaux_nappes/stations?code_commune=71270&format=json&size=20&pretty
NB. L'attribut pretty permet d'avoir une réponse plus lisible avec des sauts de ligne et une indentation.
Résultat :
{
"count" : 2,
"first" : "https://hubeau.eaufrance.fr/api/v1/niveaux_nappes/stations?code_commune=71270&format=json&pretty&page=1&size=20",
"last" : null,
"prev" : null,
"next" : null,
"api_version" : "1.1.2",
"data" : [ {
"code_bss" : "06252X0063/PZ1",
"urn_bss" : "http://services.ades.eaufrance.fr/pointeau/06252X0063/PZ1",
"date_debut_mesure" : "2008-05-21",
"date_fin_mesure" : "2020-02-17",
"code_commune_insee" : "71270",
"nom_commune" : "Mâcon",
"x" : 4.84129654,
"y" : 46.370535409,
"codes_bdlisa" : [ "523AB00" ],
"urns_bdlisa" : [ "http://reseau.eaufrance.fr/geotraitements/bdlisa/files/entite/523AB00.pdf" ],
"geometry" : {
"type" : "Point",
"crs" : {
"type" : "name",
"properties" : {
"name" : "urn:ogc:def:crs:OGC:1.3:CRS84"
}
},
"coordinates" : [ 4.84129654001931, 46.3705354087062 ]
},
"bss_id" : "BSS001PYMM",
"altitude_station" : "214.0",
"nb_mesures_piezo" : 4258,
"code_departement" : "71",
"nom_departement" : "Saône-et-Loire",
"libelle_pe" : "forage BRGM (Sennece-Les-Macon-71)",
"profondeur_investigation" : 40.0,
"codes_masse_eau_edl" : [ "DG503" ],
"noms_masse_eau_edl" : [ "Domaine formations sédimentaires des Côtes chalonnaise, maconnaise et beaujolaise" ],
"urns_masse_eau_edl" : [ "http://www.sandre.eaufrance.fr/geo/MasseDEauSouterraine/DG503" ],
"date_maj" : "Fri Jan 24 16:44:49 CET 2020"
}, {
"code_bss" : "06252X0024/EAU",
"urn_bss" : "http://services.ades.eaufrance.fr/pointeau/06252X0024/EAU",
"date_debut_mesure" : "1996-10-31",
"date_fin_mesure" : "2005-11-14",
"code_commune_insee" : "71270",
"nom_commune" : "Mâcon",
"x" : 4.840539342,
"y" : 46.370471097,
"codes_bdlisa" : [ "523AB00" ],
"urns_bdlisa" : [ "http://reseau.eaufrance.fr/geotraitements/bdlisa/files/entite/523AB00.pdf" ],
"geometry" : {
"type" : "Point",
"crs" : {
"type" : "name",
"properties" : {
"name" : "urn:ogc:def:crs:OGC:1.3:CRS84"
}
},
"coordinates" : [ 4.8405393417401, 46.3704710966954 ]
},
"bss_id" : "BSS001PYKW",
"altitude_station" : "214.0",
"nb_mesures_piezo" : 1463,
"code_departement" : "71",
"nom_departement" : "Saône-et-Loire",
"libelle_pe" : "Forage - 71000 SENNECE LES MACON",
"profondeur_investigation" : 40.0,
"codes_masse_eau_edl" : null,
"noms_masse_eau_edl" : null,
"urns_masse_eau_edl" : [ ],
"date_maj" : "Fri Jan 24 16:44:49 CET 2020"
} ]
}
Il y a 2 piézomètres sur la commune de Mâcon, de codes 06252X0063/PZ1 et 06252X0024/EAU. L'un a des données depuis 2008,l'autre entre 1996 et 2005.
2. Récupérer la chronique piézométrique complète du piézomètre 06252X0063/PZ1 identifié à l'étape précédente :
L'URL à interroger est : http://hubeau.eaufrance.fr/api/v1/niveaux_nappes/chroniques?code_bss=06252X0063%2FPZ1&size=5000
Résultat :
{
"count" : 4272,
"first" : "http://hubeau.eaufrance.fr/api/v1/niveaux_nappes/chroniques?code_bss=06252X0063/PZ1&pretty&page=1&size=5000",
"last" : null,
"prev" : null,
"next" : null,
"api_version" : "1.1.2",
"data" : [ {
"code_bss" : "06252X0063/PZ1",
"urn_bss" : "http://services.ades.eaufrance.fr/pointeau/06252X0063/PZ1",
"date_mesure" : "2008-05-21",
"timestamp_mesure" : 1211328000000,
"niveau_nappe_eau" : 206.89,
"mode_obtention" : "Valeur mesurée",
"statut" : "Donnée contrôlée niveau 1",
"qualification" : "Correcte",
"code_continuite" : "2",
"nom_continuite" : "Point lié au point précédent",
"code_producteur" : "198",
"nom_producteur" : "Service Géologique Régional Bourgogne (198)",
"code_nature_mesure" : null,
"nom_nature_mesure" : null,
"profondeur_nappe" : 7.11
}, {
"code_bss" : "06252X0063/PZ1",
"urn_bss" : "http://services.ades.eaufrance.fr/pointeau/06252X0063/PZ1",
"date_mesure" : "2008-05-22",
"timestamp_mesure" : 1211414400000,
"niveau_nappe_eau" : 206.84,
"mode_obtention" : "Valeur mesurée",
"statut" : "Donnée contrôlée niveau 1",
"qualification" : "Correcte",
"code_continuite" : "2",
"nom_continuite" : "Point lié au point précédent",
"code_producteur" : "198",
"nom_producteur" : "Service Géologique Régional Bourgogne (198)",
"code_nature_mesure" : null,
"nom_nature_mesure" : null,
"profondeur_nappe" : 7.16
}, {
"code_bss" : "06252X0063/PZ1",
"urn_bss" : "http://services.ades.eaufrance.fr/pointeau/06252X0063/PZ1",
"date_mesure" : "2008-05-23",
"timestamp_mesure" : 1211500800000,
"niveau_nappe_eau" : 206.8,
"mode_obtention" : "Valeur mesurée",
"statut" : "Donnée contrôlée niveau 1",
"qualification" : "Correcte",
"code_continuite" : "2",
"nom_continuite" : "Point lié au point précédent",
"code_producteur" : "198",
"nom_producteur" : "Service Géologique Régional Bourgogne (198)",
"code_nature_mesure" : null,
"nom_nature_mesure" : null,
"profondeur_nappe" : 7.2
},
...
...
{
"code_bss" : "06252X0063/PZ1",
"urn_bss" : "http://services.ades.eaufrance.fr/pointeau/06252X0063/PZ1",
"date_mesure" : "2020-03-01",
"timestamp_mesure" : 1583035200000,
"niveau_nappe_eau" : 206.78,
"mode_obtention" : "Valeur mesurée",
"statut" : "Donnée contrôlée niveau 1",
"qualification" : "Correcte",
"code_continuite" : "2",
"nom_continuite" : "Point lié au point précédent",
"code_producteur" : "198",
"nom_producteur" : "Service Géologique Régional Bourgogne (198)",
"code_nature_mesure" : null,
"nom_nature_mesure" : null,
"profondeur_nappe" : 7.22
}, {
"code_bss" : "06252X0063/PZ1",
"urn_bss" : "http://services.ades.eaufrance.fr/pointeau/06252X0063/PZ1",
"date_mesure" : "2020-03-02",
"timestamp_mesure" : 1583107200000,
"niveau_nappe_eau" : 206.74,
"mode_obtention" : "Valeur mesurée",
"statut" : "Donnée contrôlée niveau 1",
"qualification" : "Correcte",
"code_continuite" : "2",
"nom_continuite" : "Point lié au point précédent",
"code_producteur" : "198",
"nom_producteur" : "Service Géologique Régional Bourgogne (198)",
"code_nature_mesure" : null,
"nom_nature_mesure" : null,
"profondeur_nappe" : 7.26
} ]
}
4272 mesures piézométriques sont disponibles sur le piézomètre 06252X0063/PZ1 à la date de l'interrogation. Les mesures piézométriques récupérées sont les niveaux maximum journaliers, comme dans la banque ADES.
3. Récupérer les dernières mesures disponibles sur le piézomètre 06252X0063/PZ1 en quasi temps-réel :
Pour récupérer les données horaires brutes en temps réel, il faut interroger l'opération chroniques_tr. On ajoute le paramètre sort=desc pour avoir les mesures les plus récentes d'abord; size=5 pour n'avoir que les 5 dernières mesures ainsi que pretty pour rendre les résultats plus lisibles. L'URL à interroger est : http://hubeau.eaufrance.fr/api/v1/niveaux_nappes/chroniques_tr?code_bss=06252X0063%2FPZ1&size=5&sort=desc&pretty
Résultat (interrogation le 05/02/2020 à 14h) :
{
"count" : 528,
"first" : "http://hubeau.eaufrance.fr/api/v1/niveaux_nappes/chroniques_tr?code_bss=06252X0063/PZ1&sort=desc&pretty&page=1&size=5",
"last" : "http://hubeau.eaufrance.fr/api/v1/niveaux_nappes/chroniques_tr?code_bss=06252X0063/PZ1&sort=desc&pretty&page=106&size=5",
"prev" : null,
"next" : "http://hubeau.eaufrance.fr/api/v1/niveaux_nappes/chroniques_tr?code_bss=06252X0063/PZ1&sort=desc&pretty&page=2&size=5",
"api_version" : "1.1.2",
"data" : [ {
"code_bss" : "06252X0063/PZ1",
"urn_bss" : "http://services.ades.eaufrance.fr/pointeau/06252X0063/PZ1",
"timestamp_mesure" : 1580889600000,
"niveau_eau_ngf" : 207.52,
"longitude" : 4.84129654001931,
"latitude" : 46.3705354087062,
"bss_id" : "BSS001PYMM",
"altitude_station" : null,
"altitude_repere" : 214.0,
"date_mesure" : "2020-02-05T08:00:00Z",
"profondeur_nappe" : 6.48,
"date_maj" : "2020-02-05"
}, {
"code_bss" : "06252X0063/PZ1",
"urn_bss" : "http://services.ades.eaufrance.fr/pointeau/06252X0063/PZ1",
"timestamp_mesure" : 1580886000000,
"niveau_eau_ngf" : 207.52,
"longitude" : 4.84129654001931,
"latitude" : 46.3705354087062,
"bss_id" : "BSS001PYMM",
"altitude_station" : null,
"altitude_repere" : 214.0,
"date_mesure" : "2020-02-05T07:00:00Z",
"profondeur_nappe" : 6.48,
"date_maj" : "2020-02-05"
}, {
"code_bss" : "06252X0063/PZ1",
"urn_bss" : "http://services.ades.eaufrance.fr/pointeau/06252X0063/PZ1",
"timestamp_mesure" : 1580882400000,
"niveau_eau_ngf" : 207.52,
"longitude" : 4.84129654001931,
"latitude" : 46.3705354087062,
"bss_id" : "BSS001PYMM",
"altitude_station" : null,
"altitude_repere" : 214.0,
"date_mesure" : "2020-02-05T06:00:00Z",
"profondeur_nappe" : 6.48,
"date_maj" : "2020-02-05"
}, {
"code_bss" : "06252X0063/PZ1",
"urn_bss" : "http://services.ades.eaufrance.fr/pointeau/06252X0063/PZ1",
"timestamp_mesure" : 1580878800000,
"niveau_eau_ngf" : 207.52,
"longitude" : 4.84129654001931,
"latitude" : 46.3705354087062,
"bss_id" : "BSS001PYMM",
"altitude_station" : null,
"altitude_repere" : 214.0,
"date_mesure" : "2020-02-05T05:00:00Z",
"profondeur_nappe" : 6.48,
"date_maj" : "2020-02-05"
}, {
"code_bss" : "06252X0063/PZ1",
"urn_bss" : "http://services.ades.eaufrance.fr/pointeau/06252X0063/PZ1",
"timestamp_mesure" : 1580875200000,
"niveau_eau_ngf" : 207.52,
"longitude" : 4.84129654001931,
"latitude" : 46.3705354087062,
"bss_id" : "BSS001PYMM",
"altitude_station" : null,
"altitude_repere" : 214.0,
"date_mesure" : "2020-02-05T04:00:00Z",
"profondeur_nappe" : 6.48,
"date_maj" : "2020-02-05"
} ]
}
528 mesures piézométriques brutes horaires étaient disponibles sur le piézomètre 06252X0063/PZ1 au 05/02/2020 14h. La mesure la plus récente disponible date du même jour à 8h du matin. Les informations disponibles sont :
- code_bss et bss_id : code national du piézomètre (respectivement ancien et nouveau code)
- urn_bss : lien vers la fiche point d'eau ADES du piézomètre
- longitude et latitude : coordonnées du piézomètre, en degrés décimaux
- altitude_station et alitude_repere : cote NGF, en mètres, respectivement du sol au droit du piézomètre et du repère de mesures
- date_mesure : date et heure de la mesure piézométrique
- timestamp_mesure : un nombre entier correspondant au nombre de millisecondes écoulées entre le 1er janvier 1970 à minuit UTC et le moment de la mesure (peut être négatif si la date est antérieure au 01/01/1970)
- profondeur_nappe : profondeur du niveau d'eau, en mètres par rapport au repère de mesures
- niveau_eau_ngf : côte NGF du niveau d'eau, en mètres. niveau_eau_ngf = altitude_repere - profondeur_nappe
- date_maj : date de mise à jour des données
NB. tous les piézomètres ne disposent pas de données brutes horaires.
