Google Maps instellingen
Dagboek maakt gebruik van Google Maps voor het zoeken van locaties en het berekenen van reisafstanden bij reisdeclaraties. Dit artikel beschrijft hoe de integratie werkt, welke instellingen beschikbaar zijn en hoe de afstandsberekening tot stand komt.
De Google Maps instellingen zijn te vinden via Beheer > Google Maps.
Hoe de integratie werkt
Dagboek maakt gebruik van twee Google API's voor reisdeclaraties:
Google Places (New) - voor het zoeken van bestemmingen door medewerkers
Google Routes - voor het berekenen van de reisafstand en het tonen van de route op de kaart
Elke organisatie gebruikt een eigen Google API key. De maandelijkse kosten blijven in de meeste gevallen binnen het gratis tegoed van 200 euro per maand dat Google biedt.
Bij gebruik van Google Maps worden de volgende gegevens uitgewisseld met Google:
De API key
Adressen die de gebruiker heeft ingevuld (er worden geen persoonsgegevens uitgewisseld)
Enkele technische instellingen voor het bepalen van de route
Zie het privacybeleid van Google voor meer informatie over hoe Google deze gegevens gebruikt.
Instellingen in Dagboek
In Dagboek zijn de volgende instellingen beschikbaar:
Google API key De API key waarmee Dagboek verbinding maakt met Google. Na het invoeren kun je via de knop "Valideer API-instellingen" controleren of de sleutel correct is geconfigureerd.
API-variant Dagboek ondersteunt twee API-varianten voor de afstandsberekening. Gebruik altijd de Routes API, dit is de huidige standaard. De oude Directions API wordt door Google steeds minder goed ondersteund en kan leiden tot fouten bij het indienen van reisdeclaraties.
Landen Hier stel je in in welke landen Google zoekt bij het opzoeken van locaties. Wil je dat medewerkers alleen locaties in Nederland kunnen opzoeken, voeg dan alleen Nederland toe.
Overstappen naar de Routes API
Maakt jouw organisatie nog gebruik van de oude Directions API? Schakel dan zo snel mogelijk over naar de Routes API. Google herkent steeds meer adressen niet correct via de oude API, wat kan leiden tot fouten bij reisdeclaraties.
Controleer in Dagboek via Beheer > Integratie > Google Maps of de volgende API's zijn ingeschakeld in de Google Cloud Console:
Routes API
Places API (New)
Selecteer vervolgens als API-variant "Routes" en klik op opslaan. Gebruik de knop "Valideer API-instellingen" om te controleren of alles correct is geconfigureerd.
Lukt het niet zelfstandig? Neem contact op met CoreCubes voor een korte afstemming. Zorg er dan voor dat er iemand aanwezig is met toegang tot console.cloud.google.com en de bijbehorende API-sleutels.
Hoe werkt de afstandsberekening?
Dagboek berekent de reisafstand via de Google Routes API op basis van de snelste route in tijd tussen twee adressen. Bij de berekening wordt geen rekening gehouden met actuele verkeersdrukte, maar met tijdonafhankelijke verkeersomstandigheden op basis van historische gegevens.
Dit betekent dat de uitkomst van de berekening in Dagboek kan afwijken van wat Google Maps in de browser toont. Google Maps houdt namelijk wel rekening met actuele verkeerssituaties, terwijl de API dit niet doet. Een directe vergelijking tussen de twee is daarom niet mogelijk.
Google geeft zelf aan dat resultaten in de loop van de tijd kunnen variëren door wijzigingen in het wegennet, bijgewerkte gemiddelde verkeersomstandigheden en de gedistribueerde aard van de dienst.