Cas d’usage API : châteaux et pépites gourmandes

L’exploration gourmande

Imaginez que vous visitez un château. À seulement quelques kilomètres, des producteurs gourmands vous ouvrent leurs portes. Encore faut-il savoir qu’ils existent !

Derrière chaque site emblématique se déploie un écosystème local riche : producteurs, caves, savoir-faire. Autant de ressources bien réelles, mais souvent dispersées, difficiles à identifier et encore plus à valoriser à l’échelle nationale.

L’API DATAtourisme change la donne en facilitant la collecte et la mise en relation de ces offres, au bénéfice des producteurs comme des territoires.

Le cas d’usage

L’approche est simple : partir d’un lieu emblématique et explorer son environnement culinaire.

Pour cet exemple, nous avons choisi le Château de Chambord, le Château de Beynac et le Clos Lucé. Nous demandons à l’API de rechercher dans un rayon de 30 à 50 km les producteurs et expériences de dégustation présents à proximité. Concrètement un utilisateur peut :

• Sélectionner un lieu ;
• Interroger l’API dans un périmètre donné ;
• Afficher les résultats sur une carte et dans une liste enrichie (photos, contacts, descriptifs).

Une offre locale structurée, directement mobilisable, émerge au-delà des frontières administratives.

Trois départements, deux régions… et un seul langage de données !

Château du Clos Lucé – Parc Leonardo da Vinci, Amboise @Cecil Mathieu • OFFICE AMBOISE

Les étapes pour y arriver

1. Obtenir une clé API DATAtourisme

Premier prérequis : disposer d’une clé API. Son obtention est simple, rapide et gratuite.

2. Générer le code du cas d’usage

À partir d’un besoin précis, il est ensuite possible de produire un code capable d’interroger l’API et d’afficher les résultats. Cette phase peut être facilitée par l’IA, qui permet de générer rapidement une première base fonctionnelle. Par exemple, voici le type de consigne que l’on peut formuler :

Crée un code HTML simple avec Leaflet et JavaScript qui interroge l’API DATAtourisme à partir d’un lieu emblématique choisi par l’utilisateur.
Le lieu doit être sélectionné dans une liste déroulante.
L’utilisateur doit aussi pouvoir choisir un rayon de 20, 30 ou 50 km.
Le code doit rechercher les POI de type “Fournisseur de dégustation” autour du lieu sélectionné, afficher les résultats sur une carte et dans une liste.
Pour chaque résultat, afficher au minimum : le nom, l’adresse, une photo si disponible, un site web et un descriptif.
Le rendu doit être lisible et directement intégrable dans une page web.

Notre exemple concerne les fournisseurs de dégustation, mais la même logique pourrait s’appliquer aux hébergements, aux événements culturels ou encore au patrimoine local.

3. Intégrer la brique dans un support numérique

Le module peut ensuite être embarqué dans un site web, une application ou tout autre support afin d’enrichir les contenus, croiser les données et proposer de nouveaux parcours de découverte.

Pourquoi ça fonctionne ?

Si ce type de démonstration est possible, c’est parce que DATAtourisme repose sur une ontologie commune. Elle permet :

De qualifier les objets touristiques dans un vocabulaire partagé ;
De filtrer et croiser les données à l’échelle nationale ;
De rendre ces données directement réutilisables, gratuitement.

Portée du cas d’usage

Cet exemple, volontairement simple, montre un usage clé de l’API :

• Transformer un lieu en porte d’entrée vers un territoire ;
• Enrichir un contenu avec des suggestions pertinentes ;
• Valoriser des offres moins visibles ;
• Améliorer l’expérience utilisateur en proposant des idées de découverte.

Et c’est gratuit… ça fait vivre nos territoires.

Autrement dit, l’API DATAtourisme ne sert pas seulement à afficher des données, mais à créer des liens entre les offres et à structurer une expérience touristique.

Photo de couverture © Domaine national de Chambord – Olivier Marchant • ADT41