Le preferenze sul traffico selezionate bilanciano la precisione dei dettagli del percorso con le prestazioni delle richieste. Quando effettui una richiesta, vuoi valutare se è meglio restituire i risultati più precisi possibile, oppure restituire i risultati il più rapidamente possibile. L'API Routes offre opzioni che ti consentono di controllare la qualità dei dati della risposta e la latenza della risposta.
Impostare il livello di dati sul traffico
L'API Routes fornisce RoutingPreference (REST) e RoutingPreference (gRPC) che consentono di specificare le preferenze di routing per il calcolo delle route. Questi le preferenze differiscono in quanto tengono conto delle condizioni del traffico nella calcolo del percorso. Ogni preferenza di percorso produce risultati che differiscono per grado in termini di qualità del percorso, tempo di arrivo stimato e latenza di risposta.
Le condizioni del traffico caratterizzano la velocità del flusso di traffico. Ad esempio:
- In assenza di congestioni, le condizioni del traffico sono considerate normali. il traffico fluisce alla normale velocità senza ostacoli.
- L'ora di punta si avvicina, aumentando la densità del traffico e di conseguenza il traffico rallentare, producendo condizioni di traffico da leggere a moderate.
- Nel traffico da paraurti a bumper, la portata del flusso si ferma, producendo carichi condizioni del traffico.
Traffico inconsapevole
Quando imposti la preferenza di routing TRAFFIC_UNAWARE
, vengono calcolati i percorsi
senza tenere conto delle condizioni di traffico attuali. Preferenza di routing
fornisce la latenza di risposta più bassa (le risposte vengono restituite più velocemente).
TRAFFIC_UNAWARE
è l'impostazione predefinita.
Nella risposta:
L'orario di arrivo stimato è contenuto nella proprietà di risposta
duration
.Le proprietà della risposta
duration
estaticDuration
contengono lo stesso valore.
Utilizza questa preferenza di routing quando vuoi che le risposte vengano restituite più rapidamente dettagli di percorso approssimativi sono sufficienti.
Attenzione al traffico
Quando imposti la preferenza di routing TRAFFIC_AWARE
, vengono calcolati i percorsi
tenendo conto delle attuali condizioni del traffico. Di conseguenza, il percorso e il percorso
i dettagli riflettono più accuratamente le condizioni del mondo reale. Poiché questo aumento
la qualità dei dati si va a scapito della latenza di risposta, delle ottimizzazioni delle prestazioni
per ridurre gran parte della latenza.
Nella risposta:
L'orario di arrivo stimato che prende in considerazione il traffico in tempo reale è contenuto nella Proprietà di risposta
duration
.La proprietà di risposta
staticDuration
contiene la durata del viaggio lungo il percorso senza tenere conto delle condizioni del traffico.
Utilizza questa preferenza di routing quando vuoi dettagli di percorso più precisi rispetto
TRAFFIC_UNAWARE
, eppure non ti dispiace se le risposte vengono restituite con un
un aumento moderato della latenza.
Sensibile al traffico ottimale
Quando imposti la preferenza di routing per TRAFFIC_AWARE_OPTIMAL
, i percorsi vengono
calcolato tenendo conto delle condizioni di traffico attuali, ma nessun rendimento
le ottimizzazioni vengono applicate. In questa modalità, il server esegue una procedura
la ricerca della rete stradale per trovare il percorso ottimale.
La preferenza di routing TRAFFIC_AWARE_OPTIMAL
equivale alla modalità utilizzata da
maps.google.com e dal
App mobile Google Maps.
Quando si utilizza questa opzione con Compute Route Matrix, il numero elementi in una richiesta (numero di origini × numero di destinazioni) non può superare 100. Per saperne di più sui limiti di Compute Route Matrix, consulta Calcola una matrice di percorsi.
Nella risposta:
L'orario di arrivo stimato che prende in considerazione il traffico in tempo reale è contenuto nella Proprietà di risposta
duration
.La proprietà di risposta
staticDuration
contiene la durata del viaggio lungo il percorso senza tenere conto delle condizioni del traffico.
Questa preferenza di routing fornisce la latenza di risposta più alta (ossia vengono restituite con il ritardo più lungo). Utilizza questa preferenza di routing quando vogliono risultati della massima qualità, senza tenere conto del tempo necessario per le risposte.
Effetto dell'impostazione dell'ora di partenza
Facoltativamente, puoi utilizzare la proprietà departureTime
per impostare l'orario di partenza per una
percorso. Se non imposti la proprietà departureTime
, il valore predefinito sarà
l'ora in cui invii la richiesta.
Per
TRAFFIC_UNAWARE
, non puoi impostaredepartureTime
perché la scelta di percorso e durata sono basati sulla rete stradale e in base al tempo medio condizioni del traffico.Per
TRAFFIC_AWARE
eTRAFFIC_AWARE_OPTIMAL
, che supportano il traffico in tempo reale di attenzione, il traffico in tempo reale diventa più importante più vicino èdepartureTime
. Più lontano imposti l'orario di partenza in futuro, maggiore è il dato che viene dato alla cronologia del traffico le condizioni di traffico.
Esempio di impostazione delle preferenze di routing
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" }
Configurare il traffico sulle polilinee
L'API Routes consente di richiedere informazioni sulle condizioni del traffico lungo una polilinea sensibile al traffico. Consulta Per ulteriori informazioni, richiedi le polilinee.