Entfernungsberechnung über Flow und neue Google Maps Routes API

In Mysolution wird die Fahrstrecke zwischen zwei Adressen berechnet, beispielsweise zwischen der Wohnadresse eines Kandidaten und dem Einsatzort. Bisher wurde hierfür die Legacy Google Distance Matrix API verwendet. Google führt hierfür einen Nachfolger ein: die Google Maps Routes API.

Mit dieser Funktion unterstützen wir nun die neue Routes API, während die bestehende Distance Matrix API weiterhin verfügbar bleibt. Google hat angekündigt, dass die Legacy-API eingestellt wird. Kunden können selbst entscheiden, wann sie umsteigen, ohne das Risiko, bestehende Prozesse zu stören.

Für wen ist dieses Feature interessant?

Dieses Feature ist relevant für:

Organisationen, die Fahrstrecken in Platzierungen und Mysolution Workforce-Prozessen verwenden
Kunden, die Google Maps Integrationen innerhalb von MSR und Combi nutzen

Die Vorteile auf einen Blick

Beibehaltung der bestehenden Distance Matrix API-Funktionalität
Unterstützung der neuen Google Maps Routes API in der bestehenden Entfernungsberechnung
Verbesserte Fehlerbehandlung und klare Meldungen bei Konfigurationsproblemen
Entfernungsberechnung auch über Flow-Aktionen verfügbar

Feature-Erklärung

Auswahl zwischen zwei Google Maps APIs

Das System unterstützt nun zwei Methoden zur Berechnung von Fahrstrecken:

Legacy Google Distance Matrix API
Neue Google Maps Routes API

Über eine Einstellung kann pro Organisation festgelegt werden, welche API aktiv ist. Dadurch bleibt die aktuelle Funktionalität für Kunden erhalten, die ihre Google-Konfiguration noch nicht angepasst haben.

Technische Funktionsweise

Bei Verwendung der Routes API:

Wird das ComputeRoutes-Endpoint aufgerufen
Es wird immer der Fahrmodus verwendet
Entfernung und Dauer werden in denselben Salesforce-Feldern wie bisher gespeichert

Zusätzlich werden bei allen Google Maps-Aufrufen (sowohl Legacy als auch neu) nun auch Straße und Postleitzahl mitgesendet, sofern verfügbar. Dies verhindert falsche Entfernungsberechnungen bei gleichnamigen Orten oder unvollständigen Adressen.

Entfernungsberechnung über Flow

Die Entfernungsberechnung ist nun auch als Flow-Komponente verfügbar:
Calculate Distance (Routes API) / apex-msf_DistanceCalculatorFromFlow

Input

From address (Text)
To address (Text)

Beide Parameter müssen eine gültige Adresse, Postleitzahl und/oder Ort enthalten, optional kombiniert mit einer Länderangabe, um die korrekte Entfernung zu berechnen.

Output

Distance (einfache Strecke, in Kilometern). Die Berechnung erfolgt immer auf Basis der Autofahrt.

Konfiguration / Implementierungszeit

Vor der Nutzung des neuen Services müssen folgende Schritte durchgeführt werden:

Aktivieren Sie die Routes API im Google Cloud Project. Siehe Google-Dokumentation: https://developers.google.com/maps/documentation/routes/migrate-routes
Fügen Sie die verwaltete Named Credential GoogleRoutes den relevanten Berechtigungssätzen im Bereich External Credential Principal Access hinzu. Ohne diese Berechtigung erhalten Benutzer eine Fehlermeldung
Hinterlegen Sie den API-Schlüssel des neuen Services in der verwalteten Named Credential GoogleRoutes. Gehen Sie zu Setup, Named Credentials. Klicken Sie im Abschnitt Authentication auf die External Credential GoogleRoutes. Ändern Sie dort im Abschnitt Principals den bestehenden ApiKey-Parameter und fügen Sie einen neuen Parameter mit dem Wert GoogleApiKey hinzu. Tragen Sie unter Value den von Google erhaltenen API-Schlüssel ein:
Unter Setup, Custom Settings, Maps Settings wurde eine neue Einstellung hinzugefügt: Use new Google Maps Routes API. Wenn diese aktiviert ist, wird die Routes API verwendet.

Ohne diese Schritte verwendet das System weiterhin automatisch die Legacy Distance Matrix API.

Weitere Features in die 2026-02 Release

🔗 Hier finden Sie alle Features dieser Release