Hub'Eau

https://hubeau.eaufrance.fr/
Admin
Hub'Eau is a water data API platform providing simplified REST access to water resource databases in...
Tokens:347,717
Snippets:1,074
Trust Score:9.8
Update:6 months ago
Show doc for...
Tokens:
Raw
### Example API Request for Stations

Source: https://hubeau.eaufrance.fr/page/api-qualite-cours-deau

This example demonstrates how to retrieve a list of physico-chemical sampling stations in specific communes. It includes pagination parameters 'size' and 'pretty' for formatted output.

```http
https://hubeau.eaufrance.fr/api/v2/qualite_rivieres/station_pc?code_commune=17300,17299&size=3&pretty
```

--------------------------------

### Piezometer Station Data Example

Source: https://hubeau.eaufrance.fr/page/api-piezometrie

This is an example JSON response when querying for piezometer stations in a commune. It includes details such as station codes, measurement dates, coordinates, and associated water body information.

```JSON
{
  "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"
  } ]
}
```

--------------------------------

### Piezometric Chronology Data Example

Source: https://hubeau.eaufrance.fr/page/api-piezometrie

An example of the JSON response for piezometric chronology data. It includes measurements with dates, timestamps, water levels, and information about the measurement source and quality.

```JSON
{
  "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",

```

--------------------------------

### GET /v2/qualite_rivieres/analyse_pc

Source: https://hubeau.eaufrance.fr/page/api-qualite-cours-deau

Retrieves a list of physico-chemical analyses.

```APIDOC
## GET /v2/qualite_rivieres/analyse_pc

### Description
Lister les analyses physicochimique.

### Method
GET

### Endpoint
/v2/qualite_rivieres/analyse_pc
```

--------------------------------

### GET /stations

Source: https://hubeau.eaufrance.fr/api/v1/niveaux_nappes/api-docs

Retrieves a list of piezometric measurement stations.

```APIDOC
## GET /stations

### Description
Retrieves a list of piezometric measurement stations.

### Method
GET

### Endpoint
/stations

### Response
#### Success Response (200)
- **data** (array) - The results of the query as a list of Station de mesures piézométriques objects.

#### Response Example
{
  "data": [
    {
      "code_bss": "BSS000XXXX",
      "urn_bss": "urn:brgm:bss:BSS000XXXX",
      "nom_commune": "Example City",
      "x": 2.35,
      "y": 48.85
    }
  ]
}
```

--------------------------------

### GET /v2/qualite_rivieres/station_pc

Source: https://hubeau.eaufrance.fr/page/api-qualite-cours-deau

Retrieves a list of physico-chemical measurement stations.

```APIDOC
## GET /v2/qualite_rivieres/station_pc

### Description
Lister les stations de mesures physicochimique.

### Method
GET

### Endpoint
/v2/qualite_rivieres/station_pc
```

--------------------------------

### GET /stations-pc

Source: https://hubeau.eaufrance.fr/api/v2/qualite_rivieres/api-docs

Retrieves information about physico-chemical measurement stations.

```APIDOC
## GET /stations-pc

### Description
Retrieves detailed information about a physico-chemical measurement station, including its hydrographic context, basin details, and geographical location.

### Method
GET

### Response
#### Success Response (200)
- **nom_cours_eau** (string) - Libellé long Sandre de l'entité hydrographique associée à la station de mesure.
- **uri_cours_eau** (string) - URI du cours d'eau
- **nom_masse_deau** (string) - Libellé de la masse d'eau de rattachement de la station de mesure
- **code_masse_deau** (string) - Code national de la masse d'eau associé à la station de mesure
- **code_eu_masse_deau** (string) - Code européen de la masse d'eau associé à la station de mesure
- **uri_masse_deau** (string) - URI national de la masse d'eau de la station de mesure
- **code_eu_sous_bassin** (string) - Code européen du sous-bassin DCE administratif
- **nom_sous_bassin** (string) - Libellé du sous bassin DCE administratif
- **uri_sous_bassin** (string) - URI du sous-bassin DCE
- **code_bassin** (string) - Code national du bassin DCE
- **code_eu_bassin** (string) - Code européen du bassin DCE
- **nom_bassin** (string) - Libellé du bassin DCE
- **uri_bassin** (string) - URI du bassin DCE
- **type_entite_hydro** (string) - Code Sandre de la nature d'entité hydrographique associée à la station de mesure.
- **commentaire** (string) - Commentaire sur la station de mesure
- **date_creation** (string) - Date de création de la station de mesure
- **date_arret** (string) - Date d'arrêt d'activité de la station de mesure
- **date_maj_information** (string) - Date de mise à jour des informations sur la station de mesure
- **finalite** (string) - Code Sandre de la finalité de la station de mesure.
- **localisation_precise** (string) - Localisation précise de la station de mesure
- **nature** (string) - Code Sandre de la nature de la station de mesure.
- **altitude_point_caracteristique** (number) - Altitude du point caractéristique de la station de mesure
- **point_kilometrique** (number) - Pk du point caractéristique sur le tronçon de l'entité hydrographique principale
- **premier_mois_annee_etiage** (integer) - Premier mois de l'année d'étiage de la station de mesure
- **superficie_bassin_versant_reel** (number) - Superficie réelle du bassin versant réel
- **superficie_bassin_versant_topo** (number) - Superficie topographique du bassin versant topographique
- **geometry** (object) - Géométrie de la station dans le système de coordonnées WGS84
```

--------------------------------

### GET /v1/niveaux_nappes/chroniques_tr

Source: https://hubeau.eaufrance.fr/page/api-piezometrie

Retrieves real-time groundwater level chronicles for piezometers.

```APIDOC
## GET /v1/niveaux_nappes/chroniques_tr

### Description
Lister les chroniques piézométriques en temps réél.

### Method
GET

### Endpoint
/v1/niveaux_nappes/chroniques_tr

### Response
#### Success Response (200)
- **code_bss** (string) - Ancien code national du piézomètre
- **bss_id** (string) - Nouveau code national du piézomètre
- **urn_bss** (string) - Lien vers la fiche point d'eau ADES
- **longitude** (number) - Coordonnée longitude en degrés décimaux
- **latitude** (number) - Coordonnée latitude en degrés décimaux
- **altitude_station** (number) - Cote NGF du sol au droit du piézomètre
- **altitude_repere** (number) - Cote NGF du repère de mesures
- **date_mesure** (string) - Date et heure de la mesure
- **timestamp_mesure** (integer) - Millisecondes depuis le 01/01/1970
- **profondeur_nappe** (number) - Profondeur du niveau d'eau par rapport au repère
- **niveau_eau_ngf** (number) - Côte NGF du niveau d'eau
- **date_maj** (string) - Date de mise à jour des données

#### Response Example
{
  "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"
}
```

--------------------------------

### GET /stations

Source: https://hubeau.eaufrance.fr/api/v2/qualite_rivieres/api-docs

Retrieves information about water quality monitoring stations.

```APIDOC
## GET /stations

### Description
Retrieves a list of water quality monitoring stations based on provided criteria.

### Method
GET

### Endpoint
/stations

### Parameters
#### Query Parameters
- **code_station** (array) - Optional - Sandre code of the measurement station.

### Response
#### Success Response (200)
- **StationPc** (object) - Returns the station details.

#### Success Response (206)
- **StationPc** (object) - Returns partial results.

### Error Handling
- 400: Requête incorrecte
- 401: Unauthorized
- 403: Forbidden
- 404: Not Found
- 500: Erreur interne du serveur
```

--------------------------------

### GET /v2/qualite_rivieres/condition_environnementale_pc

Source: https://hubeau.eaufrance.fr/api/v2/qualite_rivieres/api-docs

Retrieves environmental physico-chemical conditions for analyses on rivers and lakes in France and DROM.

```APIDOC
## GET /v2/qualite_rivieres/condition_environnementale_pc

### Description
This service allows searching for physico-chemical environmental conditions of analyses on rivers and lakes. Pagination is based on the number of analyses.

### Method
GET

### Endpoint
/v2/qualite_rivieres/condition_environnementale_pc

### Parameters
#### Query Parameters
- **bbox** (array) - Optional - Bounding box in format: min longitude, min latitude, max longitude, max latitude (WGS84).
- **code_banque_reference** (array) - Optional - Reference bank code(s).
- **code_commune** (array) - Optional - INSEE code(s) of the municipality.
- **code_cours_eau** (array) - Optional - Watercourse code(s).
- **code_departement** (array) - Optional - Department code(s).
- **code_eu_masse_eau** (array) - Optional - European water body code(s).
- **code_groupe_parametres** (array) - Optional - Sandre code(s) for parameter groups.
- **code_masse_eau** (array) - Optional - National water body code(s).
- **code_operation_cep** (string) - Optional - Operation code.
- **page** (integer) - Optional - Page number.
- **size** (integer) - Optional - Maximum number of results per page (default: 1000, max: 20000).
- **sort** (string) - Optional - Sort order (asc or desc) on sampling date.
- **type_entite_hydro** (array) - Optional - Sandre code(s) for hydrographic entity nature.

### Response
#### Success Response (200)
- **AnalysePc** (object) - Returns the list of physico-chemical conditions.

#### Success Response (206)
- **AnalysePc** (object) - Partial content, more results available.
```

--------------------------------

### GET /referentiels/v1/nsa/{id}

Source: https://hubeau.eaufrance.fr/api/v2/qualite_rivieres/api-docs

Retrieve detailed information about a specific physico-chemical measurement station by its ID.

```APIDOC
## GET /referentiels/v1/nsa/{id}

### Description
Retrieves detailed information about a specific physico-chemical measurement station.

### Method
GET

### Endpoint
/referentiels/v1/nsa/{id}

### Parameters
#### Path Parameters
- **id** (integer) - Required - The unique identifier of the measurement station.

### Response
#### Success Response (200)
- **@id** (string) - The unique identifier of the station.
- **@type** (string) - The type of the station.
- **code_commune_insee** (string) - INSEE code of the commune where the station is located.
- **libelle_commune** (string) - Name of the commune.
- **code_departement** (string) - Department code.
- **libelle_departement** (string) - Name of the department.
- **code_region** (string) - Region code.
- **libelle_region** (string) - Name of the region.
- **code_cours_eau** (string) - Code of the watercourse.
- **libelle_cours_eau** (string) - Name of the watercourse.
- **code_troncon** (string) - Code of the river segment.
- **libelle_troncon** (string) - Name of the river segment.
- **code_entite_hydrographique** (string) - Code of the hydrographic entity.
- **libelle_entite_hydrographique** (string) - Name of the hydrographic entity.
- **code_bassin_versant** (string) - Code of the watershed.
- **libelle_bassin_versant** (string) - Name of the watershed.
- **code_zone_hydrographique** (string) - Code of the hydrographic zone.
- **libelle_zone_hydrographique** (string) - Name of the hydrographic zone.
- **code_entite_administrative** (string) - Code of the administrative entity.
- **libelle_entite_administrative** (string) - Name of the administrative entity.
- **code_pays** (string) - Country code.
- **libelle_pays** (string) - Name of the country.
- **latitude** (number) - Latitude of the station.
- **longitude** (number) - Longitude of the station.
- **precision** (string) - Precision of the location.
- **commentaire** (string) - Comment about the measurement station.
- **date_creation** (string) - Date of creation of the measurement station.
- **date_arret** (string) - Date of cessation of activity of the measurement station.
- **date_maj_information** (string) - Date of update of information on the measurement station.
- **finalite** (string) - Sandre code for the purpose of the measurement station. List available at https://api.sandre.eaufrance.fr/referentiels/v1/nsa/645.json
- **localisation_precise** (string) - Precise location of the measurement station.
- **nature** (string) - Sandre code for the nature of the measurement station. List available at https://api.sandre.eaufrance.fr/referentiels/v1/nsa/62.json
- **altitude_point_caracteristique** (number) - Altitude of the characteristic point of the measurement station.
- **point_kilometrique** (number) - Kilometric point of the characteristic point on the segment of the main hydrographic entity associated with the measurement station.
- **premier_mois_annee_etiage** (integer) - First month of the low flow year for the measurement station.
- **superficie_bassin_versant_reel** (number) - Actual area of the watershed.
- **superficie_bassin_versant_topo** (number) - Topographic area of the watershed.

#### Response Example
{
  "@id": "/referentiels/v1/nsa/796",
  "@type": "StationPc",
  "code_commune_insee": "75101",
  "libelle_commune": "Paris 1er Arrondissement",
  "code_departement": "75",
  "libelle_departement": "PARIS",
  "code_region": "11",
  "libelle_region": "ÎLE-DE-FRANCE",
  "code_cours_eau": null,
  "libelle_cours_eau": null,
  "code_troncon": null,
  "libelle_troncon": null,
  "code_entite_hydrographique": null,
  "libelle_entite_hydrographique": null,
  "code_bassin_versant": null,
  "libelle_bassin_versant": null,
  "code_zone_hydrographique": null,
  "libelle_zone_hydrographique": null,
  "code_entite_administrative": "11",
  "libelle_entite_administrative": "ÎLE-DE-FRANCE",
  "code_pays": "FR",
  "libelle_pays": "France",
  "latitude": 48.8566,
  "longitude": 2.3522,
  "precision": "100m",
  "commentaire": "Station de mesures physicochimique",
  "date_creation": "2016-12-01T00:00:00Z",
  "date_arret": null,
  "date_maj_information": "2016-12-01T00:00:00Z",
  "finalite": "1",
  "localisation_precise": "Centre de Paris",
  "nature": "1",
  "altitude_point_caracteristique": 35.0,
  "point_kilometrique": null,
  "premier_mois_annee_etiage": null,
  "superficie_bassin_versant_reel": null,
  "superficie_bassin_versant_topo": null
}
```

--------------------------------

### GET /api/v1/echantillons

Source: https://hubeau.eaufrance.fr/api/v2/qualite_rivieres/api-docs

Retrieve water sample data with various filtering and pagination options.

```APIDOC
## GET /api/v1/echantillons

### Description
Retrieve water sample data with various filtering and pagination options.

### Method
GET

### Endpoint
/api/v1/echantillons

### Parameters
#### Query Parameters
- **code_commune** (array[string]) - Optional - Code(s) INSEE de la commune, si plusieurs codes, séparer les codes par une virgule, le nombre maximum de codes est 200.
- **code_departement** (array[string]) - Optional - Code(s) du département, si plusieurs codes, séparer les codes par une virgule, le nombre maximum de codes est 200.
- **code_epci** (array[string]) - Optional - Code(s) EPCI, si plusieurs codes, séparer les codes par une virgule, le nombre maximum de codes est 200.
- **code_pays** (array[string]) - Optional - Code(s) du pays, si plusieurs codes, séparer les codes par une virgule, le nombre maximum de codes est 200.
- **code_region** (array[string]) - Optional - Code(s) de la région, si plusieurs codes, séparer les codes par une virgule, le nombre maximum de codes est 200.
- **code_station** (array[string]) - Optional - Code(s) Sandre de la station de mesure, si plusieurs codes, séparer les codes par une virgule, le nombre maximum de codes est 200.
- **code_zone_hydrographique** (array[string]) - Optional - Code(s) Sandre de la zone hydrographique, si plusieurs codes, séparer les codes par une virgule, le nombre maximum de codes est 200.
- **date_debut** (string) - Optional - Date de début de la période de recherche (format YYYY-MM-DD).
- **date_fin** (string) - Optional - Date de fin de la période de recherche (format YYYY-MM-DD).
- **distance** (number) - Optional - Rayon de recherche en kilomètres autour du point géographique spécifié par les coordonnées longitude et latitude.
- **libelle_analyse** (array[string]) - Optional - Libellé(s) de l'analyse effectuée, si plusieurs libellés, séparer les libellés par une virgule, le nombre maximum de libellés est 200.
- **libelle_masse_eau** (array[string]) - Optional - Libellé(s) de la masse d'eau associée à la station de mesure, si plusieurs libellés, séparer les libellés par une virgule, le nombre maximum de libellés est 200.
- **libelle_parametre** (array[string]) - Optional - Libellé(s) long du paramètre de l'analyse, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de code est 200.
- **libelle_qualification** (array[string]) - Optional - Libellé(s) Sandre de la qualification de l'acquisition du résultat de l'analyse physicochimique et microbiologique, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de noms est 200.
- **libelle_region** (array[string]) - Optional - Libellé(s) long de la région, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de code est 200.
- **libelle_reseau** (array[string]) - Optional - Libellé Sandre du dispositif de collecte pour lequel l'analyse est réalisée.
- **libelle_station** (array[string]) - Optional - Libellé(s) Sandre de la station de mesure, si plusieurs libellés, séparer les libellés par une virgule, le nombre maximum de libellés est 200.
- **libelle_support** (array[string]) - Optional - Libellé(s) du support, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de code est 200.
- **longitude** (number) - Optional - Longitude du point en WGS84 pour la recherche par rayon, le point doit être utilisé comme séparateur décimal, exemple : 1.937.
- **mnemo_statut** (array[string]) - Optional - Mnémonique(s) du statut du résultat de l'analyse, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de noms est 200.
- **nom_bassin_dce** (array[string]) - Optional - Libellé(s) long du bassin, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de code est 200.
- **nom_cours_eau** (array[string]) - Optional - Libellé(s) long du cours d'eau, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de code est 200.
- **nom_groupe_parametres** (array[string]) - Optional - Libellé(s) long(s) Sandre du groupe de paramètres associé au paramètre analysé, si plusieurs libellés, séparer les libellés par une virgule, le nombre maximum de libellés est 200.
- **nom_sous_bassin** (array[string]) - Optional - Libellé(s) long du sous-bassin, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de code est 200.
- **page** (integer) - Optional - Numéro de la page.
- **size** (integer) - Optional - Nombre maximum de résultats dans une page (défaut: 20).
- **sort** (string) - Optional - Ordre de tri (asc ou desc) sur la date de prélèvement (défaut: asc).
- **type_entite_hydro** (array[string]) - Optional - Code(s) Sandre de la nature d'entité hydrographique associée à la station de mesure, si plusieurs codes, séparer les codes par une virgule, le nombre maximum de codes est 200. Liste sur https://api.sandre.eaufrance.fr/referentiels/v1/nsa/796.json

### Response
#### Success Response (200)
- **Résultat d'une rêquete sur les opération** (object) - Description of the result object.

#### Response Example
```json
{
  "example": "response body"
}
```
```

--------------------------------

### GET /api/stations

Source: https://hubeau.eaufrance.fr/api/v2/qualite_rivieres/api-docs

Retrieve a list of water monitoring stations with various filtering options.

```APIDOC
## GET /api/stations

### Description
Retrieves a list of water monitoring stations. Supports filtering by location, name, and various other criteria.

### Method
GET

### Endpoint
/api/stations

### Parameters
#### Query Parameters
- **code_commune** (string) - Optional - Code commune de la station
- **code_departement** (string) - Optional - Code département de la station
- **code_region** (string) - Optional - Code région de la station
- **code_station** (string) - Optional - Code Sandre de la station
- **code_zone_hydrographique** (string) - Optional - Code zone hydrographique de la station
- **distance** (number) - Optional - Rayon de recherche en kilomètre, le point doit être utilisé comme séparateur décimal, exemple : 30
- **fields** (string) - Optional - Liste des champs souhaités dans la réponse (fonctionnalité expérimentale), par exemple fields=code_station,localisation
- **format** (string) - Optional - Format de la réponse (ex: json, csv)
- **latitude** (number) - Optional - Latitude du point en WGS84 pour la recherche par rayon, le point doit être utilisé comme séparateur décimal, exemple : 47.829
- **libelle_commune** (array) - Optional - Libellé(s) long de la commune, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de code est 200
- **libelle_departement** (array) - Optional - Libellé(s) long du département, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de code est 200
- **libelle_fraction** (array) - Optional - Libellé(s) Sandre de la fraction analysée, si plusieurs libellés, séparer les libellés par une virgule, le nombre maximum de libellés est 200
- **libelle_masse_eau** (array) - Optional - Libellé(s) de la masse d'eau associée à la station de mesure, si plusieurs libellés, séparer les libellés par une virgule, le nombre maximum de libellés est 200
- **libelle_parametre** (array) - Optional - Libellé(s) long du paramètre de l'analyse, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de code est 200
- **libelle_qualification** (array) - Optional - Libellé(s) Sandre de la qualification de l'acquisition du résultat de l'analyse physicochimique et microbiologique, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de noms est 200
- **libelle_region** (array) - Optional - Libellé(s) long de la région, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de code est 200
- **libelle_reseau** (array) - Optional - Libellé Sandre du dispositif de collecte pour lequel l'analyse est réalisée
- **libelle_station** (array) - Optional - Libellé(s) Sandre de la station de mesure, si plusieurs libellés, séparer les libellés par une virgule, le nombre maximum de libellés est 200
- **libelle_support** (array) - Optional - Libellé(s) Sandre du support, si plusieurs libellés, séparer les libellés par une virgule, le nombre maximum de libellés est 200
- **longitude** (number) - Optional - Longitude du point en WGS84 pour la recherche par rayon, le point doit être utilisé comme séparateur décimal, exemple : 1.937
- **mnemo_statut** (array) - Optional - Mnémonique(s) du statut du résultat de l'analyse, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de noms est 200
- **nom_bassin_dce** (array) - Optional - Libellé(s) long du bassin, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de code est 200
- **nom_cours_eau** (array) - Optional - Libellé(s) long du cours d'eau, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de code est 200
- **nom_groupe_parametres** (array) - Optional - Libellé(s) long du groupe de paramètres, si plusieurs noms, séparer les noms par une virgule, le nombre maximum de code est 200

### Response
#### Success Response (200)
- **features** (array) - Array of station features.
- **type** (string) - Type of the GeoJSON object.

#### Response Example
```json
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [2.3522, 48.8566]
      },
      "properties": {
        "code_station": "00000000",
        "libelle_station": "Station Example",
        "commune": "Paris",
        "departement": "75",
        "region": "IDF",
        "latitude": 48.8566,
        "longitude": 2.3522
      }
    }
  ]
}
```
```

--------------------------------

### GET /v2/qualite_rivieres/station_pc

Source: https://hubeau.eaufrance.fr/api/v2/qualite_rivieres/api-docs

Lists physicochemical measurement stations on rivers and lakes in France and DROM. Data source: Naïades.

```APIDOC
## GET /v2/qualite_rivieres/station_pc

### Description
This service allows searching for physicochemical measurement stations on rivers and lakes in France and DROM.
Source of data: Naïades is the national interface for accessing river and lake data. http://naiades.eaufrance.fr/
If the size parameter is not provided, the default page size is 1000, with a maximum page size of 20000. The result access depth is 20000, calculated as page number * maximum number of results per page.

### Method
GET

### Endpoint
/v2/qualite_rivieres/station_pc

### Parameters
#### Query Parameters
- **bbox** (array of double) - Optional - Bounding box of the requested object, format: min longitude, min latitude, max longitude, max latitude with coordinates in WGS84 (EPSG:4326). Use '.' as the decimal separator, e.g., 1.6194,47.7965,2.1910,47.9988.
- **code_banque_reference** (array of string) - Optional - Reference bank code(s), comma-separated. Maximum 200 codes.
- **code_bassin_dce** (array of string) - Optional - DCE basin code(s), comma-separated. Maximum 200 codes.
- **code_commune** (array of string) - Optional - INSEE commune code(s), comma-separated. Maximum 200 codes.
- **code_cours_eau** (array of string) - Optional - Watercourse code(s), comma-separated. Maximum 200 codes.
- **code_departement** (array of string) - Optional - Department code(s), comma-separated. Maximum 200 codes.
- **code_eu_masse_eau** (array of string) - Optional - European water mass code(s) associated with the measurement station, comma-separated. Maximum 200 codes.
- **code_fraction** (array of string) - Optional - Sandre code(s) for the analyzed fraction, comma-separated. Maximum 200 codes. List available at https://api.sandre.eaufrance.fr/referentiels/v1/fan.json.
- **code_groupe_parametres** (array of string) - Optional - Sandre code(s) for the parameter group associated with the analyzed parameter, comma-separated. Maximum 200 codes. List available at https://api.sandre.eaufrance.fr/referentiels/v1/gpr.json.
- **code_ma** (array of string) - Optional - [Incomplete parameter description in source]
- **size** (integer) - Optional - Maximum number of results per page. Default is 1000, max is 20000.
- **sort** (string) - Optional - Sort order (asc or desc) by sampling date. Default is 'asc'. Enum: ["asc", "desc"].
- **type_entite_hydro** (array of string) - Optional - Sandre code(s) for the hydrographic entity type associated with the measurement station, comma-separated. Maximum 200 codes. List available at https://api.sandre.eaufrance.fr/referentiels/v1/nsa/796.json.

### Responses
#### Success Response (200)
- **OperationPc** (object) - OK, all results are present in the response.

#### Success Response (206)
- **OperationPc** (object) - OK, there are remaining results.

#### Error Response (400)
- **Message d'erreur** (object) - Bad request.

#### Error Response (401)
- Unauthorized

#### Error Response (403)
- Forbidden

#### Error Response (404)
- Not Found

#### Error Response (500)
- Internal server error.
```

--------------------------------

### GET /data/v1/stations

Source: https://hubeau.eaufrance.fr/api/v2/qualite_rivieres/api-docs

Retrieves water quality data from stations. Supports filtering by various parameters.

```APIDOC
## GET /data/v1/stations

### Description
Retrieves water quality data from stations. Supports filtering by various parameters.

### Method
GET

### Endpoint
/data/v1/stations

### Parameters
#### Query Parameters
- **code_parametre** (array[string]) - Optional - Code(s) of the analysis parameter. Maximum 200 codes, comma-separated.
- **code_qualification** (array[string]) - Optional - Sandre code(s) for the qualification of the acquisition of the physicochemical and microbiological analysis result. Maximum 200 codes, comma-separated. List available at https://api.sandre.eaufrance.fr/referentiels/v1/nsa/414.json
- **code_region** (array[string]) - Optional - Code(s) of the region (INSEE). Maximum 200 codes, comma-separated.
- **code_reseau** (array[string]) - Optional - Sandre code(s) of the collection device for which the analysis is performed. Maximum 200 codes, comma-separated. List available at https://api.sandre.eaufrance.fr/referentiels/v1/dc.json
- **code_sous_bassin** (array[string]) - Optional - Sandre code(s) of the sub-basin. Maximum 200 codes, comma-separated.
- **code_station** (array[string]) - Optional - Sandre code(s) of the measurement station in the national Sandre reference. Maximum 200 codes, comma-separated. List available at https://api.sandre.eaufrance.fr/referentiels/v1/stq.json
- **code_statut** (array[string]) - Optional - Sandre code(s) of the status of the analysis result. Maximum 200 codes, comma-separated. List available at https://api.sandre.eaufrance.fr/referentiels/v1/nsa/446.json
- **code_support** (array[string]) - Optional - Code(s) of the support. Maximum 200 codes, comma-separated.
- **date_debut_maj** (string) - Optional - Start date of updates (YYYY-MM-DD format). Example: 2014-12-06
- **date_debut_prelevement** (string) - Optional - Start date of sample collection (YYYY-MM-DD format). Example: 2014-12-06
- **date_fin_maj** (string) - Optional - End date of updates (YYYY-MM-DD format). Example: 2014-12-06
- **date_fin_prelevement** (string) - Optional - End date of sample collection (YYYY-MM-DD format). Example: 2014-12-06
- **distance** (number) - Optional - Search radius in kilometers. Use a period as the decimal separator. Example: 30
- **exact_count** (boolean) - Optional - If true, enables exact pagination (count, last), resulting in slower responses. If false, provides an approximation for faster responses (default: true).
- **fields** (string) - Optional - List of desired fields in the response (experimental feature). Example: fields=code_station,localisation
- **latitude** (number) - Optional - Latitude in WGS84 for radius search. Use a period as the decimal separator. Example: 47.829
- **libelle_commune** (array[string]) - Optional - Full name(s) of the commune. Maximum 200 names, comma-separated.
- **libelle_departement** (array[string]) - Optional - Full name(s) of the department. Maximum 200 names, comma-separated.
```

--------------------------------

### GET /analyses

Source: https://hubeau.eaufrance.fr/api/v2/qualite_rivieres/api-docs

Retrieves water quality analysis data based on specified query parameters.

```APIDOC
## GET /analyses

### Description
Retrieves water quality analysis data based on various filters including station codes, geographic location, and date ranges.

### Method
GET

### Endpoint
/analyses

### Parameters
#### Query Parameters
- **code_reseau** (array) - Optional - Sandre code(s) of the collection device.
- **code_sous_bassin** (array) - Optional - Sandre code(s) of the sub-basin.
- **code_station** (array) - Optional - Sandre code(s) of the measurement station.
- **code_statut** (array) - Optional - Sandre code(s) of the analysis result status.
- **code_support** (array) - Optional - Code(s) of the support.
- **date_debut_maj** (string) - Optional - Start date of updates (YYYY-MM-DD).
- **date_fin_maj** (string) - Optional - End date of updates (YYYY-MM-DD).
- **date_debut_prelevement** (string) - Optional - Start date of sampling (YYYY-MM-DD).
- **date_fin_prelevement** (string) - Optional - End date of sampling (YYYY-MM-DD).
- **latitude** (number) - Optional - Latitude in WGS84 for radius search.
- **distance** (number) - Optional - Search radius in kilometers.
- **libelle_commune** (array) - Optional - Long label(s) of the municipality.
- **libelle_departement** (array) - Optional - Long label(s) of the department.
- **exact_count** (boolean) - Optional - If true, provides exact pagination count (slower). Default: true.
- **format** (string) - Optional - Response format: json, geojson. Default: json.
```
Tokens:
Raw