Configuration du routage

La planification d’itinéraire sur la carte nécessite un fournisseur de routage. Le routage fonctionne en mode bring-your-own-key : vous fournissez une clé API d’OpenRouteService ou de Mapbox, et Avonni n’héberge aucun backend de routage. Activez-le une seule fois par organisation, et chaque carte capable d’effectuer des itinéraires dans l’organisation peut l’utiliser.

Avant de commencer

Vous avez besoin :

• d’un administrateur Salesforce disposant de la Personnaliser l’application autorisation. Seul un tel utilisateur peut ouvrir les paramètres de routage ou les modifier.
• d’une clé API d’un des deux fournisseurs pris en charge. Tous deux proposent une offre gratuite — voir Choisir un fournisseur.

Ouvrir l’onglet Paramètres

Depuis le lanceur d’applications, ouvrez l’ Avonni Experiences application et sélectionnez l’ onglet Paramètres.

La Routage carte affiche l’ Statut actuel et les actions disponibles.

Choisir un fournisseur

Un seul fournisseur peut être actif à la fois. L’activation de l’un désactive l’autre.

Fournisseur	Obtention d’une clé	Remarques
OpenRouteService	Créez une clé gratuite sur openrouteservice.org avec un compte HeiGIT.	Les limites du forfait standard s’appliquent — environ 2 000 itinéraires par jour. Collez la clé exactement telle qu’elle a été fournie ; n’ajoutez pas de préfixe Bearer .
Mapbox	Créez un jeton d’accès sur console.mapbox.com.	Un jeton public (commençant pk.) suffit — les API Directions et Optimization n’ont besoin d’aucune portée supplémentaire. Laissez les restrictions d’URL vides, car les appels côté serveur n’envoient aucun référent.

Mapbox est le seul fournisseur qui modélise le trafic ; c’est donc le seul où le panneau d’itinéraire propose une heure de départ ou d’arrivée et indique les heures d’arrivée pour chaque arrêt. C’est aussi le seul fournisseur qui peut déterminer l’ordre des arrêts d’un itinéraire : Optimiser demande à Mapbox l’ordre de conduite le plus rapide pour des itinéraires allant jusqu’à douze arrêts, et ordonne autrement les arrêts selon leur proximité à vol d’oiseau. Les deux fournisseurs limitent un itinéraire à 25 arrêts.

Activer le routage

1. Sur la Routage carte, cliquez sur Activer le routage.
2. Choisissez le fournisseur de routage.
3. Collez la clé API et cliquez sur Activer le routage.

La clé est validée auprès du fournisseur avant l’enregistrement de quoi que ce soit. Une clé rejetée par le fournisseur n’est jamais enregistrée.

L’activation s’exécute côté serveur : l’état passe de Configuration à Connecté. Vous pouvez quitter l’onglet — l’état est enregistré, donc si vous le rouvriez, il reprendrait là où il en était.

La durée dépend du fournisseur. Mapbox se connecte en quelques secondes. OpenRouteService prend généralement deux à trois minutes, car son identifiant est déployé dans l’organisation sous forme de métadonnée et la configuration attend la fin de ce déploiement avant de valider la clé. Un statut restant sur Configuration pendant quelques minutes est le comportement normal pour OpenRouteService, pas le signe d’un blocage — voir Dépannage s’il y reste beaucoup plus longtemps.

Valeurs du statut

Statut	Ce que cela signifie
Non configuré	Aucun fournisseur n’est configuré. Les cartes n’affichent aucun bouton Itinéraire et la section Itinéraire du générateur affiche des instructions d’activation à la place de son paramètre.
Configuration	La clé est en cours de validation et l’identifiant est en cours de configuration. Temporaire.
Connecté	Le routage est actif. Le nom du fournisseur est affiché à côté du statut.
Nouvelle clé en cours de vérification	Une clé de remplacement est en cours de validation. L’ancienne clé reste active jusqu’à ce que la nouvelle soit acceptée, afin que le routage ne soit pas interrompu pendant une rotation.
Désactivation en cours	L’identifiant est en cours de suppression. Temporaire.

Lorsqu’une clé est rejetée, le statut revient à Non configuré et la raison fournie par le fournisseur est affichée en dessous. Rien n’est enregistré, donc l’état précédent reste inchangé.

Optimisation des arrêts de route

Une fois Mapbox connecté, la Routage carte comporte un interrupteur d’optimisation des arrêts de route qui contrôle ce que fait le Optimiser bouton dans le panneau d’itinéraire d’une carte :

• Activé (par défaut) — Optimiser demande à Mapbox l’ordre de conduite le plus rapide, en consommant une requête fournisseur à chaque fois qu’un utilisateur appuie dessus.
• Désactivé — les cartes ordonnent elles-mêmes les arrêts sans frais. L’ordre ignore les routes, les ponts et le trafic, donc l’itinéraire est généralement plus long.

Désactivez-le si l’usage du fournisseur est un sujet de préoccupation ; sinon, laissez-le activé. Le paramètre s’applique à toute l’organisation et prend effet au prochain itinéraire, sans qu’il soit nécessaire de modifier les cartes elles-mêmes.

L’interrupteur n’apparaît que pour un fournisseur capable d’optimiser. OpenRouteService ne le peut pas, donc les cartes y ordonnent toujours leurs propres arrêts.

Accorder l’accès aux utilisateurs

L’activation du routage crée un ensemble d’autorisations pour le fournisseur actif :

• Accès Avonni Route ORS — pour OpenRouteService
• Accès Avonni Route Mapbox — pour Mapbox

Attribuez-le à toutes les personnes qui doivent calculer des itinéraires sur une carte. Les utilisateurs qui ne l’ont pas peuvent ouvrir le panneau d’itinéraire, mais Calculer l’itinéraire échoue.

Ces ensembles d’autorisations sont créés lorsque le routage est activé, et non fournis avec le package. Ils n’apparaîtront pas dans la liste des ensembles d’autorisations d’une nouvelle installation ; cherchez-les donc après activation plutôt qu’avant.

Faire pivoter une clé

Cliquez sur Modifier la clé API OpenRouteService (ou Modifier la clé API Mapbox, selon le fournisseur actif) sur la Routage carte, collez la nouvelle clé et cliquez sur Enregistrer la clé API. La nouvelle clé est validée avant de remplacer l’ancienne ; si elle échoue, la clé existante continue de fonctionner.

Faites pivoter une clé chaque fois que le fournisseur la réémet, ou lorsque la clé précédente a pu être exposée.

Désactiver le routage

Cliquez sur Désactiver et confirmez. Cela supprime la clé enregistrée, retire l’ensemble d’autorisations du fournisseur et arrête le routage pour tout le monde dans l’organisation — les cartes ne calculent plus d’itinéraires tant que le routage n’est pas réactivé avec une clé.

Confidentialité et utilisation

Lorsque le routage est activé, le calcul d’un itinéraire envoie les coordonnées des arrêts au fournisseur que vous avez choisi, authentifié avec votre propre clé API. L’utilisation est décomptée sur les limites de forfait de ce fournisseur, et ses conditions régissent la requête.

La clé stockée est en écriture seule. Une fois enregistrée, elle ne peut pas être relue — ni depuis cet onglet, ni depuis la configuration. Si une clé est perdue, faites-en émettre une nouvelle par le fournisseur et faites une rotation.

Dépannage

• L’onglet Paramètres est absent de l’application — l’onglet est visible via l’ensemble d’autorisations d’administration du package. Attribuez cet ensemble d’autorisations à l’utilisateur, ou rendez l’onglet visible sur son profil.
• L’ouverture de l’onglet indique que seul un administrateur peut modifier les paramètres de routage — l’utilisateur ne dispose pas de Personnaliser l’application. Les paramètres de routage ne peuvent être lus et modifiés que par les administrateurs.
• L’activation échoue avec une erreur Metadata API mentionnant les sessions Lightning — la configuration initiale de l’identifiant n’a pas pu s’exécuter depuis la session du navigateur. Demandez à un administrateur disposant d’un accès CLI ou API de créer l’identifiant une fois, puis revenez ici pour enregistrer la clé.
• Le statut reste sur Configuration — accordez deux à trois minutes à OpenRouteService ; c’est le temps nécessaire au déploiement de son identifiant. Au-delà, rechargez l’onglet : l’état est stocké côté serveur, donc une interrogation bloquée n’est pas une configuration bloquée. Si c’est toujours le cas après un rechargement, consultez la page d’état du fournisseur et réessayez.
• Les itinéraires fonctionnent pour les administrateurs mais pas pour les autres utilisateurs — ces utilisateurs ne disposent pas de l’ensemble d’autorisations du fournisseur actif (voir Accorder l’accès aux utilisateurs).