Sites et ports disponibles dans l'API marée
Avant d'intégrer une API de marée, on souhaite généralement savoir si un port ou un site précis est disponible. L'API api-maree.fr expose une route dédiée pour récupérer cette liste.
Pourquoi cette liste est utile
La liste des sites permet de construire un sélecteur dans une interface, de vérifier qu'un port est bien couvert, ou de préparer des intégrations sans maintenir une liste statique à la main dans votre code.
C'est aussi une bonne porte d'entrée pour découvrir l'API si vous souhaitez d'abord voir les identifiants disponibles avant d'interroger les hauteurs d'eau.
La requête à utiliser
L'endpoint /sites retourne la liste des sites disponibles avec leur identifiant et leurs coordonnées.
GET /sitesExemple de réponse
{
"sites": [
{
"site_id": "port-en-bessin",
"name": "Port en Bessin",
"latitude": 49.352565,
"longitude": -0.749206
}
]
}
L'identifiant site_id est le champ le plus important.
C'est lui qui sera ensuite utilisé pour appeler /water-levels.
Comment l'utiliser dans une application
Une intégration classique consiste à charger cette liste une première fois, puis à afficher les sites dans un menu déroulant. L'utilisateur choisit ensuite un port, et l'application enchaîne avec une requête de hauteurs d'eau sur ce site.
Cela évite les erreurs d'identifiant et rend l'expérience plus robuste dans le temps.
Si un lieu particulier manque, vous pouvez aussi contacter l'équipe afin d'étudier son ajout au service.