api-maree.fr

Dernière mise à jour :

Mises à jour de l'API marée

Cette page recense les évolutions du service : nouveaux sites, nouveaux endpoints, améliorations des prévisions ou des coefficients. Chaque entrée indique sa date et ce qui change concrètement pour les utilisateurs de l'API.

Le service évolue régulièrement. Si vous souhaitez signaler un port manquant ou une anomalie sur les hauteurs d'eau, la page contact est là pour ça.

  1. Prévisions et coefficients affinés grâce aux observations

    • prévisions
    • coefficients
    • Les constantes harmoniques de 48 ports ont été recalées sur les mesures des marégraphes du réseau REFMAR (SHOM) : sur les ports ajustés, l'écart moyen aux observations passe de 26 cm à 16 cm, et l'écart maximal de 1,22 m à 0,44 m.
    • Le coefficient de marée bénéficie du même travail d'affinage : son calcul a été revu pour l'ensemble de l'année 2026.
  2. Comparaison avec les observations : seuil de distance porté à 6 km

    • comparaison
    • La page de comparaison propose désormais les marégraphes situés jusqu'à 6 km du site comparé, contre 5 km auparavant.
    • Brest et Ouistreham redeviennent ainsi comparables, sans alerte de distance.
  3. Nouveaux sites : Île-Grande et Trégastel

    • sites
    • Deux sites bretons rejoignent l'API : Île-Grande et Trégastel.
    • Leurs positions ont été vérifiées puis ajustées pour rester au plus près de la zone de référence de chaque port.
  4. Comparaison des prévisions avec les observations REFMAR

    • comparaison
    • Une page publique permet de confronter les hauteurs d'eau prévues par l'API aux observations du réseau REFMAR (SHOM), jour par jour, sur de nombreux sites.
    • Elle est accessible sans compte : elle utilise la clé de démonstration, étendue à 9 ports pour l'occasion.
  5. Nouvel endpoint /tide-coefficients

    • endpoint
    • Les coefficients de marée de chaque jour sont désormais exposés sur une plage allant de 365 jours dans le passé à 365 jours dans le futur.
    • La réponse est groupée par jour et indique le site, le fuseau horaire et la source des données.
  6. Nouvel endpoint /sun-times

    • endpoint
    • Les horaires de lever et de coucher du soleil sont disponibles par site et par jour, calculés à partir des coordonnées du site.
    • Cet endpoint ne consomme pas de quota, la clé API restant nécessaire.
  7. Nouvel endpoint /height-search

    • endpoint
    • /height-search retrouve les instants où la hauteur d'eau atteint une valeur cible sur une période donnée, à la montée comme à la descente.
    • Pratique pour les seuils d'accès : hauteur de passage sur un seuil, tirant d'eau, mise à l'eau.
  8. Calculs plus rapides sur les longues périodes

    • performance
    • /tide-extrema répond environ 17 fois plus vite sur une plage de 2 ans.
    • /height-search répond environ 9 fois plus vite sur 61 jours.
  9. Emails de vérification et de mot de passe plus fiables

    • compte
    • Les emails de vérification de compte et de réinitialisation de mot de passe sont envoyés en texte brut et en HTML propres, ce qui améliore nettement leur délivrabilité.
  10. Suppression de compte en autonomie

    • compte
    • RGPD
    • Chaque utilisateur peut supprimer son compte et ses données depuis son espace, sans passer par le support.
    • Les demandes de suppression reçues par contact peuvent également être traitées par l'administration.
  11. Assistants IA (MCP) : accès sécurisé par OAuth

    • MCP
    • assistants IA
    • Le serveur MCP s'utilise avec OAuth : vous autorisez l'application d'IA depuis votre compte, et vous pouvez révoquer cette autorisation à tout moment.
    • L'état du quota et la régénération de la clé API sont également disponibles depuis l'espace compte.
  12. Nouvelle page « Horaires et coefficients »

    • guide
    • Une page dédiée explique comment obtenir les pleines et basses mers ainsi que les coefficients d'une journée, avec des exemples de réponse.
  13. Pleines et basses mers avec coefficients

    • endpoint
    • L'endpoint /tide-extrema renvoie les pleines et basses mers d'une plage de dates, chaque pleine mer étant accompagnée de son coefficient.
    • La liste des sites disponibles est exposée par l'API, avec le nom de chaque lieu.