Température des cours d'eau

L'API "Température des cours d'eau" permet d'interroger les données de températures relevées par des capteurs automatiques posés dans les cours d'eau de France métropolitaine.
Ces capteurs enregistrent la température à des fréquences variant d'une minute à quelques heures.

Console de l'API Source des données Conditions d'utilisation

Présentation

Les données proviennent de la banque de données Naïades. Elles sont mises à jour trimestriellement.

Le réseau de mesure comprend environ 760 stations, dont une cinquantaine seulement est toujours en service.

Depuis le 19 juillet 2022, suite à la mise à jour du moteur d'indexation, les données sont synchronisées en temps réel avec celles de la banque Naïades.

Faites-nous part de vos commentaires sur le forum de contribution Github

Depuis octobre 2022, la disponibilité du endpoint chronique est mesurée par la plateforme Netvigie.
Les taux de disponibilités sont indiqués ci-dessous sur 1, 3 et 6 mois.

Horizon	1 mois	3 mois	6 mois
Période	01/12/2024 - 31/12/2024	01/10/2024 - 31/12/2024	01/07/2024 - 31/12/2024
Disponibilité	97,30 %	92,49 %	94,86 %

Derniers changements
- 19/07/2022 : mise à jour du moteur d'indexation, synchronisé en temps réel avec Naïades ;
- 30/07/2018 : publication de la version 1 ;
- 14/06/2018 : publication de la version bêta-1, correction bug chroniques.csv ;
- 31/05/2018 : publication de la version bêta-0.
Exposition des données

Les formats supportés sont : JSON, GeoJSON et CSV.
Accessibilité
L'API Hub'Eau est accessible :
- en http : http:/hubeau.eaufrance.fr/api/v1/temperature/station?code_departement=45&pretty
- et https : https://hubeau.eaufrance.fr/api/v1/temperature/station?code_departement=45&pretty
Pour gérer le cross-domain, l'API supporte les protocoles :
- CORS (Cross Origin Resource Sharing)
- JSONP avec le paramètre callback pour les anciens navigateurs : https://hubeau.eaufrance.fr/api/v1/temperature/station?code_departement=45&pretty&callback=jquery12
Pagination
Les opérations sont paginées et suivent le même modèle de pagination non séquentiel, permettant de sauter d'une page à l'autre de résultats dans n'importe quel ordre. En contre-partie, la profondeur d'accès aux résultats est limitée.

Paramètres
- page : le numéro de page
- size : la taille de la page
Attributs
- Les attributs prev et next (définis à null si il n'y a pas de page précédente et/ou suivante) sont disponibles dans l'URL de la réponse pour éviter d'avoir à calculer les pages précédentes et/ou suivantes
- L'attribut first permet d'accéder à la première page des résultats,
- L'attribut last permet d'accéder à la dernière page des résultats,
- L'attribut count permet de compter le nombre total de résultats,
- L'attribut data permet d'accéder aux résultats sous forme de liste.
Limitations

Taille de page
Les résultats sont paginés avec une valeur par défaut et une valeur maximum de taille de page pour chaque opération. Cette valeur est indiquée dans les commentaires de l'opération. Par exemple : "taille de page par défaut : 5000, taille max de la page : 20000."

Profondeur d'accès aux résultats
La profondeur d'accès aux résultats (numéro de la page * nombre maximum de résultats dans une page) est limitée à 20 000 enregistrements. Cette limite peut empêcher la récupération de l'intégralité des résultats d'une requête ; il faut alors découper la requête en plusieurs requêtes à l'aide de critères plus discriminants.

Longueur maximale de l'URL
La requête est bloquée si la longueur de l'URL dépasse 2 083 caractères.
Opérations
Les différentes opérations possibles (endpoints) sont :
- station, permettant de rechercher les stations sur lesquelles sont mesurées les températures en continu dans les cours d'eau ;
- chronique, permettant de rechercher les chroniques de températures en continu dans les cours d'eau mesurées aux différentes stations.

Exemple

Demande 1 :
Récupérer les stations de mesure de la température en continu dans le département du Loiret.

URL appelée :
http://hubeau.eaufrance.fr/api/v1/temperature/station?code_departement=45&size=20&exact_count=true&format=json&pretty

Résultats : 6 stations correspondent à la demande

{
  "count" : 6,
  "first" : "https://hubeau.eaufrance.fr/api/v1/temperature/station?code_departement=45&exact_count=true&format=json&pretty&page=1&size=20",
  "last" : null,
  "prev" : null,
  "next" : null,
  "api_version" : "1.0.0",
  "data" : [ {
    "code_station" : "03053310",
    "libelle_station" : "LA CLÉRY A SAINT-LOUP-DE-GONOIS 1",
    "uri_station" : "http://id.eaufrance.fr/STQ/03053310",
    "localisation" : "La chanteraine",
    "coordonnee_x" : 693650.0,
    "coordonnee_y" : 6773129.0,
    "code_type_projection" : 26,
    "longitude" : 2.914761935,
    "latitude" : 48.058510049,
    "code_commune" : "45287",
    "libelle_commune" : "SAINT-LOUP-DE-GONOIS",
    "code_departement" : "45",
    "libelle_departement" : "LOIRET",
    "code_region" : "24",
    "libelle_region" : "CENTRE-VAL-DE-LOIRE",
    "code_troncon_hydro" : "F4280600",
    "code_cours_eau" : "F4280600",
    "libelle_cours_eau" : "rivière la cléry",
    "uri_cours_eau" : "http://id.eaufrance.fr/CEA/F4280600",
    "code_masse_eau" : "HR84",
    "libelle_masse_eau" : "la Clery de sa source au confluent du Loing  exclu",
    "uri_masse_eau" : "http://id.eaufrance.fr/MDO/HR84",
    "code_sous_bassin" : "FRH_SEAM",
    "libelle_sous_bassin" : "Seine amont",
    "code_bassin" : "H",
    "libelle_bassin" : "La Seine et les cours d'eau côtiers normands",
    "uri_bassin" : "http://id.eaufrance.fr/SEH/H",
    "pk" : null,
    "altitude" : 0.0,
    "date_maj_infos" : "2012-09-04",
    "geometry" : {
      "type" : "Point",
      "crs" : {
        "type" : "name",
        "properties" : {
          "name" : "urn:ogc:def:crs:OGC:1.3:CRS84"
        }
      },
      "coordinates" : [ 2.9147619348576153, 48.058510048657496 ]
    }
  }, {
    "code_station" : "03057000",
    "libelle_station" : "L'OUANNE A GY-LES-NONAINS 2",
    "uri_station" : "http://id.eaufrance.fr/STQ/03057000",
    "localisation" : "PONT CD 793,AMONT PONT ,BRAS DROIT",
    "coordonnee_x" : 688537.0,
    "coordonnee_y" : 6760880.0,
    "code_type_projection" : 26,
    "longitude" : 2.846448386,
    "latitude" : 47.948210779,
    "code_commune" : "45165",
    "libelle_commune" : "GY-LES-NONAINS",
    "code_departement" : "45",
    "libelle_departement" : "LOIRET",
    "code_region" : "24",
    "libelle_region" : "CENTRE-VAL-DE-LOIRE",
    "code_troncon_hydro" : "F4160400",
    "code_cours_eau" : "F41-0400",
    "libelle_cours_eau" : "rivière l'ouanne",
    "uri_cours_eau" : "http://id.eaufrance.fr/CEA/F41-0400",
    "code_masse_eau" : "HR79",
    "libelle_masse_eau" : "L Ouanne du confluent du Branlin  exclu  au confluent du Loing  exclu",
    "uri_masse_eau" : "http://id.eaufrance.fr/MDO/HR79",
    "code_sous_bassin" : "FRH_SEAM",
    "libelle_sous_bassin" : "Seine amont",
    "code_bassin" : "H",
    "libelle_bassin" : "La Seine et les cours d'eau côtiers normands",
    "uri_bassin" : "http://id.eaufrance.fr/SEH/H",
    "pk" : null,
    "altitude" : 0.0,
    "date_maj_infos" : "2012-09-04",
    "geometry" : {
      "type" : "Point",
      "crs" : {
        "type" : "name",
        "properties" : {
          "name" : "urn:ogc:def:crs:OGC:1.3:CRS84"
        }
      },
      "coordinates" : [ 2.846448385521963, 47.94821077865444 ]
    }
  }, {
    "code_station" : "04048550",
    "libelle_station" : "NOTREURE à CERNOY-EN-BERRY",
    "uri_station" : "http://id.eaufrance.fr/STQ/04048550",
    "localisation" : "PONT D53 AU LIEU-DIT L'AUBIER (RD)",
    "coordonnee_x" : 672611.6,
    "coordonnee_y" : 6718162.0,
    "code_type_projection" : 26,
    "longitude" : 2.635762779,
    "latitude" : 47.563263744,
    "code_commune" : "45064",
    "libelle_commune" : "CERNOY-EN-BERRY",
    "code_departement" : "45",
    "libelle_departement" : "LOIRET",
    "code_region" : "24",
    "libelle_region" : "CENTRE-VAL-DE-LOIRE",
    "code_troncon_hydro" : "K4194000",
    "code_cours_eau" : "K4194000",
    "libelle_cours_eau" : "la Notreure",
    "uri_cours_eau" : "http://id.eaufrance.fr/CEA/K4194000",
    "code_masse_eau" : "GR0295",
    "libelle_masse_eau" : "LA NOTREURE ET SES AFFLUENTS DEPUIS LA SOURCE JUSQU'A LA CONFLUENCE AVEC LA LOIRE",
    "uri_masse_eau" : "http://id.eaufrance.fr/MDO/GR0295",
    "code_sous_bassin" : "FRG_LMOY",
    "libelle_sous_bassin" : "Loire moyenne",
    "code_bassin" : "G",
    "libelle_bassin" : "La Loire, les cours d'eau côtiers vendéens et bretons",
    "uri_bassin" : "http://id.eaufrance.fr/SEH/G",
    "pk" : 979750.0,
    "altitude" : 0.0,
    "date_maj_infos" : "2013-02-19",
    "geometry" : {
      "type" : "Point",
      "crs" : {
        "type" : "name",
        "properties" : {
          "name" : "urn:ogc:def:crs:OGC:1.3:CRS84"
        }
      },
      "coordinates" : [ 2.635762779336114, 47.56326374358099 ]
    }
  }, {
    "code_station" : "04049625",
    "libelle_station" : "BEC D'ABLE à SULLY-SUR-LOIRE",
    "uri_station" : "http://id.eaufrance.fr/STQ/04049625",
    "localisation" : "MOULIN DE REMOURS (RD)",
    "coordonnee_x" : 649237.6,
    "coordonnee_y" : 6740291.0,
    "code_type_projection" : 26,
    "longitude" : 2.322399252,
    "latitude" : 47.761051944,
    "code_commune" : "45315",
    "libelle_commune" : "SULLY-SUR-LOIRE",
    "code_departement" : "45",
    "libelle_departement" : "LOIRET",
    "code_region" : "24",
    "libelle_region" : "CENTRE-VAL-DE-LOIRE",
    "code_troncon_hydro" : "K4250300",
    "code_cours_eau" : "K42-0300",
    "libelle_cours_eau" : "le Bec d'Able",
    "uri_cours_eau" : "http://id.eaufrance.fr/CEA/K42-0300",
    "code_masse_eau" : "GR1116",
    "libelle_masse_eau" : "LE BEC D'ABLE ET SES AFFLUENTS DEPUIS LA SOURCE JUSQU'A LA CONFLUENCE AVEC LA LOIRE",
    "uri_masse_eau" : "http://id.eaufrance.fr/MDO/GR1116",
    "code_sous_bassin" : "FRG_LMOY",
    "libelle_sous_bassin" : "Loire moyenne",
    "code_bassin" : "G",
    "libelle_bassin" : "La Loire, les cours d'eau côtiers vendéens et bretons",
    "uri_bassin" : "http://id.eaufrance.fr/SEH/G",
    "pk" : 995341.0,
    "altitude" : 0.0,
    "date_maj_infos" : "2013-02-19",
    "geometry" : {
      "type" : "Point",
      "crs" : {
        "type" : "name",
        "properties" : {
          "name" : "urn:ogc:def:crs:OGC:1.3:CRS84"
        }
      },
      "coordinates" : [ 2.3223992522226955, 47.76105194359059 ]
    }
  }, {
    "code_station" : "04051125",
    "libelle_station" : "DHUY à SANDILLON",
    "uri_station" : "http://id.eaufrance.fr/STQ/04051125",
    "localisation" : "PONT D13 (RD)",
    "coordonnee_x" : 628797.6,
    "coordonnee_y" : 6746262.0,
    "code_type_projection" : 26,
    "longitude" : 2.0486187,
    "latitude" : 47.812892122,
    "code_commune" : "45300",
    "libelle_commune" : "SANDILLON",
    "code_departement" : "45",
    "libelle_departement" : "LOIRET",
    "code_region" : "24",
    "libelle_region" : "CENTRE-VAL-DE-LOIRE",
    "code_troncon_hydro" : "K4370310",
    "code_cours_eau" : "K43-0310",
    "libelle_cours_eau" : "la Dhuy",
    "uri_cours_eau" : "http://id.eaufrance.fr/CEA/K43-0310",
    "code_masse_eau" : "GR1140",
    "libelle_masse_eau" : "LA DHUY ET SES AFFLUENTS DEPUIS LA SOURCE JUSQU'A LA CONFLUENCE AVEC LE LOIRET",
    "uri_masse_eau" : "http://id.eaufrance.fr/MDO/GR1140",
    "code_sous_bassin" : "FRG_LMOY",
    "libelle_sous_bassin" : "Loire moyenne",
    "code_bassin" : "G",
    "libelle_bassin" : "La Loire, les cours d'eau côtiers vendéens et bretons",
    "uri_bassin" : "http://id.eaufrance.fr/SEH/G",
    "pk" : 988255.0,
    "altitude" : 0.0,
    "date_maj_infos" : "2013-05-27",
    "geometry" : {
      "type" : "Point",
      "crs" : {
        "type" : "name",
        "properties" : {
          "name" : "urn:ogc:def:crs:OGC:1.3:CRS84"
        }
      },
      "coordinates" : [ 2.0486187004618786, 47.81289212224053 ]
    }
  }, {
    "code_station" : "04051650",
    "libelle_station" : "ARDOUX à CLERY-SAINT-ANDRE",
    "uri_station" : "http://id.eaufrance.fr/STQ/04051650",
    "localisation" : "AMONT PONT GUE DU ROI",
    "coordonnee_x" : 608980.5,
    "coordonnee_y" : 6746966.0,
    "code_type_projection" : 26,
    "longitude" : 1.783722053,
    "latitude" : 47.816779591,
    "code_commune" : "45098",
    "libelle_commune" : "CLÉRY-SAINT-ANDRÉ",
    "code_departement" : "45",
    "libelle_departement" : "LOIRET",
    "code_region" : "24",
    "libelle_region" : "CENTRE-VAL-DE-LOIRE",
    "code_troncon_hydro" : "K4430300",
    "code_cours_eau" : "K44-0300",
    "libelle_cours_eau" : "l'Ardoux",
    "uri_cours_eau" : "http://id.eaufrance.fr/CEA/K44-0300",
    "code_masse_eau" : "GR0300",
    "libelle_masse_eau" : "L'ARDOUX DEPUIS ARDON JUSQU'A LA CONFLUENCE AVEC LA LOIRE",
    "uri_masse_eau" : "http://id.eaufrance.fr/MDO/GR0300",
    "code_sous_bassin" : "FRG_LMOY",
    "libelle_sous_bassin" : "Loire moyenne",
    "code_bassin" : "G",
    "libelle_bassin" : "La Loire, les cours d'eau côtiers vendéens et bretons",
    "uri_bassin" : "http://id.eaufrance.fr/SEH/G",
    "pk" : 974138.0,
    "altitude" : 0.0,
    "date_maj_infos" : "2013-05-27",
    "geometry" : {
      "type" : "Point",
      "crs" : {
        "type" : "name",
        "properties" : {
          "name" : "urn:ogc:def:crs:OGC:1.3:CRS84"
        }
      },
      "coordinates" : [ 1.7837220525617385, 47.81677959068703 ]
    }
  } ]
}

Demande 2 :
Récupérer les 5 dernières mesures de température sur la station de Sandillon (code 04051125).

URL appelée :
https://hubeau.eaufrance.fr/api/v1/temperature/chronique?code_station=04051125&size=5&sort=desc&pretty

Résultats :

{
  "count" : 26926,
  "first" : "https://hubeau.eaufrance.fr/api/v1/temperature/chronique?code_station=04051125&sort=desc&pretty&page=1&size=5",
  "last" : "https://hubeau.eaufrance.fr/api/v1/temperature/chronique?code_station=04051125&sort=desc&pretty&page=5386&size=5",
  "prev" : null,
  "next" : "https://hubeau.eaufrance.fr/api/v1/temperature/chronique?code_station=04051125&sort=desc&pretty&page=2&size=5",
  "api_version" : "1.0.0",
  "data" : [ {
    "code_station" : "04051125",
    "libelle_station" : "DHUY à SANDILLON",
    "uri_station" : "http://id.eaufrance.fr/STQ/04051125",
    "longitude" : 2.0486187,
    "latitude" : 47.812892122,
    "code_commune" : "45300",
    "libelle_commune" : "SANDILLON",
    "code_cours_eau" : "K43-0310",
    "libelle_cours_eau" : "la Dhuy",
    "uri_cours_eau" : "http://id.eaufrance.fr/CEA/K43-0310",
    "code_parametre" : "1301",
    "libelle_parametre" : "Température de l'Eau",
    "date_mesure_temp" : "2013-05-17",
    "heure_mesure_temp" : "01:00:00",
    "resultat" : 13.329,
    "code_unite" : "27",
    "symbole_unite" : "°C",
    "code_qualification" : "4",
    "libelle_qualification" : "Non qualifié"
  }, {
    "code_station" : "04051125",
    "libelle_station" : "DHUY à SANDILLON",
    "uri_station" : "http://id.eaufrance.fr/STQ/04051125",
    "longitude" : 2.0486187,
    "latitude" : 47.812892122,
    "code_commune" : "45300",
    "libelle_commune" : "SANDILLON",
    "code_cours_eau" : "K43-0310",
    "libelle_cours_eau" : "la Dhuy",
    "uri_cours_eau" : "http://id.eaufrance.fr/CEA/K43-0310",
    "code_parametre" : "1301",
    "libelle_parametre" : "Température de l'Eau",
    "date_mesure_temp" : "2013-05-17",
    "heure_mesure_temp" : "02:00:00",
    "resultat" : 13.281,
    "code_unite" : "27",
    "symbole_unite" : "°C",
    "code_qualification" : "4",
    "libelle_qualification" : "Non qualifié"
  }, {
    "code_station" : "04051125",
    "libelle_station" : "DHUY à SANDILLON",
    "uri_station" : "http://id.eaufrance.fr/STQ/04051125",
    "longitude" : 2.0486187,
    "latitude" : 47.812892122,
    "code_commune" : "45300",
    "libelle_commune" : "SANDILLON",
    "code_cours_eau" : "K43-0310",
    "libelle_cours_eau" : "la Dhuy",
    "uri_cours_eau" : "http://id.eaufrance.fr/CEA/K43-0310",
    "code_parametre" : "1301",
    "libelle_parametre" : "Température de l'Eau",
    "date_mesure_temp" : "2013-05-17",
    "heure_mesure_temp" : "03:00:00",
    "resultat" : 13.257,
    "code_unite" : "27",
    "symbole_unite" : "°C",
    "code_qualification" : "4",
    "libelle_qualification" : "Non qualifié"
  }, {
    "code_station" : "04051125",
    "libelle_station" : "DHUY à SANDILLON",
    "uri_station" : "http://id.eaufrance.fr/STQ/04051125",
    "longitude" : 2.0486187,
    "latitude" : 47.812892122,
    "code_commune" : "45300",
    "libelle_commune" : "SANDILLON",
    "code_cours_eau" : "K43-0310",
    "libelle_cours_eau" : "la Dhuy",
    "uri_cours_eau" : "http://id.eaufrance.fr/CEA/K43-0310",
    "code_parametre" : "1301",
    "libelle_parametre" : "Température de l'Eau",
    "date_mesure_temp" : "2013-05-17",
    "heure_mesure_temp" : "04:00:00",
    "resultat" : 13.233,
    "code_unite" : "27",
    "symbole_unite" : "°C",
    "code_qualification" : "4",
    "libelle_qualification" : "Non qualifié"
  }, {
    "code_station" : "04051125",
    "libelle_station" : "DHUY à SANDILLON",
    "uri_station" : "http://id.eaufrance.fr/STQ/04051125",
    "longitude" : 2.0486187,
    "latitude" : 47.812892122,
    "code_commune" : "45300",
    "libelle_commune" : "SANDILLON",
    "code_cours_eau" : "K43-0310",
    "libelle_cours_eau" : "la Dhuy",
    "uri_cours_eau" : "http://id.eaufrance.fr/CEA/K43-0310",
    "code_parametre" : "1301",
    "libelle_parametre" : "Température de l'Eau",
    "date_mesure_temp" : "2013-05-17",
    "heure_mesure_temp" : "05:00:00",
    "resultat" : 13.209,
    "code_unite" : "27",
    "symbole_unite" : "°C",
    "code_qualification" : "4",
    "libelle_qualification" : "Non qualifié"
  } ]
}

On récupère ainsi les 5 dernières mesures parmi les 26926 disponibles.

Consulter les APIs

Température des cours d'eau

Présentation

Derniers changements

Exposition des données

Accessibilité

Pagination

Limitations

Opérations

Exemple