API Distance Matrix

L'API Matrix calcola i tempi di viaggio e le distanze tra ogni combinazione di origini e destinazioni in una singola richiesta. I casi d'uso tipici includono la ricerca del conducente o tecnico più vicino a un lavoro, la risoluzione di problemi di instradamento dei veicoli, la stima delle finestre temporali di consegna per i clienti, e il calcolo della copertura dell'area di servizio per la pianificazione delle strutture.

L'API Directions restituisce un singolo percorso dettagliato tra due punti, incluse le istruzioni di svolta e la geometria. L'API Matrix restituisce una tabella di distanze e durate per più coppie origine-destinazione senza geometria del percorso. Se è necessario confrontare molte posizioni in modo efficiente, l'API Matrix è più veloce e conveniente rispetto alle singole chiamate Directions.

L'API supporta matrici fino a 100 origini per 100 destinazioni in una singola richiesta, fornendo fino a 10.000 coppie origine-destinazione per chiamata. Le matrici non devono essere quadrate: è possibile inviare 1 origine per 100 destinazioni per una ricerca di posizione vicina, o 50 per 50 per un'assegnazione completa flotta-cliente.

L'API Matrix supporta guida, camminata, ciclismo e trasporto pubblico. La modalità di viaggio è impostata per richiesta. Tutte le coppie in una singola richiesta usano la stessa modalità. Se si hanno bisogno di risultati in modalità mista, inviare richieste separate per ogni modalità e unire le risposte nella propria applicazione.

Per impostazione predefinita, l'API Matrix utilizza velocità a flusso libero rappresentative delle condizioni di viaggio tipiche. Le durate aggiustate al traffico in tempo reale sono disponibili nei piani idonei. Impostare il parametro departure_time su un timestamp futuro per ricevere stime di viaggio basate sull'orario del giorno, fondate sui modelli di traffico storici.

Inviare la propria singola posizione di query come origine e l'elenco delle posizioni candidate come destinazioni. L'API restituisce il tempo di viaggio e la distanza dal punto di query a ogni candidato in una sola chiamata. Ordinare la risposta per durata per trovare l'opzione più vicina. Questo è significativamente più efficiente rispetto alla chiamata dell'API Directions in un ciclo per ogni candidato.