SDK et Elements
Des composants de carte outdoor prêts à intégrer
Les SDK et Elements réunissent des clients typés pour chaque API Mountaya et des composants qui affichent la carte, le profil altimétrique et le tableau des segments. Les paquets TypeScript et React s'installent dès aujourd'hui, tandis que Swift, Kotlin et Flutter sont en accès anticipé.
Compatible avec les outils que vous utilisez déjà
Carte, profil et tableau
Un même parcours sur la carte, le profil et le tableau
La carte, le composant de profil altimétrique et le composant de tableau des segments affichent le même parcours et se répondent. L'exemple présenté ici est la Patrouille des Glaciers, de Zermatt à Verbier.

Tableau des segments de la Patrouille des Glaciers : une ligne par segment, de Zermatt à Verbier, avec sa distance, ses dénivelés positif et négatif et ses altitudes minimale et maximale.
- Distance
- 55,9 km
- Dénivelé positif
- 4 235 m
- Dénivelé négatif
- 4 365 m
- Point culminant
- 3 643 m
Le profil est relié à la carte
Lorsque vous parcourez le profil, une fiche indique la distance, l'altitude et le dénivelé cumulé à l'endroit survolé, et un repère se déplace sur la carte.
Chaque lieu au bon kilomètre
Les points de passage du parcours sont épinglés sur le profil, à la distance où ils se trouvent, et chaque segment est résumé en dessous.
Chaque ligne a son segment
Le survol d'une ligne du tableau met en évidence le segment correspondant sur la carte, et le survol du parcours sur la carte met en évidence sa ligne.
Les mêmes chiffres partout
La distance et le dénivelé de chaque segment sont calculés une seule fois, sur nos serveurs, à partir de la trace complète. Le tableau, le profil et la carte affichent donc exactement les mêmes valeurs.
Intégration
Votre première carte en quatre étapes
Installez les paquets, émettez un jeton de session depuis votre serveur, appelez l'API, puis affichez le résultat. Le code présenté est celui du SDK TypeScript, tel qu'il est publié aujourd'hui.
Installer
MapLibre s'installe à côté des composants, dans la version exacte sur laquelle leur worker de carte est construit.
npm install @mountaya/client @mountaya/elements maplibre-gl@6.18.0S'authentifier
Une clé publiable peut figurer sans risque dans un navigateur et suffit pour afficher la carte. La Data API exige en plus, à chaque requête, un jeton de session émis par votre serveur à partir de votre clé secrète.
// On your server, and only there: a secret key can never reach a browser.
import { Mountaya } from "@mountaya/client";
const secretKey = process.env.MOUNTAYA_SECRET_KEY;
if (secretKey === undefined) {
throw new Error("MOUNTAYA_SECRET_KEY is not set.");
}
const client = new Mountaya({ credential: { secretKey } });
const { data } = await client.admin.sessions.postSession({
body: { publishable_key: "pk_…" },
});
// Return data.token and data.expires_at to the browser. The token is short-lived.Appeler
Chaque opération correspond à une méthode typée. La Data API repose sur GraphQL, mais c'est le client qui rédige la requête à votre place.
import { Mountaya } from "@mountaya/client";
const client = new Mountaya({
credential: { publishableKey: "pk_…", sessionToken },
});
const route = await client.data.directions({
activity: "HIKING_AND_TRAIL",
waypoints: [[6.8712, 45.9231], [6.9271, 45.9822]], // Chamonix to Argentière
});Afficher
Transmettez le client à la carte : elle signe ensuite elle-même ses requêtes de tuiles.
import { Mountaya } from "@mountaya/client";
import { MountayaMap } from "@mountaya/elements";
import "@mountaya/elements/styles.css";
const client = new Mountaya({ credential: { publishableKey: "pk_…" } });
const map = new MountayaMap({
container: "map",
client,
center: [6.86, 45.83],
zoom: 12,
});
// All three return a promise: they fetch a specification through the client.
await map.setItinerary(itineraryId);
await map.setOverlay("aspectslope"); // exclusive: replaces the previous overlay
await map.addEnrichment("hillshade"); // additive: stacks underneathDétails techniques
Les détails que les paquets règlent pour vous
Le typage, les clés et les requêtes vivent dans les paquets. Aucun appel ne les répète.
Des types et des dates natifs
Les horodatages sont renvoyés sous forme d'objets Date. Tous les types de ressources, de paramètres et d'énumérations sont générés à partir du schéma et exportés à la racine du paquet.
Clés sûres côté navigateur
Les clés publiables vont dans le navigateur, les clés secrètes restent sur votre serveur. Comme le point d'entrée navigateur ne prévoit aucun champ pour une clé secrète, l'erreur est bloquée dès la compilation.
Aucune requête à écrire
La Data API repose sur GraphQL. Chaque opération est une méthode typée qui envoie une sélection générée pour vous, si bien que le résultat revient complet et typé.
Aucun framework imposé
MountayaMap est une simple classe de @mountaya/elements. Que vous utilisiez Vue, Svelte, Angular ou aucun framework, la carte affichée est la même.
Qu'allez-vous construire avec les SDK et Elements ?
Expliquez-nous ce que votre produit doit afficher. Nous vous montrerons les SDK et Elements qui s'en chargent.
Questions fréquentes
Ce sont des bibliothèques à installer pour développer avec Mountaya. Les clients typés appellent l'API de Map Studio, la Data API et la Tile API. Les composants affichent le résultat : la carte avec son moteur de rendu, le profil altimétrique et le tableau des segments. Ils sont source-available, sous la Mountaya SDK License. Vous pouvez lire chaque ligne que vous mettez en production.
TypeScript et React sont disponibles dès aujourd'hui, pour les clients comme pour les composants. Swift, Kotlin et Flutter sont en accès anticipé : leurs modules sont spécifiés et générés à partir du même schéma, mais il n'y a encore rien à installer. Des clients Go, Python, Java, Ruby et PHP sont prévus.
Non. Le profil altimétrique et le tableau des segments s'affichent de façon autonome, dans un tableau de bord, une barre latérale ou un rapport. Si vous placez une carte à côté, ils la pilotent : au survol du profil, un repère se déplace le long du parcours.
Vous installez MapLibre à côté des composants, dans la version exacte sur laquelle leur worker de carte est construit. Les composants initialisent le moteur de rendu et signent ses requêtes, et votre application n'en contient qu'un seul exemplaire. Vous n'avez à créer l'instance de carte vous-même que si vous tenez à fournir la vôtre.
Avant la version 1.0, une version mineure peut renommer ou retirer une opération, et les notes de version nomment chaque changement. À partir de la 1.0, un identifiant d'opération publié ne change plus, car il sert de nom de méthode dans chaque langage, et en retirer un passe par une dépréciation d'au moins 180 jours et deux versions mineures. Le client indique le tag du schéma à partir duquel il a été généré.