L'API Routes Preferred offre tre preferenze di routing per il calcolo delle route. Si tratta di fattori diversi in quanto tengono conto delle condizioni del traffico nel calcolo del percorso. Ogni preferenza di routing produce risultati che differiscono in qualche modo per quanto riguarda la qualità delle route, l'orario di arrivo stimato stimato e la latenza di 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 ostacoli.
In prossimità dell'ora di punta, la densità del traffico aumenta, con un conseguente rallentamento del traffico, con condizioni di traffico da leggere a moderate.
Nel traffico da bumper a bumper, la velocità di flusso si arresta in modo anomalo, creando condizioni di traffico intenso.
Traffico inconsapevole
Quando imposti la preferenza di percorso TRAFFIC_UNAWARE, le route vengono calcolate senza tenere conto delle condizioni del traffico. Questa preferenza di routing offre la latenza di risposta più bassa
(le risposte vengono restituite il 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 percorso TRAFFIC_AWARE, i percorsi vengono calcolati tenendo conto delle condizioni del traffico. Di conseguenza, i dettagli di percorso e percorso riflettono in modo più accurato le condizioni del mondo reale. Poiché questo aumento della qualità dei dati incide sulla latenza di risposta, vengono applicate ottimizzazioni delle prestazioni per ridurre gran parte della latenza.
Utilizza questa preferenza di routing se vuoi dettagli di routing più precisi, ma non ti importa se le risposte vengono restituite con un moderato aumento della latenza.
Ottimizzato per il traffico
Quando imposti la preferenza di percorso TRAFFIC_AWARE_OPTIMAL, le route vengono calcolate tenendo conto delle condizioni del traffico, ma non vengono applicate ottimizzazioni delle prestazioni. In questa modalità, il server esegue una ricerca più approfondita della rete stradale per trovare il percorso ottimale.
Questa preferenza di routing offre la latenza di risposta più alta (ovvero le risposte restituiscono con il ritardo più lungo). Utilizza questa preferenza di routing quando vuoi 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"
}