L'API Routes Preferred fornisce tre preferenze di routing per il calcolo dei percorsi. Queste differiscono in base alla misura in cui tengono conto delle condizioni del traffico nel calcolo del percorso. Ogni preferenza di calcolo itinerario produce risultati che differiscono in una certa misura per quanto riguarda la qualità del percorso, l'orario di arrivo stimato e la latenza della risposta.
Informazioni sulle condizioni del traffico
Le condizioni del traffico caratterizzano la velocità del flusso di traffico. Ad esempio:
Quando non c'è congestione, le condizioni del traffico sono considerate normali e il traffico scorre alla velocità regolare senza ostacoli.
All'avvicinarsi dell'ora di punta, la densità del traffico aumenta, il che fa rallentare il traffico, producendo condizioni del traffico da leggere a moderate.
Nel traffico intenso, la velocità del flusso si blocca, producendo condizioni del traffico intenso.
Indifferente al traffico
Quando imposti la
TRAFFIC_UNAWARE
preferenza di routing, i percorsi vengono calcolati senza tenere conto delle condizioni del traffico. Questa preferenza di routing fornisce 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.
Attento al traffico
Quando imposti la
TRAFFIC_AWARE
preferenza di routing, 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 del mondo reale. Poiché questo aumento della qualità dei dati comporta un aumento 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ù accurati, ma non ti dispiace se le risposte vengono restituite con un aumento moderato della latenza.
Ottimale per il traffico
Quando imposti la
TRAFFIC_AWARE_OPTIMAL
preferenza di routing, i percorsi vengono calcolati tenendo conto delle condizioni del traffico, ma
non vengono applicate ottimizzazioni delle prestazioni. In questa modalità, il server esegue una ricerca più esaustiva della rete stradale per trovare il percorso ottimale.
Questa preferenza di routing fornisce 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 massima qualità, indipendentemente dal tempo impiegato per restituire le risposte.
Esempio
Il seguente codice JSON mostra come impostare la preferenza di routing nel corpo di un'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" }