Distance Matrix API

De Matrix API berekent reistijden en afstanden tussen elke combinatie van herkomsten en bestemmingen in één enkel verzoek. Typische gebruiksscenario's zijn het vinden van de dichtstbijzijnde chauffeur of technicus voor een opdracht, het oplossen van voertuigrouteringsproblemen, het schatten van bezorgtijdvensters voor klanten, en het berekenen van servicegebiedsdekking voor faciliteitsplanning.

De Directions API geeft één gedetailleerde route terug tussen twee punten, inclusief afslagaanwijzingen en geometrie. De Matrix API geeft een tabel van afstanden en reistijden terug voor meerdere herkomst-bestemmingsparen zonder routegeometrie. Als u veel locaties efficiënt wilt vergelijken, is de Matrix API sneller en kostenefficiënter dan afzonderlijke Directions-aanroepen.

De API ondersteunt matrices tot 100 herkomsten bij 100 bestemmingen in één enkel verzoek, wat tot 10.000 herkomst-bestemmingsparen per aanroep oplevert. Matrices hoeven niet vierkant te zijn: u kunt 1 herkomst bij 100 bestemmingen sturen voor een locatiezoekactie in de buurt, of 50 bij 50 voor een volledige vloot-naar-klant toewijzing.

De Matrix API ondersteunt rijden, lopen, fietsen en openbaar vervoer. De reismodus wordt per verzoek ingesteld. Alle paren in één enkel verzoek gebruiken dezelfde modus. Als u resultaten voor meerdere modi nodig heeft, stuur dan afzonderlijke verzoeken voor elke modus en voeg de antwoorden samen in uw applicatie.

Standaard gebruikt de Matrix API vrije rijsnelheden die representatief zijn voor typische reisomstandigheden. Realtimeverkeer-aangepaste duren zijn beschikbaar bij in aanmerking komende abonnementen. Stel de parameter departure_time in op een toekomstig tijdstempel om tijdgebonden reisschattingen te ontvangen op basis van historische verkeerspatronen.

Stuur uw enkele zoeklocatie als herkomst en uw lijst met kandidaatlocaties als bestemmingen. De API geeft de reistijd en afstand van het zoekpunt naar elke kandidaat in één aanroep terug. Sorteer de respons op duur om de dichtstbijzijnde optie te vinden. Dit is aanzienlijk efficiënter dan het aanroepen van de Directions API in een lus voor elke kandidaat.