Récupérer les horaires de pleine mer, basse mer et coefficients

Quel endpoint utiliser

Pour les horaires de marée, utilisez /tide-extrema. Cet endpoint retourne les extrema de marée d'un site : PM pour pleine mer et BM pour basse mer.

Les coefficients sont associés aux pleines mers. Si vous avez besoin d'une courbe complète avec un point toutes les 10 minutes, utilisez plutôt /water-levels.

Exemple de requête

La période de /tide-extrema se renseigne avec des dates simples au format YYYY-MM-DD. Le paramètre to est inclusif : une requête du 24 au 24 mars retourne les horaires du 24 mars uniquement.

GET /tide-extrema?site=port-en-bessin&from=2026-03-24&to=2026-03-24&tz=Europe/Paris&key=00000000000000000000000000000000

Exemple de réponse JSON

La réponse groupe les résultats par jour. Chaque extremum indique son type, son heure locale et sa hauteur en mètres. Le champ coef est présent sur les pleines mers.

{
  "site": "port-en-bessin",
  "timezone": "Europe/Paris",
  "from": "2026-03-24T00:00:00+01:00",
  "to": "2026-03-25T00:00:00+01:00",
  "unit": "m",
  "data": [
    {
      "date": "2026-03-24",
      "extrema": [
        { "type": "PM", "time": "00:24", "height": 6.721, "coef": 45 },
        { "type": "BM", "time": "07:18", "height": 2.381 }
      ]
    }
  ]
}

Lire les champs utiles

Le champ type distingue les pleines mers et les basses mers. Le champ time donne l'heure locale dans le fuseau demandé avec tz. Le champ height donne la hauteur d'eau en mètres.

Le coefficient de marée est disponible dans coef sur les éléments PM. Les basses mers n'ont pas de coefficient, ce qui permet de garder une structure proche des usages nautiques habituels.

Exemple en JavaScript

Dans une interface web, vous pouvez appeler l'endpoint avec fetch, puis afficher les horaires du tableau data.

const url = new URL("https://api-maree.fr/tide-extrema");
url.search = new URLSearchParams({
  site: "port-en-bessin",
  from: "2026-03-24",
  to: "2026-03-24",
  tz: "Europe/Paris",
  key: "00000000000000000000000000000000"
});

const response = await fetch(url);
const payload = await response.json();

console.log(payload.data[0].extrema);

Points à retenir

Utilisez /tide-extrema quand vous voulez afficher des horaires de pleine mer et basse mer avec coefficients. Utilisez /water-levels quand vous avez besoin d'une série de hauteurs d'eau pour dessiner une courbe.