Voor het berekenen van de afstand tussen twee punten, voor het declareren van reiskosten, gebruiken wij de Google Distance Matrix API. Voor de API hebben wij een key om deze te gebruiken in de back-end. Voor de eerste 100.000 requests kost het 0.005USD per request, er is echter per maand een gratis krediet beschikbaar van 200USD.
Wij waren voor het project de opties gegeven gebruik te maken van de Google Matrix Distance API of een ANWB routeplanner API, JDI heeft voorheen altijd de routeplanner op de site van de ANWB gebruikt maar gaf de voorkeur uit naar de Google API. Over de ANWB routeplanner API is niks te vinden, alleen APIs die claimen gelijke resultaten te hebben met de ANWB routeplanner. Met voorkeur naar de Google API vanuit JDI hebben wij er ook voor gekozen gebruik te maken van deze API.
Bij het versturen van een request kunnen er verschillende parameters worden mee gegeven:
| Type | Beschrijving | Verplicht |
|---|---|---|
| destination | het eind punt | Ja |
| origin | het begin punt | Ja |
| arrival_time | de tijd waarop je aan zou komen | Nee |
| departure_time | de tijd waarop je zou vertrekken | Nee |
| avoid | resticties om te voorkomen zoals: toll wegen, snelweg, veerboot of binnen plekken | Nee |
| language | de taal waarin je het terug krijgt | Nee |
| mode | transport mode zoals: rijden, lopen fietsen of het OV | Nee |
| region | regio code | Nee |
| traffic_model | aanname bij het berekenen van de reistijd | Nee |
| transit_mode | specificatie van welk type OV gebruikt mag worden zoals: bus of trein | Nee |
| transit_routing_preference | extra voorkeuren zoals: zo min mogelijk lopen of overstappen | Nee |
| units | in welke unit het wordt terug gegeven | Nee |
Voor ons doeleinde gebruiken wij alleen de 'destination', 'origin' en 'units' om de afstand te berekenen in kilometers.
De functie die wij hiervoor zullen gebruiken ziet er uit als volgt:
Uit deze functie komt een JSON object terug, deze wordt afgevangen hier wordt de afstand uitgehaald, vervolgens wordt de afstand samen met het begin en eindpunt in de database opgeslagen.