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é.

[Contacter notre équipe](/fr/contact/)

[Lire la documentation](https://docs.mountaya.com/en)

Compatible avec les outils que vous utilisez déjà

Apple Health

Autres clients MCP

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.

![Carte hivernale du parcours de la Patrouille des Glaciers, de Zermatt à Verbier.](/images/elements/itinerary-map-dark.webp)

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.

### 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.

TypeScript

React

Swift

Kotlin

Flutter

TypeScript

1

### 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.0
```

2

### S'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.
```

3

### 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
});
```

4

### 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 underneath
```

Dé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.

[Contacter notre équipe](/fr/contact/)

[Lire la documentation](https://docs.mountaya.com/en)

Questions fréquentes

En quoi consistent les SDK et Elements ?

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.

Quels langages et frameworks sont pris en charge ?

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.

Faut-il une carte sur la page pour utiliser les composants ?

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.

Dois-je fournir mon propre moteur de rendu ?

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.

Comment gérez-vous les changements non rétrocompatibles ?

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é.
