/Afbeeldingen/Mysolution%20Logo.png?width=150&height=113&name=Mysolution%20Logo.png)
Binnen Mysolution wordt de rijafstand tussen twee adressen berekend, bijvoorbeeld tussen het woonadres van een kandidaat en de projectlocatie. Hiervoor werd tot nu toe gebruikgemaakt van de legacy Google Distance Matrix API. Google introduceert hiervoor een opvolger: de Google Maps Routes API.
Met deze feature voegen we ondersteuning toe voor de nieuwe Routes API, terwijl de bestaande Distance Matrix API beschikbaar blijft. Hiervan heeft Google aangekondigd dat deze komt te vervallen. Klanten bepalen zelf bepalen wanneer zij overstappen, zonder risico op verstoring van bestaande processen.
Voor wie is deze feature interessant?
Deze feature is relevant voor:
-
Organisaties die reisafstanden gebruiken in plaatsingen en Mysolution Workforce-processen
-
Klanten die Google Maps integraties gebruiken binnen MSR en Combi
De voordelen op een rij
-
Behoud van bestaande Distance Matrix API-functionaliteit
-
Ondersteuning voor de nieuwe Google Maps Routes API in de bestaande afstandsbereking
-
Betere foutafhandeling en duidelijke meldingen bij configuratieproblemen
-
Afstandsberekening ook beschikbaar via Flow-acties
Keuze tussen twee Google Maps API’s
Het systeem ondersteunt voortaan twee manieren om rijafstanden te berekenen:
-
Legacy Google Distance Matrix API
-
Nieuwe Google Maps Routes API
Via een instelling kan per organisatie worden bepaald welke API actief is. Hierdoor blijft de huidige werking intact voor klanten die hun Google-configuratie nog niet hebben aangepast.
Technische werking
Bij gebruik van de Routes API:
-
Wordt het ComputeRoutes-endpoint aangeroepen
-
Wordt altijd rijmodus gebruikt
-
Worden afstand en duur opgeslagen in dezelfde Salesforce-velden als voorheen
Daarnaast wordt bij alle Google Maps-aanroepen (zowel legacy als nieuw) voortaan ook straat en postcode meegestuurd, indien beschikbaar. Dit voorkomt onjuiste afstandsberekeningen bij gelijknamige plaatsen of onvolledige adressen.
Afstandsberekening via Flow
De afstandsberekening is nu ook beschikbaar als Flow component Calculate Distance (Routes API) / apex-msf_DistanceCalculatorFromFlow
Input
-
From address (tekst).
-
To address (tekst).
Beide parameters moet een geldige adres, postcode en/of plaats al dan niet in combinatie met een landomschrijving bevatten om de juiste afstand te kunnen bepalen.
Output
-
Distance (enkele reis, in kilometers). De berekening wordt altijd gedaan op basis van het gebruik van een auto.
Alvorens de nieuwe service te gebruiken, dien je een aantal stappen te doorlopen.
- Activeer de Routes API in het Google Cloud Project. Raadpleeg hiervoor de documentatie van Google:
https://developers.google.com/maps/documentation/routes/migrate-routes. - Voeg de beheerde Benoemde Inlogggegeven GoogleRoutes toe aan de relevante Machtigingenset(s) in het onderdeel Hoofdtoegang tot externe referentie. Zonder deze machtiging zullen gebruikers een foutmelding krijgen.
- Stel de API key van de nieuwe service in de beheerde Benoemde Inlogggegevens GoogleRoutes. Ga daarvoor naar Setup, Benoemde inloggegevens. Klik in de sectie Authenticatie op de Externe referentie GoogleRoutes. In de Externe referentie zelf wijzig je bij de sectie Hoofdgebruikers de huidige ApiKey parameter. Je voegt daar een nieuwe parameter toe met de waarde GoogleApiKey. Bij Waarde vul je de API key in die je van Google hebt ontvangen:
- Er is een nieuwe instelling toegevoegd onder Setup, Aangepaste Instellingen, Maps Settings: Gebruik nieuwe Google Maps Routes API. Wanneer deze instelling is ingeschakeld wordt de Routes API gebruikt.
Zonder deze stappen blijft het systeem automatisch de legacy Distance Matrix API gebruiken.