L'API Routes Preferred fornisce tre preferenze di routing per il calcolo dei percorsi. Si differenziano per il grado in cui tengono conto delle condizioni del traffico nel calcolo del percorso. Ogni preferenza di routing produce risultati che differiscono in una certa misura per quanto riguarda la qualità del percorso, l'ETA stimato e la latenza della risposta.
Informazioni sulle condizioni del traffico
Le condizioni del traffico caratterizzano la velocità del flusso di traffico. Ad esempio:
In assenza di congestione, le condizioni del traffico sono considerate normali e il traffico scorre alla normale velocità senza impedimenti.
Man mano che ci si avvicina all'ora di punta, la densità del traffico aumenta, il che causa un rallentamento del traffico, producendo condizioni di traffico da leggero a moderato.
Nel traffico intenso, la velocità di flusso si arresta, producendo condizioni di traffico intense.
Traffico non rilevato
Quando imposti la preferenza di routing
TRAFFIC_UNAWARE, i percorsi vengono calcolati senza tenere conto delle condizioni del traffico. Questa preferenza di routing offre la latenza di risposta più bassa
(le risposte vengono restituite più rapidamente).
Utilizza questa preferenza di routing quando vuoi che le risposte vengano restituite il più rapidamente possibile e i dettagli di routing approssimativi sono sufficienti.
Consapevole del traffico
Quando imposti la preferenza di routing
TRAFFIC_AWARE, i percorsi vengono calcolati tenendo conto delle condizioni del traffico. Di conseguenza, il percorso e i relativi dettagli riflettono in modo più accurato le condizioni reali. Poiché questo aumento della qualità dei dati avviene a scapito della latenza
della risposta, vengono applicate ottimizzazioni delle prestazioni per ridurre gran parte della latenza.
Utilizza questa preferenza di routing quando vuoi dettagli di routing più precisi e non ti preoccupa se le risposte vengono restituite con un aumento moderato della latenza.
Ottimale in base al traffico
Quando imposti la preferenza di routing
TRAFFIC_AWARE_OPTIMAL, i percorsi vengono calcolati tenendo conto delle condizioni del traffico, ma
non vengono applicate ottimizzazioni del rendimento. In questa modalità, il server esegue una
ricerca più esaustiva della rete stradale per trovare il percorso ottimale.
Questa preferenza di routing offre la latenza di risposta più elevata (ovvero le risposte vengono restituite con il ritardo più lungo). Utilizza questa preferenza di routing quando vuoi risultati di altissima qualità, senza considerare i tempi di risposta.
Esempio
Il seguente codice JSON mostra come impostare la preferenza di routing in un corpo dell'entità del messaggio di richiesta.
{ "origin":{ "location":{ "latLng":{ "latitude":37.419734, "longitude":-122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude":37.417670, "longitude":-122.079595 } } }, "travelMode":"DRIVE", "routingPreference":"TRAFFIC_AWARE_OPTIMAL" }