Mapbox

Mapbox est une plateforme de localisation qui fournit des tuiles et des styles de carte, le calcul d’itinéraires (Directions) et le géocodage. Connecter un jeton Mapbox permet à ALIGN d’utiliser ces services en votre nom, à plusieurs endroits du Map Builder.

Ce que cela apporte dans ALIGN

Un jeton Mapbox connecté débloque, partout où vous choisissez de l’utiliser :

Les fonds de carte Mapbox : ajoutez des styles Mapbox comme fonds de carte via Add Data → Basemap ; ils alimentent ensuite le widget Basemap switcher.
Le calcul d’itinéraires : le widget Directions peut utiliser Mapbox Directions (voiture, marche, vélo) au lieu du serveur de démonstration OSRM sans clé.
Le géocodage : le widget Reverse geocode peut convertir des coordonnées en adresses avec Mapbox au lieu de Nominatim, qui ne demande pas de clé.

Chacune de ces options s’active widget par widget ou carte par carte : connecter la clé rend Mapbox disponible, mais vous devez toujours le choisir dans les paramètres du widget concerné.

Comment obtenir la clé

Mapbox utilise des jetons d’accès (access tokens). Il en existe deux types :

Un jeton public (commence par pk.) : utilisé côté client pour afficher des cartes, calculer des itinéraires Directions et géocoder. C’est celui dont ont besoin les widgets ci-dessus.
Un jeton secret (commence par sk.) : réservé aux API Mapbox au niveau du compte ; facultatif pour ALIGN.

Connectez-vous à la page des jetons d’accès Mapbox.
Copiez votre jeton public par défaut (pk.…), ou créez-en un nouveau limité à ce dont vous avez besoin.
Pour un jeton utilisé sur des cartes publiées, ajoutez des restrictions d’URL dans Mapbox, pour qu’il ne fonctionne que depuis vos domaines.
Dans ALIGN, allez dans Dashboard → Integrations et collez le jeton pour Mapbox. Vous pouvez enregistrer le jeton public, ainsi que le jeton secret si vous en avez l’usage.

Où va votre jeton

Le jeton Mapbox est stocké sur votre compte ALIGN, et la carte stockée dans votre Datastore ne le porte jamais. Une carte publiée porte votre jeton public (pk.), parce que le navigateur du visiteur charge lui-même les tuiles ; restreignez-le par URL dans votre compte Mapbox, et ALIGN vous indique le domaine à autoriser au moment de publier. Un jeton secret (sk.) ne quitte jamais nos serveurs et n’est jamais publié. Là où un widget propose une alternative sans clé (OSRM pour Directions, Nominatim pour Reverse geocode), il continue de fonctionner sans aucune clé.

Pages liées

Add Data → Basemap et le widget Basemap switcher : les fonds de carte Mapbox.
Widget Directions : le calcul d’itinéraires Mapbox.
Widget Reverse geocode : le géocodage Mapbox.
Vue d’ensemble des intégrations : comment ALIGN protège vos clés.