Aller au contenu principal

Data API

Itinéraires et terrain, en un seul appel typé

La Data API renvoie itinéraires, suggestions de boucles et analyses de terrain partout dans le monde, sous forme de données typées pour votre produit et vos agents IA. En libre-service : créez un compte, ajoutez un moyen de paiement et payez à la requête.

Compatible avec les outils que vous utilisez déjà

Des données outdoor adaptées à l'activité

De vos critères à un itinéraire chiffré

Demandez un itinéraire en précisant le sport, la distance et le dénivelé. Chaque proposition est renvoyée avec sa distance, son dénivelé positif, une durée estimée selon le terrain, la surface de chaque tronçon à pied et à vélo de route, et le tracé au format GeoJSON. Le client typé rédige la requête à votre place.

  • Calcul d'itinéraire, guidage et suggestions de parcours
  • Bientôt disponible : la météo passée, en temps réel et prévue
  • Altitude, analyse du terrain, recherche et points d'intérêt
// Three trail loops from Chamonix: about 14 km, 600 m of climbing.
const { routes } = await client.data.suggestions({
  activity: "HIKING_AND_TRAIL",
  start: [6.8712, 45.9231],
  distance: 14000,
  ascent: 600,
  candidates: 3,
});

// Closest first: 13.8 km, +615 m, measured on the loop itself.
const loops = routes.map((route) => ({
  distance: route.distance, // meters
  ascent: route.elevation.ascent, // meters
  duration: route.duration, // seconds, paced over slope and surface
  surfaces: route.analysis.surfaceInfo, // surface per stretch
  geometry: route.geometry, // GeoJSON, ready for your map
  seed: route.seed, // send it back to keep or skip this loop
}));

Ce que demande votre code

Chaque opération devient une méthode typée

Chacune est une méthode du client typé. Ses arguments et sa réponse sont typés d'après le schéma.

Suggestions d'itinéraires

Envoyez un sport, une distance, un dénivelé et un point de départ : les itinéraires candidats reviennent en GeoJSON.

Calcul d'itinéraire

Des itinéraires adaptés à l'activité, à pied, sur neige ou à vélo de route, calculés selon la pente. Distance et durée accompagnent le tracé.

Analyse de tracé

Envoyez un tracé dessiné ou importé par vos utilisateurs. Vous recevez son profil, son dénivelé positif et négatif, sa pente, sa surface et sa durée.

Échantillonnage du terrain

Altitude, pente et exposition sur une série de points, ou sur une grille couvrant une emprise rectangulaire.

Isochrones et matrices

Les zones accessibles depuis n'importe quel point, en polygones GeoJSON, et des matrices de temps et de distance entre plusieurs points.

Recherche et géocodage

Le géocodage, et une recherche plein texte sur les lieux, les points d'intérêt, les voies et vos propres itinéraires.

Géocodage inverse

Le lieu nommé le plus proche d'une coordonnée, avec sa distance. De quoi légender toute position affichée dans votre application.

Itinéraires et exports

Lisez un itinéraire par son identifiant, avec ses segments et ses points de passage, puis exportez-le en fichier de parcours via une URL temporaire.

Agents IA et API

Les questions que votre produit pose chaque jour

Posez votre question en langage naturel au Serveur MCP, ou appelez le client typé : c'est toujours la Data API qui répond.

Agent IA

Propose-moi trois boucles de trail au départ de Chamonix, d'environ 14 km avec 600 m de D+.

suggestions200

{ activity: 'HIKING_AND_TRAIL', candidates: 3, distance: 14000, ascent: 600, start: [6.8712, 45.9231] }

3 loops · closest 13.8 km / +615 m

Voici trois boucles au départ de Chamonix, toutes proches de 14 km et de +600 m. La plus fidèle à la demande fait 13,8 km pour 615 m de dénivelé positif. Chaque proposition est fournie avec sa géométrie GeoJSON complète, son profil altimétrique et le détail des surfaces.

Trace-moi l'itinéraire trail le plus rapide entre Chamonix et Argentière, et dis-moi sur quel type de sol on court.

directions200

{ activity: 'HIKING_AND_TRAIL', waypoints: [[6.8712, 45.9231], [6.9271, 45.9822]] }

9.0 km · ~2h40 · asphalt → ground → gravel

Voici un itinéraire trail de 9,0 km qui remonte la vallée jusqu'à Argentière, soit environ 2h40 à pied. Il sort de la ville sur du bitume, puis se poursuit sur terrain naturel et sur un single en gravier. La géométrie GeoJSON complète et le détail des surfaces sont fournis avec.

Analyse la surface et la pente de ce segment avant que j'y envoie des coureurs.

analyzeGeometry200

{ activity: 'HIKING_AND_TRAIL', coordinates: [[6.87126, 45.92307], [6.8713, 45.9231], …] }

+984 m · 19.9° max · asphalt → ground → compacted gravel

Le segment monte de 984 m jusqu'à un point haut de 2 021 m, avec une pente maximale de 19,9° : une longue montée soutenue. Le sol passe du bitume au terrain naturel puis au gravier compacté, et la voie de la rue et de l'allée piétonne, avec des marches, au sentier puis à la piste.

Liste-moi tous les lieux qui commencent par « Col du » autour de Chamonix, avec leurs coordonnées.

search200

{ query: 'Col du', targets: { places: true }, focus: [6.8712, 45.9231], limit: 5 }

5 places · Brévent, Belvédère, Mont Lachat, Passon, Chardonnet

Cinq cols se trouvent près de Chamonix : Col du Brévent [6.844, 45.941], Col du Belvédère [6.876, 45.990], Col du Mont Lachat [6.796, 45.868], Col du Passon [6.983, 45.976] et Col du Chardonnet [7.012, 45.966], à la frontière suisse. Chacun est accompagné de sa référence OSM et de son rattachement administratif.

Trouve le refuge du Goûter et dis-moi lequel est le refuge en service aujourd'hui.

geocode200

{ query: 'Refuge du Goûter', limit: 3 }

3 matches · Goûter Refuge (alpine_hut)

Trois résultats correspondent sur l'arête du Goûter, au-dessus des Houches : le Refuge du Goûter actuel, étiqueté alpine_hut, à [6.831, 45.851], ainsi que le Refuge d'Hiver historique et l'Ancien Refuge du Goûter. Chaque résultat est fourni avec sa référence OSM, sa couche et son rattachement administratif complet.

Quelle zone un coureur peut-il couvrir à pied depuis le ravitaillement de Chamonix en 30, 60 et 120 minutes ?

isochrones200

{ activity: 'HIKING_AND_TRAIL', locations: [[6.8712, 45.9231]], range: [1800, 3600, 7200], rangeType: 'TIME' }

3 polygons · 3.6 / 9.0 / 24.2 km² · reach 0.29 → 0.12

Depuis le ravitaillement, la zone accessible couvre 3,6 km² en 30 minutes, 9,0 km² en une heure et 24,2 km² en deux heures. Chaque zone est renvoyée sous forme de polygone GeoJSON, prête à être superposée au parcours.

Donne-moi le tableau des temps de trajet à pied entre nos quatre ravitaillements, pour le plan logistique.

matrix200

{ activity: 'HIKING_AND_TRAIL', locations: [[6.8712, 45.9231], [6.9271, 45.9822], …], metrics: ['DURATION', 'DISTANCE'] }

4×4 grid · Chamonix → Argentière 9.0 km

Voici le tableau complet. De Chamonix à Argentière, il faut compter 9,0 km à pied. La plus longue liaison du tableau relie Les Houches au Tour, aux deux extrémités de la vallée. Les durées sont en secondes, les distances en mètres, et les paires sans liaison possible sont signalées.

Cas d'usage

Le terrain et la météo réunis sur une seule carte, avec Mountaya.

Jonathan Levy
Jonathan LevyCo-Founder & Managing Director @ Campus Coach

La richesse de l'écosystème cartographique de Mountaya transforme l'expérience sur nos applications mobiles. En intégrant leurs données contextuelles, nous offrons à nos utilisateurs une lecture du terrain indispensable pour anticiper et préparer leurs courses dans les meilleures conditions.

Jonathan Levy

Que doit savoir votre produit sur le terrain ?

Créez un compte et ajoutez un moyen de paiement : vos clés ouvrent la Data API, facturée à la requête. La documentation vous mène jusqu'au premier appel.

Questions fréquentes

La Data API répond aux questions que l'on se pose sur un terrain outdoor : itinéraires, suggestions, altitude, surface, recherche et géocodage, avec la météo bientôt disponible. C'est le moteur sur lequel repose Map Studio, et il est ouvert à votre produit comme à vos agents IA.

Il existe trois façons de s'y connecter, toutes sur le même moteur. Installez les SDK clients typés dans votre propre code, avec GraphQL comme format d'échange. Connectez Claude, Cursor ou tout client MCP au Serveur MCP distant. Ou laissez les Agent Skills open source apprendre à plus de 30 agents de code IA à écrire ce code.

La Data API calcule des itinéraires à pied, sur neige et à vélo de route : trail, course sur route, vélo de route, ski de randonnée, ski de fond et raquette. Elle propose aussi des parcours à partir de vos critères, analyse l'altitude et la surface le long d'un tracé, et fournit isochrones, matrices de temps et de distance, géocodage et points d'intérêt outdoor. La météo passée, en temps réel et prévue sera bientôt disponible. Le gravel et le VTT ne sont pas disponibles.

La Data API est en libre-service et facturée à la requête. Créez un compte et ajoutez une carte bancaire ou un mandat de prélèvement SEPA : chaque mois, vous payez les requêtes effectuées, selon des paliers dégressifs. La page Tarifs détaille chaque tarif.

Oui, sur contrat. Un compte en libre-service fonctionne avec les limites par défaut de 60 requêtes Data API par minute et 300 000 par mois. Un contrat signé peut y ajouter des limites de débit contractuelles et un engagement de disponibilité.