L'API Routes Preferred fornisce tre preferenze di routing per calcolare i percorsi. Differiscono per quanto riguarda l'inclusione delle condizioni di traffico nel calcolo del percorso. Ogni preferenza di itinerario genera risultati che differiscono in misura diversa in termini di qualità del percorso, orario di arrivo stimato 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 normale velocità senza impedimenti.
Con l'avvicinarsi dell'ora di punta, la densità del traffico aumenta, il che causa un rallentamento del traffico, con condizioni di traffico da scarse a moderate.
In caso di traffico intenso, la velocità di flusso si arresta, generando condizioni di traffico intenso.
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 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.
Conoscenza del traffico
Quando imposti la
TRAFFIC_AWARE
preferenza di itinerario, i percorsi vengono calcolati tenendo conto delle condizioni del traffico. Di conseguenza, il percorso e i relativi dettagli riflettono con maggiore precisione le condizioni reali. Poiché questo aumento della qualità dei dati avviene a scapito della latenza di risposta, vengono applicate ottimizzazioni del rendimento per ridurre gran parte della latenza.
Utilizza questa preferenza di routing quando vuoi dettagli di routing più precisi, ma non ti dispiace se le risposte vengono restituite con un aumento moderato della latenza.
Ottimizzazione 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ù completa 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 se vuoi risultati di massima qualità, indipendentemente dal tempo di risposta.
Esempio
Il seguente codice JSON mostra come impostare la preferenza di routing nel 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"
}