Aller au contenu
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Activer le calcul d'itinéraire sur la carte

La planification d’itinéraires sur carte nécessite un fournisseur de routage. Le routage fonctionne avec votre propre clé : vous fournissez une clé API d’OpenRouteService ou de Mapbox, et Avonni n’héberge aucun backend de routage. Activez-le une fois par package : chaque carte capable de tracer un itinéraire de ce package peut l’utiliser. Si l’organisation exécute plus d’un package Avonni, activez le routage dans l’onglet Paramètres de chaque package.

A map of Chicago with five numbered stops joined by a driving route. The Route panel on the right lists the five stops in order with an arrival time for each stop after the first, and shows the departure and arrival times, the total duration, and the Optimize and Clear actions.
Une fois le routage activé, le panneau Itinéraire transforme les arrêts sélectionnés sur une carte en un itinéraire de conduite. Avec Mapbox, il indique aussi à quel moment chaque arrêt est atteint.

Avant de commencer

Vous avez besoin de :

  • D’un administrateur Salesforce disposant de l’autorisation Personnaliser l’application . 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. Les deux proposent une offre gratuite — voir Choisir un fournisseur.

  • D’un paramètre de site distant pour l’hôte du fournisseur. Les packages n’en fournissent aucun — voir Ajouter un paramètre de site distant.

Ouvrir l’onglet Paramètres

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

La Routage indique l’état actuel Statut et les actions disponibles pour celui-ci.

The Routing card on the Settings tab, with the status Not configured and an Enable routing button at the top right.
Avant l’activation du routage, la carte Routage affiche Non configuré.

Choisir un fournisseur

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

Fournisseur
Obtention d’une clé
Remarques

OpenRouteService

Créez une clé gratuite sur openrouteservice.org avec un compte HeiGIT.

Les limites du plan 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 par 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 pour lequel le panneau d’itinéraire propose une heure de départ ou d’arrivée et signale 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 trie sinon les arrêts par proximité à vol d’oiseau. Les deux fournisseurs limitent un itinéraire à 25 arrêts.

Ajouter un paramètre de site distant

Salesforce bloque tout appel vers un hôte qu’aucun paramètre de site distant n’autorise, et les packages Avonni n’en ajoutent pas pour vous : un administrateur décide quel fournisseur l’organisation peut atteindre.

  1. Dans Configuration, ouvrez Paramètres de site distant et cliquez sur Nouveau site distant.

  2. Saisissez un nom, par exemple Mapbox ou OpenRouteService, et l’URL du fournisseur que vous avez choisi :

    • OpenRouteService — https://api.heigit.org

    • Mapbox — https://api.mapbox.com

  3. Laissez Actif coché et enregistrez.

The Remote Site Setting Edit form in Setup with Remote Site Name mapbox, Remote Site URL https://api.mapbox.com, Disable Protocol Security unchecked, an empty Description and Active checked.
Un paramètre de site distant pour Mapbox : n’importe quel nom, l’URL https://api.mapbox.com et Actif coché.

La Activer le routage la boîte de dialogue indique l’URL du fournisseur que vous sélectionnez, avec un lien vers la page Configuration.

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.

The Enable routing dialog with Mapbox selected as the routing provider, a notice to add a Remote Site Setting for https://api.mapbox.com, an empty Mapbox API key field and the help text on creating a Mapbox access token.
La boîte de dialogue indique le paramètre de site distant requis par le fournisseur choisi. Son bouton Activer le routage reste indisponible jusqu’à ce qu’une clé soit saisie.

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

Si aucun paramètre de site distant n’autorise l’hôte du fournisseur, Salesforce bloque la validation et la raison indique l’URL à ajouter.

L’activation s’exécute côté serveur : le statut passe par Configuration à Connecté. Vous pouvez quitter l’onglet — l’état est enregistré, donc en rouvrant l’onglet, vous le retrouvez tel qu’il est.

L’activation prend quelques secondes avec l’un ou l’autre fournisseur.

Valeurs de statut

The Routing card with the status Connected (Mapbox), the Modify Mapbox API key and Disable buttons, and the Route stop optimization toggle switched on.
Une fois le routage connecté, le nom du fournisseur apparaît à côté du statut. Avec Mapbox, la carte comporte également le commutateur d’optimisation des arrêts de l’itinéraire.
Statut
Ce que cela signifie

Non configuré

Aucun fournisseur n’est configuré. Les cartes n’affichent aucun Itinéraire bouton, et la section Itinéraire du générateur affiche des indications d’activation à la place de son paramètre.

Configuration

La clé est en cours de validation auprès du fournisseur. Temporaire.

Connecté

Le routage est actif. Le nom du fournisseur est affiché à côté du statut.

Vérification de la nouvelle clé

Une clé de remplacement est en cours de validation. L’ancienne clé reste active jusqu’à ce que la nouvelle soit acceptée, de sorte que le routage ne s’interrompt pas pendant une rotation.

Désactivation

La clé stockée est en cours de suppression. Temporaire.

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

Optimisation des arrêts de l’itinéraire

Une fois Mapbox connecté, la Routage carte comporte un commutateur d’optimisation des arrêts de l’itinéraire . Il détermine ce que fait le bouton Optimiser dans le panneau d’itinéraire d’une carte :

  • Activé (par défaut) — Optimize demande à Mapbox l’ordre de conduite le plus rapide, en consommant une requête au fournisseur à chaque fois qu’un utilisateur clique 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’utilisation du fournisseur vous préoccupe ; sinon, laissez-le activé. Le paramètre s’applique à l’échelle de l’organisation et prend effet sur le prochain itinéraire, sans qu’il soit nécessaire de toucher aux cartes elles-mêmes.

Le commutateur apparaît uniquement pour un fournisseur capable d’optimiser. OpenRouteService ne le peut pas, donc les cartes y ordonnent toujours elles-mêmes leurs arrêts.

Qui peut calculer des itinéraires

Le routage ne nécessite aucun ensemble d’autorisations. Une fois le routage activé, tout utilisateur qui peut ouvrir une carte avec Afficher le panneau d’itinéraire activé peut calculer des itinéraires avec la clé de l’organisation, y compris les utilisateurs invités des sites Experience Cloud.

Pour empêcher un groupe d’utilisateurs de calculer des itinéraires, désactivez Afficher le panneau d’itinéraire sur les cartes auxquelles ils peuvent accéder. Chaque itinéraire calculé par un utilisateur est comptabilisé dans votre offre fournisseur.

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.

The Modify Mapbox API key dialog, showing the provider Mapbox, an empty New Mapbox API key field with help on creating a Mapbox access token, and a Save API key button that stays unavailable while the field is empty.
La boîte de dialogue indique le fournisseur actif. Enregistrer la clé API reste indisponible jusqu’à ce qu’une nouvelle clé soit saisie.

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é stockée et arrête le routage pour tout le monde dans l’organisation — les cartes ne calculent plus d’itinéraires jusqu’à ce que le routage soit à nouveau 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 comptabilisée dans les limites de l’offre 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 Configuration. Si une clé est perdue, le fournisseur doit en émettre une nouvelle et vous devez la faire pivoter.

Dépannage

  • L’onglet Paramètres manque dans 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 possède pas Personnaliser l’application. Les paramètres de routage ne sont lisibles et modifiables que par les administrateurs.

  • Le statut reste sur Configuration — l’activation prend quelques secondes. Rechargez l’onglet : l’état est enregistré côté serveur, donc un sondage bloqué ne signifie pas une configuration bloquée. S’il est toujours là après un rechargement, vérifiez la page d’état du fournisseur et réessayez.

  • L’activation signale que Salesforce a bloqué l’appel, ou la carte Routage avertit qu’aucun paramètre de site distant n’autorise le fournisseur — ajoutez un paramètre de site distant pour l’URL du fournisseur, ou réactivez celui qui a été désactivé. Voir Ajouter un paramètre de site distant. Tant qu’il n’est pas en place, chaque itinéraire retombe sur une ligne droite.

Mis à jour

Ce contenu vous a-t-il été utile ?