Specifica come e se includere i dati sul traffico

Le preferenze relative al traffico che selezioni bilanciano l'accuratezza dei dettagli del percorso con il rendimento della richiesta. 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 fornisce opzioni che ti consentono di controllare la qualità dei dati di risposta rispetto alla latenza della risposta.

Impostare il livello di dati sul traffico

L'API Routes fornisce RoutingPreference (REST) e RoutingPreference (gRPC) per consentirti 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:

  • Quando non c'è congestione, le condizioni del traffico sono considerate normali e il traffico scorre alla normale velocità senza impedimenti.
  • 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. Questa preferenza di routing offre la latenza di risposta più bassa (le risposte vengono restituite più rapidamente).

TRAFFIC_UNAWARE è l'impostazione predefinita.

Nella risposta:

  • L'orario di arrivo stimato è contenuto nella proprietà di risposta duration.

  • Le proprietà di risposta duration e staticDuration contengono lo stesso valore.

Utilizza questa preferenza di routing quando vuoi che le risposte vengano restituite il più rapidamente possibile e i dettagli di routing 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 i dettagli del percorso rispecchiano più accuratamente le condizioni reali. 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.

Ottimizzazione in base al traffico

Quando imposti la TRAFFIC_AWARE_OPTIMALpreferenza di itinerario, i percorsi vengono calcolati tenendo conto delle condizioni di traffico attuali, 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.

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 tragitto nel percorso senza prendere in considerazione le condizioni del traffico.

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 quando vuoi risultati della massima qualità, indipendentemente dal tempo di risposta.

Effetto dell'impostazione dell'orario di partenza

Se vuoi, puoi utilizzare la proprietà departureTime per impostare l'ora di partenza di un viaggio. Se non imposti la proprietà departureTime, il valore predefinito è il momento in cui effettui la richiesta.

  • Per TRAFFIC_UNAWARE, non puoi impostare departureTime perché la scelta di percorso e durata sono basati sulla rete stradale e in base al tempo medio condizioni del traffico.

  • Per TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL, che prendono in considerazione le condizioni del traffico in tempo reale, il traffico in tempo reale diventa più importante quanto più departureTime è vicino al momento attuale. 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 instradamento 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"
}

Configurare il traffico sulle polilinee

L'API Routes consente di richiedere informazioni sulle condizioni del traffico lungo un polilinea sensibile al traffico. Consulta Per ulteriori informazioni, richiedi le polilinee.