L'API Routes Preferred fornisce tre preferenze di routing per il calcolo dei percorsi. La differenza sta nella misura in cui tengono conto delle condizioni del traffico nel calcolo del percorso. Ogni preferenza di routing produce risultati che differiscono in una certa misura in termini di qualità del percorso, ora di arrivo stimata e latenza della risposta.
Informazioni sulle condizioni del traffico
Le condizioni del traffico caratterizzano la velocità del flusso del traffico. Ad esempio:
Quando non c'è congestione, le condizioni del traffico sono considerate normali e il traffico scorre alla velocità normale senza ostacoli.
All'avvicinarsi dell'ora di punta, la densità del traffico aumenta, causando un rallentamento del traffico e condizioni del traffico da leggero a moderato.
Nel traffico intenso, la portata si arresta, creando condizioni del traffico intenso.
Ignora il traffico
Quando imposti la preferenza di calcolo dell'itinerario TRAFFIC_UNAWARE, gli itinerari 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 calcolo del percorso quando vuoi che le risposte vengano restituite il più rapidamente possibile e i dettagli approssimativi del percorso sono sufficienti.
Sensibile al 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 va a scapito della latenza di 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 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 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 ottenere risultati della massima qualità, indipendentemente dal tempo necessario per le risposte.
Esempio
Il seguente codice JSON mostra come impostare la preferenza di routing nel corpo dell'entità di un 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" }