Calcul de distance via Flow et nouvelle Google Maps Routes API

Dans Mysolution, la distance de trajet entre deux adresses est calculée, par exemple entre l’adresse du domicile d’un candidat et le lieu du projet. Jusqu’à présent, cela était réalisé via l’ancienne Google Distance Matrix API. Google introduit un successeur : la Google Maps Routes API.

Avec cette fonctionnalité, nous ajoutons la prise en charge de la nouvelle Routes API, tout en conservant la Distance Matrix API existante. Google a annoncé la suppression progressive de cette dernière. Les clients peuvent choisir eux-mêmes quand migrer, sans risque de perturber les processus existants.

Pour qui cette fonctionnalité est-elle intéressante ?

Cette fonctionnalité est pertinente pour :

Les organisations utilisant les distances de trajet dans les placements et les processus Mysolution Workforce
Les clients utilisant des intégrations Google Maps dans MSR et Combi

Les avantages en un coup d’œil

Maintien de la fonctionnalité existante de la Distance Matrix API
Prise en charge de la nouvelle Google Maps Routes API dans le calcul des distances
Amélioration de la gestion des erreurs et messages clairs en cas de problème de configuration
Calcul de distance également disponible via des actions Flow

Explication de la fonctionnalité

Choix entre deux API Google Maps

Le système prend désormais en charge deux méthodes de calcul des distances :

Legacy Google Distance Matrix API
Nouvelle Google Maps Routes API

Un paramètre permet de définir, par organisation, quelle API est active. Cela garantit la continuité du fonctionnement pour les clients qui n’ont pas encore adapté leur configuration Google.

Fonctionnement technique

Lors de l’utilisation de la Routes API :

L’endpoint ComputeRoutes est appelé
Le mode de transport utilisé est toujours la voiture
La distance et la durée sont enregistrées dans les mêmes champs Salesforce qu’auparavant

De plus, pour tous les appels Google Maps (anciens et nouveaux), la rue et le code postal sont désormais également transmis lorsqu’ils sont disponibles. Cela évite des calculs incorrects pour des localités portant le même nom ou des adresses incomplètes.

Calcul de distance via Flow

Le calcul de distance est désormais disponible en tant que composant Flow :
Calculate Distance (Routes API) / apex-msf_DistanceCalculatorFromFlow

Input

From address (texte)
To address (texte)

Les deux paramètres doivent contenir une adresse valide, un code postal et/ou une ville, éventuellement combinés avec un pays, afin de calculer correctement la distance.

Output

Distance (aller simple, en kilomètres). Le calcul est toujours basé sur un trajet en voiture.

Configuration / Temps d’implémentation

Avant d’utiliser le nouveau service, plusieurs étapes doivent être réalisées :

Activer la Routes API dans le Google Cloud Project. Consultez la documentation Google : https://developers.google.com/maps/documentation/routes/migrate-routes
Ajouter la Named Credential gérée GoogleRoutes aux Permission Sets concernés dans la section External Credential Principal Access. Sans cette autorisation, les utilisateurs recevront une erreur
Configurer la clé API du nouveau service dans la Named Credential gérée GoogleRoutes. Accédez à Setup, Named Credentials. Dans la section Authentication, cliquez sur External Credential GoogleRoutes. Modifiez le paramètre ApiKey existant dans la section Principals et ajoutez un nouveau paramètre avec la valeur GoogleApiKey. Renseignez la clé API fournie par Google :
Un nouveau paramètre a été ajouté sous Setup, Custom Settings, Maps Settings : Use new Google Maps Routes API. Lorsque ce paramètre est activé, la Routes API est utilisée.
Sans ces étapes, le système continuera automatiquement à utiliser la Distance Matrix API existante.

Autres fonctionnalités de la version 2026-02

🔗 Vous trouverez ici un aperçu des autres fonctionnalités de cette version.