Retrieves a ObsDataset resource.GET
Retrieves a ObsDataset resource.
Documentation détaillée de cet endpoint (paramètres, exemples)
URLs
Paramètres
| Nom | Dans | Type | Requis | Description |
|---|---|---|---|---|
obsDataset | path | string | oui | ObsDataset identifier |
Exemple — parametre dans un dataset
Information sur le parametre donné
{
"meta": {
"dataset": "qualite_eaux_surf_support_eau",
"processing": "parameters",
"idTerritoire": "1",
"count": 1
},
"data": [
{
"idParametre": 1340,
"parametre": "Nitrates",
"unite": "mg(NO3)/L",
"lbunite": "milligramme de nitrate par litre",
"natparametre": "2",
"typeparametre": "2",
"lbcourtparametre": "NO3-",
"cdunite": "173",
"forceConvToTargetUnitForEauxSurfSupportEau": true
}
]
}Exemple — respect-objectif — données agrégées (JSON)
Agrégats de conformité par station (nbTotal, percentageCompliant…) avec les valeurs mesurées (aggValuesList) et la classe de style calculée.
{
"meta": {
"dataset": "qualite_eaux_surf_support_eau",
"processing": "respect-objectif",
"idTerritoire": "1",
"count": 202
},
"data": [
{
"year": 2025,
"nbTotal": 6,
"nbCompliant": 6,
"aggValuesList": [
{
"dateDonnee": "2025-03-05 08:30:00+01",
"valeur": 11.5
},
{
"dateDonnee": "2025-05-21 08:52:00+02",
"valeur": 14.1
},
{
"dateDonnee": "2025-07-09 08:30:00+02",
"valeur": 14.7
},
{
"dateDonnee": "2025-08-01 08:00:00+02",
"valeur": 13.4
},
{
"dateDonnee": "2025-09-17 08:25:00+02",
"valeur": 14.9
},
{
"dateDonnee": "2025-12-17 08:30:00+01",
"valeur": 14.3
}
],
"idObjetgeo": "04137695",
"objetgeo": "SEVRE NANTAISE à VERNOUX-EN-GATINE",
"idParametre": "1340",
"parametre": "Nitrates",
"unite": "mg(NO3)/L",
"objectiveCompliancyFunction": "specialNitrates",
"idConfObjectif": "6190",
"seuilObjectif": 25,
"nbNotCompliant": 0,
"percentageCompliant": 100,
"percentageNotCompliant": 0,
"overallCompliancy": "yes",
"percentageAverageWrtObjective": 55.27,
"couleurPubli": "vert1",
"classe": {
"debug": {
"type": "getStdClassePourcentageRespectObjectif4c",
"colorCode": "green"
},
"radius": 8,
"weight": 1,
"opacity": 0.9,
"color": "#000000",
"fillColor": "#B3CC00",
"fillOpacity": 0.45,
"strokeWidth": 1.5,
"classe": "V",
"libel": "Respect (moins de 10% de dépa
… (réponse tronquée)Exemple — datas — données brutes horodatées
Valeurs brutes par station (idObjetgeo, valeur, dateDonnee) — la matière première de vos graphiques et tableaux.
{
"meta": {
"dataset": "qualite_eaux_surf_support_eau",
"processing": "datas",
"idTerritoire": "1",
"count": 423
},
"data": [
{
"idObjetgeo": "04137695",
"idParametre": "1340",
"valeur": 11.5,
"dateDonnee": "2025-03-05 08:30:00+01"
},
{
"idObjetgeo": "04137695",
"idParametre": "1340",
"valeur": 14.1,
"dateDonnee": "2025-05-21 08:52:00+02"
},
{
"idObjetgeo": "04137695",
"idParametre": "1340",
"valeur": 14.7,
"dateDonnee": "2025-07-09 08:30:00+02"
},
{
"idObjetgeo": "04137695",
"idParametre": "1340",
"valeur": 13.4,
"dateDonnee": "2025-08-01 08:00:00+02"
},
{
"idObjetgeo": "04137695",
"idParametre": "1340",
"valeur": 14.9,
"dateDonnee": "2025-09-17 08:25:00+02"
},
{
"idObjetgeo": "04137695",
"idParametre": "1340",
"valeur": 14.3,
"dateDonnee": "2025-12-17 08:30:00+01"
},
{
"idObjetgeo": "04137900",
"idParametre": "1340",
"valeur": 13.7,
"dateDonnee": "2025-03-12 13:45:00+01"
},
{
… (réponse tronquée)Exemple — datas-stats — statistiques descriptives
Statistiques par station ; le retour de cet appel peut évoluer. il de suit pas le formaliser data[].
{
"meta": {
"dataset": "qualite_eaux_surf_support_eau",
"processing": "datas-stats",
"idTerritoire": "1",
"count": 0
},
"data": [],
"globals": {
"all": {
"count": 423,
"sum": 6301.59,
"mean": 14.897375886524824,
"median": 13,
"min": 0.1,
"max": 80,
"quartile1": 4.5,
"quartile2": 13,
"quartile3": 21,
"quantile001": 0.31,
"quantile005": 0.5,
"quantile010": 1.2,
"quantile090": 30,
"quantile095": 36,
"quantile099": 59,
"variance": 159.42066143554135,
"standardDeviation": 12.626189505767025,
"firstDate": "2025-01-13T13:37:00+01:00",
"lastDate": "2025-12-23T10:38:00+01:00",
"yearCumulativeSum": 6301.59,
"yearCumulativeCount": 423,
"yearCumulativeMean": 14.897375886524824,
"yearCumulativeMin": 0.1,
"yearCumulativeMax": 80
},
"metadata": {
"searchStartDate": "2025-01-01T00:00:00+00:00",
"searchEndDate": "2025-12-
… (réponse tronquée)Exemple — presence-de-donnees-brutes — disponibilité des mesures
Liste les stations ayant des données brutes sur la période (53 stations en 2025 pour les nitrates) — utile pour les compteurs et cartes de disponibilité.
{
"meta": {
"dataset": "qualite_eaux_surf_support_eau",
"processing": "presence-de-donnees-brutes",
"idTerritoire": "1",
"count": 53
},
"data": [
{
"idObjetgeo": "04137695",
"idParametre": "1340",
"objetgeo": "SEVRE NANTAISE à VERNOUX-EN-GATINE",
"parametre": "Nitrates",
"unite": "mg(NO3)/L",
"isRawData": 1,
"classe": {
"debug": {
"type": "getStdClasseDefaultProcessingLegend",
"colorCode": "D"
},
"radius": 8,
"weight": 1,
"opacity": 0.9,
"color": "#000000",
"fillColor": "#9F9F9F",
"fillOpacity": 0.9,
"strokeWidth": 1.5,
"classe": "D",
"libel": "Station ayant des données",
"comment": "",
"debugIndicateur": {
"indicateur": "IsRawData",
"note": 1
}
}
},
{
"idObjetgeo": "04137900",
"idParametre": "1340",
"objetgeo": "SEVRE NANTAISE à SAINT-JOUIN-DE-MILLY",
"parametre": "Nitrates",
"unite": "mg(NO3)/L",
"isRawData": 1,
"classe": {
… (réponse tronquée)Exemple — classes — classification des valeurs d'une station
Classes de qualité calculées pour une station, avec la configuration du dataset et la source des données (with_data_source_obs_extract_json).
{
"meta": {
"dataset": "qualite_eaux_surf_support_eau",
"processing": "classes",
"idTerritoire": "1",
"count": 57
},
"ObsDataset": {
"obsDataset": "qualite_eaux_surf_support_eau",
"confTableData": {
"confTableData": "qualite_eaux_surf_support_eau",
"dataTablePath": "r030_qualite_eaux_surf.v_qt_eaux_support_eau_with_obs_extract_and_cumul",
"geoObjectIdFieldNameIntoDataTable": "id_objetgeo",
"parameterIdFieldNameIntoDataTable": "id_parametre",
"valueFieldNameIntoDataTable": "valeur",
"dateFieldNameIntoDataTable": "date_donnee",
"metadata": "{\"title\": \"Qualité des eaux superficielles (support eau brute)\", \"history\": {\"lastUpdate\": \"2026-09-10\"}, \"sources\": [{\"producers\": [{\"producer_url\": \"\", \"producer_logo\": \"\", \"producer_name\": \"AE\"}], \"source_url\": \"https://hubeau.eaufrance.fr/page/api-qualite-cours-deau\", \"source_logo\": \"/images/icones/hubeau1.png\", \"source_name\": \"hubeau, Qualité des cours d'eau\"}], \"descripteur\": \"AR\", \"description\": \"osur pc paramètre seulement sur le support eau brute\"}",
"createdAt": "2025-06-26T22:20:22+00:00",
"updatedAt": "2023-09-07T16:29:30+00:00"
},
"confTableParameter": {
"confTableParameter": "qualite_eaux_sur
… (réponse tronquée)Exemple — respect-multi-objectifs — plusieurs objectifs en une requête
Conformité évaluée contre plusieurs objectifs cumulés (ici paramètre 9900020, objectif 9957) sur une station — une ligne par résultat.
{
"meta": {
"dataset": "qualite_eaux_surf_support_eau",
"processing": "respect-multi-objectifs",
"idTerritoire": "1",
"count": 1
},
"data": {
"2025": {
"04145000": {
"5347": {
"nbTotal": 4,
"nbCompliant": 4,
"aggValuesList": [
{
"dateDonnee": "2025-12-23 11:22:00+01",
"valeur": 0.001
},
{
"dateDonnee": "2025-09-16 11:25:00+02",
"valeur": 0.005
},
{
"dateDonnee": "2025-05-14 13:37:00+02",
"valeur": 0.001
},
{
"dateDonnee": "2025-03-11 10:59:00+01",
"valeur": 0.0016
}
],
"idObjetgeo": "04145000",
"objetgeo": "MAINE à CHATEAU-THEBAUD",
"idParametre": "5347",
"parametre": "Acide perfluoro-octanoïque (PFOA / formes linéaires et ramifiées)",
"unite": "µg/L",
"objectiveCompliancyFunction": "100Pourcent
… (réponse tronquée)Exemple — indicateur — valeur et style pré-calculés (EDL/Sdage)
Indicateurs prêts à l'affichage : la classe et son style Leaflet sont fournis. S'applique aux datasets à indicateurs (état des masses d'eau Sdage).
{
"meta": {
"dataset": "sdage_2028_edl_2025_esu",
"processing": "indicateur",
"idTerritoire": "50",
"count": 13
},
"data": [
{
"idObjetgeo": "FRGR0539B",
"idParametre": "e_pc_acid",
"valeur": "2",
"dateDonnee": "2025-07-01",
"categorieMe": "Cours d'eau",
"objetgeo": "L'ERDRE DEPUIS LE PLAN D'EAU DE L'ERDRE JUSQU'A L'ESTUAIRE DE LA LOIRE",
"parametre": "Etat Acidification ",
"unite": "",
"classe": {
"debug": {
"type": "getStdClasseMauvais2TresBon",
"colorCode": "green"
},
"radius": 8,
"weight": 1,
"opacity": 0.9,
"color": "#000000",
"fillColor": "#66E680",
"fillOpacity": 0.7200000000000001,
"strokeWidth": 1.5,
"classe": "V",
"libel": "Bon",
"comment": "",
"numericAttribution": 2,
"shape": "square",
"debugIndicateur": {
"indicateur": "classeEDL6Classes",
"note": "2"
}
}
},
{
"idObjetgeo": "FRGR0542",
"idParametre": "e_pc_acid",
"v
… (réponse tronquée)Exemple — Layer — GeoJSON prêt pour Leaflet
Requête en format .geojson : chaque feature embarque sa géométrie (EPSG:4326), son style de rendu et la cible de popup.
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"style": {
"radius": 8,
"fillColor": "#9F9F9F",
"color": "#000000",
"strokeWidth": 1.5,
"weight": 1,
"opacity": 0.3,
"fillOpacity": 0.05
},
"properties": {
"year": 2025,
"idParametre": "1340",
"parametre": "Nitrates",
"nbTotal": 0,
"asHistoricalDatas": true,
"percentageAverageWrtObjective": -1,
"name": "SEVRE NANTAISE à VERNOUX-EN-GATINE",
"id": "04137700",
"debug": {
"niveau1": {
"type": "getStdClassePourcentageRespectObjectif4c",
"colorCode": "noData"
},
"niveau2": {
"indicateur": "specialNitrates"
}
},
"popupButtonOnClickTarget": "https://obs21.sevre-nantaise.com/stationSheet?processing=respect-objectif&dataset=qualite_eaux_surf_support_eau&id_territoire=1&ids_parametres=1340&ids_objectifs=6190&date_debut=2015-01-01&date_fin=2026-12-31&ids_objets_geo=04137700&parent_date_debut=2025-01-01&parent_date_fin=2025-12-31"
},
"geometry": {
"type": "Point",
"crs": {
"type": "name",
"properties": {
"name": "EPSG:4326"
}
},
"coordinates": [
-0.517176648,
46.634337184
]
}
},
{
"type": "Feature",
"style": {
"radius": 8,
"fillColor": "#9F9F9F",
"color": "#000000",
"strokeWidth": 1.5,
"weight": 1,
"opacity": 0.3,
"fillOpacity": 0.05
},
"properties": {
"year": 2025,
"idParametre": "1340",
"parametre": "Nitrates",
"nbTotal": 0,
"asHistoricalDatas": true,
"percentageAverageWrtObjective": -1,
"nam
… (réponse tronquée)Exemple — Layer — légende (for_legend)
output_options=for_legend ajoute les classes de légende calculées : couleurs, libellés, effectifs et icônes — sans recalcul côté front.
{
"meta": {
"dataset": "qualite_eaux_surf_support_eau",
"processing": "respect-objectif",
"idTerritoire": "1",
"count": 0
},
"classeType": "classeDeRespectObjectif",
"data": [],
"dataProcessingClasseType": "specialNitrates",
"effectifs": {
"totalAvecValeur": 53,
"total": 202
},
"name": "specialNitrates",
"shape": "circle",
"values": [
{
"debug": {
"type": "getStdClassePourcentageRespectObjectif4c",
"colorCode": "green"
},
"radius": 8,
"weight": 1,
"opacity": 0.9,
"color": "#000000",
"fillColor": "#B3CC00",
"fillOpacity": 0.9,
"strokeWidth": 1.5,
"classe": "V",
"libel": "Respect (moins de 10% de dépassements)",
"comment": "",
"debugIndicateur": {
"indicateur": "specialNitrates",
"note": 100
},
"effectif": 29,
"percentEffectif": 54.72
},
{
"debug": {
"type": "getStdClassePourcentageRespectObjectif4c",
"colorCode": "yellow"
},
"radius": 8,
"weight": 1,
"opacity": 0.9,
"color": "#000000",
"fillColor": "#FFB000",
"fillOpacity": 0.9,
"strokeWidth": 1.5,
"classe": "J",
"libel": "Non respect (de 10% à 40% de dépassements)",
"comment": "",
"debugIndicateur": {
"indicateur": "specialNitrates",
"note": 61
},
"effectif": 16,
"percentEffectif": 30.19
},
{
"debug": {
"type": "getStdClassePourcentageRespectObjectif4c",
"colorCode": "orange"
},
"radius": 8,
"weight": 1,
… (réponse tronquée)Exemple — Dataset — objets géo du territoire (WKT)
processing=geoms renvoie les objets géo du dataset sur le territoire sans données de mesure (géométries WKT encodées).
{
"meta": {
"dataset": "qualite_eaux_surf_support_eau",
"processing": "geoms",
"idTerritoire": "1",
"count": 202
},
"data": [
{
"idObjetgeo": "04143900",
"objetgeo": "ASSON à LA GUYONNIERE",
"geom": "01010000206A0800005C8FC2F5A7C81641A4703D5A6C695941"
},
{
"idObjetgeo": "04671003",
"objetgeo": "BENET à TORFOU",
"geom": "01010000206A08000066666666D6DD174100000000406E5941"
},
{
"idObjetgeo": "04144500",
"objetgeo": "BLAISON À REMOUILLE",
"geom": "01010000206A08000000000000BE7D164100000000666D5941"
},
{
"idObjetgeo": "M720520",
"objetgeo": "COMPLEXE DE MOULIN RIBOU à LA TESSOUALLE",
"geom": "01010000206A0800009A99999933E71841000000005C6D5941"
},
{
"idObjetgeo": "04140100",
"objetgeo": "CRUME à TIFFAUGES",
"geom": "01010000206A08000033333333A3A41741000000800E6C5941"
},
{
… (réponse tronquée)Exemple — Dataset — objets géo du territoire (GeoJSON)
Requête en .geojson avec with_geometry_geojson : FeatureCollection de points prête pour le fond de carte.
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"idObjetgeo": "04143900",
"objetgeo": "ASSON à LA GUYONNIERE"
},
"geometry": {
"type": "Point",
"crs": {
"type": "name",
"properties": {
"name": "EPSG:4326"
}
},
"coordinates": [
-1.299645403,
46.974118594
]
}
},
{
"type": "Feature",
"properties": {
"idObjetgeo": "04671003",
"objetgeo": "BENET à TORFOU"
},
"geometry": {
"type": "Point",
"crs": {
"type": "name",
"properties": {
"name": "EPSG:4326"
… (réponse tronquée)Exemple — Graphique — séries multi-années d'une station (respect-objectif)
Restreinte à une station (ids_objets_geo) sur 2 ans : une ligne par année avec la série aggValuesList (date/valeur) et les agrégats de conformité.
{
"meta": {
"dataset": "qualite_eaux_surf_support_eau",
"processing": "respect-objectif",
"idTerritoire": "1",
"count": 2
},
"data": [
{
"year": 2024,
"nbTotal": 11,
"nbCompliant": 9,
"aggValuesList": [
{
"dateDonnee": "2024-06-20 13:23:00+02",
"valeur": 7.6
},
{
"dateDonnee": "2024-12-19 13:05:00+01",
"valeur": 28
},
{
"dateDonnee": "2024-01-22 14:00:00+01",
"valeur": 25
},
{
"dateDonnee": "2024-03-28 09:45:00+01",
"valeur": 20
},
{
"dateDonnee": "2024-04-19 12:19:00+02",
"valeur": 18
},
{
"dateDonnee": "2024-05-29 14:15:00+02",
"valeur": 18
},
{
"dateDonnee": "2024-07-25 14:13:00+02",
"valeur": 4.7
},
{
"dateDonnee": "2024-08-22 15:10:00+02",
"valeur": 1.2
},
{
"dateDonnee": "2024-09-16 12:26:00+02",
"valeur": 2.5
},
{
"dateDonnee": "2024-10-18 14:09:00+02",
"valeur": 27
},
{
"dateDonnee": "2024-11-18 09:36:00+01",
"valeur": 22
}
],
"idObjetgeo": "04145000",
"objetgeo": "MAINE à CHATEAU-THEBAUD",
"idParametre": "1340",
"parametre": "Nitrates",
"unite": "mg(NO3)/L",
"objectiveCompliancyFunction": "specialNitrates",
"idConfObjectif": "6190",
"seuilObjectif": 25,
"nbNotCompliant": 2,
"percentageCompliant": 81.82,
"percentageNotCompliant": 18.180000000000007,
"overallCompliancy": "no",
"percentageAverageWrtObjective": 63.27,
"couleurPubli": "jaune",
"classe": {
"debug": {
"type": "getStdClassePourcentageRespectObjectif4c",
"colorCode": "yellow"
},
"radius": 8,
"weight": 1,
"o
… (réponse tronquée)Exemple — Respect d\objectif filtrée sur un EPCI (id_filtre_territoire)
Requete avec le filtre EPCI 200067635 : le count passe de 202 à 15 — seules les stations de l'EPCI sont retournées.
{
"meta": {
"dataset": "qualite_eaux_surf_support_eau",
"processing": "respect-objectif",
"idTerritoire": "1",
"count": 15
},
"data": [
{
"year": 2025,
"nbTotal": 5,
"nbCompliant": 5,
"aggValuesList": [
{
"dateDonnee": "2025-02-13 10:19:00+01",
"valeur": 21
},
{
"dateDonnee": "2025-04-08 10:01:00+02",
"valeur": 15
},
{
"dateDonnee": "2025-06-18 11:43:00+02",
"valeur": 8.1
},
{
"dateDonnee": "2025-08-21 11:44:00+02",
"valeur": 1.6
},
{
"dateDonnee": "2025-10-16 10:56:00+02",
"valeur": 1.9
}
],
"idObjetgeo": "04143200",
"objetgeo": "SEVRE NANTAISE à MONNIERES",
"idParametre": "1340",
"parametre": "Nitrates",
"unite": "mg(NO3)/L",
"objectiveCompliancyFunction": "specialNitrates",
"idConfObjectif": "6190",
"seuilObjectif": 25,
"nbNotCompliant": 0,
"percentageCompliant": 100,
"percentageNotCompliant": 0,
"overallCompliancy": "yes",
"percentageAverageWrtObjective": 38.08,
"couleurPubli": "vert1",
"classe": {
"debug": {
"type": "getStdClassePourcentageRespectObjectif4c",
"colorCode": "green"
},
"radius": 8,
"weight": 1,
"opacity": 0.9,
"color": "#000000",
"fillColor": "#B3CC00",
"fillOpacity": 0.45,
"strokeWidth": 1.5,
"classe": "V",
"libel": "Respect (moins de 10% de dépassements)",
"comment": "",
"debugIndicateur": {
"indicateur": "specialNitrates",
"note": 100
}
}
},
{
"year": 2025,
"nbTotal": 5,
"nbCompliant": 5,
"aggValuesList": [
{
"dateDonnee": "2025-02-13 09:55:00+01",
"valeur": 20
… (réponse tronquée)