Communicatieprofiel Google Maps API inrichten

Vanaf Profit 6 worden afstandsberekeningen voor kilometerdeclaraties, onboarden, adreswijzigingen en werklocaties uitgevoerd via de Google Routes Api (in combinatie met enkele andere api's).

We adviseren je om over te stappen op de Google Routes Api in combinatie met het nieuwe Communicatieprofiel Google Maps API. Hiervoor zijn twee redenen. Ten eerste, de ondersteuning van de Directions API door Google zal worden beëindigd. Ten tweede, we hebben geconstateerd dat de Directions API niet altijd de juiste afstand berekende, vooral omdat deze api rekening houdt met variatie in verkeersomstandigheden. Dit kon leiden tot grote verschillen afhankelijk van het moment waarop de declaratie werd ingediend. De Google Maps Routes API biedt een verbeterde en meer consistente manier om routes te berekenen. Voor meer informatie, zie Is de Google Maps/ Route afstandsberekening gebaseerd op de kortste of snelste route?

Let op:

De Google Maps Routes API en het communicatieprofiel gelden voor de bovenstaande functionaliteiten, maar niet voor de afstandsberekening in AFAS Pocket. Voor Pocket kun je dezelfde api key of een andere api gebruiken waarin de Directions api geactiveerd is. zie verder: Basisinrichting AFAS Pocket.

API aanmaken in Google Cloud Console

Lees eerst de algemene informatie over de facturering/billing en de uitwisseling van gegevens. Dan richt je de api in en verkrijg je een api key.

Facturering / billing

Je moet altijd een billing inrichten, ook als je begint met een gratis proefperiode. Na de gratis proefperiode moet je de billing account nog 'upgraden' ofwel 'activeren'. Doe je dit niet, dan functioneert de Google Route plug-in na de proefperiode niet meer tot je de 'upgrade' ofwel 'activering' van de billing account voltooid hebt.

Zie voor meer informatie: https://cloud.google.com/free/docs/gcp-free-tier#how-to-upgrade

Schakel ‘facturering’ (billing) in in de Google-account waaronder de api key is aangevraagd. Daarbij is het opvoeren van een creditcard noodzakelijk. Je kunt direct controleren of je al een creditcard gekoppeld hebt aan de Google-account via https://console.cloud.google.com/billing.

Na het koppelen van een creditcard krijg je een maandelijks terugkerend 'credit' voor een groot aantal requests. Je gaat pas betalen als het krediet op is. Bekijk Pricing for Maps, Routes and Places voor meer informatie over het aantal requests dat je standaard per maand krijgt.

De demo's van AFAS bevatten een API-key, maar deze mag niet worden gebruikt. Als je deze toch gebruikt, dan wordt het maximum aantal calls snel bereikt en dan werkt de koppeling niet meer.

Welke gegevens wisselt Profit uit met Google:

Bij gebruik van Google Maps voor de afstandsberekening wisselt Profit de volgende gegevens uit:

• Api key
• Adressen Van en Naar die de gebruiker heeft ingevuld (er worden geen persoongegevens uitgewisseld).
• Enkele technische instellingen voor het bepalen van de route.

Op de pagina Privacybeleid van Google zie je hoe Google deze gegevens gebruikt.

Api inrichten:

1. Ga naar de site https://console.cloud.google.com/cloud-resource-manager.
2. Log in op de website van Google.
3. Voeg een project toe, dit is nodig voor het beheer en de facturering. Als je al een project hebt, dan hoef je dit (waarschijnlijk) niet te doen.
4. Gebruik de zoekfunctie en klik op API's en services.

   

5. Klik op: 'Enable API'S and services' (API'S en services inschakelen).
6. Bovenaan moet het juiste project geselecteerd zijn.

   

7. Zoek en Enable de volgende API's:
   • Google Maps Routes API
   • Google Maps Static API
   • Google Maps Geocoding API
   • Google Maps Javascript API
   • Google Maps Geolocation API
8. Ga naar het onderdeel Inloggegevens (Credentials).
9. Klik op: Inloggegevens maken.
10. Klik op: Credentials.

    

11. Klik op: 'API Key'.
12. De API-sleutel verschijnt in een apart venster, kopieer deze naar het Klembord.
13. Keer terug naar Profit.

Google Route werkt niet:

Check eerst of de onderstaande punten correct zijn uitgevoerd:

• Heb je alle benodigde API's (inclusief Google Static Maps API) gekoppeld aan de API key / het project?
• Heb je Billing / Facturering ingeschakeld?

Werkt de plug-in Google Route (afstandsberekening) nog niet? Kies dan in de console voor Regenerate Key en koppel deze nieuwe API key in het communicatieprofiel..

Communicatieprofiel inrichten en testen

Communicatieprofiel inrichten:

1. Ga naar: Algemeen / Communicatieservice / Communicatieprofiel.
2. Open de eigenschappen van het communicatieprofiel Google Maps API.
3. Vink Geblokkeerd uit.
4. Ga naar het tabblad: Instellingen. Vul de 'Google Maps API Key' wanneer deze nog niet gevuld is. Zorg ervoor dat je de API hebt geactiveerd in Google Cloud Console.

   Als je al een api key had, zal Profit deze standaard vullen. Bij meerdere api keys in de omgeving zal Profit de meestgebruikte api key nemen. Controleer of de juiste api key gevuld is.

5. Onder Voorkeur routeberekening selecteer je of de routeberekening op basis van 'Snelste' of 'Kortste' route berekend moet worden.
6. Klik op: Opslaan en sluiten.

Communicatieprofiel testen:

Na het activeren van de API en het inrichten van het communicatieprofiel, kan je het communicatieprofiel testen. Door het communicatieprofiel te testen, weet je of je het juist hebt ingericht of dat er nog acties nodig zijn.

1. Ga naar: Algemeen / Communicatieservice / Communicatieprofiel.
2. Open de eigenschappen van het communicatieprofiel Google Maps API.
3. Klik op: Acties / Google Maps test.

   Als je alles goed hebt ingericht, krijg je onderstaande melding. Maar geen zorgen als er nog iets niet klopt, we laten het je in de melding dan direct weten zodat je ermee aan de slag kunt!

   

Vervolginrichting per onderdeel

Je gebruikt het communicatieprofiel Google Maps API voor de volgende onderdelen:

• Berekening woon-werk afstand bij het registreren van het adres via aanvullende gegevens van de medewerker (Onboarden)

  Altijd op basis van het gedeblokkeerde communicatieprofiel.

  Vink in de profielen Aanmaken aanvullen gegevens en Aanmaken Onboarden het veld Afstandsberekening toepassen aan. Bij het registreren van de aanvullende gegevens wordt nu de afstandsberekening toegepast. Dit is de afstandsberekening van het woonadres van de sollicitant naar het adres dat is vastgelegd bij het onboarden. Als dit veld leeg is dan gebruikt Profit het adres van de werkgever. Als de werklocaties gebruikt, dan gebruikt Profit het adres van de werklocatie voor 'naar' in plaats van het adres van de werkgever.

• Werklocaties (nieuw in Profit 6)

  Altijd op basis van het gedeblokkeerde communicatieprofiel.

• Adreswijziging medewerker

  Als je het communicatieprofiel gedeblokkeerd hebt, dan wordt dit toegepast. Als het communicatieprofiel nog geblokkeerd is, dan gebruikt Profit de api key die gekoppeld is in de eigenschappen van de site (met de oude Directions api).

• Kilometerdeclaratie medewerker

  Als je het communicatieprofiel gedeblokkeerd hebt, dan wordt dit toegepast. Als het communicatieprofiel nog geblokkeerd is, dan gebruikt Profit de api key die gekoppeld is in de eigenschappen van de site (met de oude Directions api).