Impostare il livello dei dati sul traffico

Le preferenze relative al traffico che selezioni bilanciano l'accuratezza dei dettagli del percorso con il rendimento delle richieste in uno dei due modi seguenti:

  • Consapevole del traffico: restituisce i risultati più accurati possibili (latenza più elevata).

  • Senza dati sul traffico: restituisce i risultati il più rapidamente possibile (latenza minima).

Quando effettui una richiesta, valuta se è meglio restituire i risultati più accurati possibili o 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.

Come impostare il livello di traffico

L'API Routes fornisce RoutingPreference (REST) e RoutingPreference (gRPC) per consentirti di specificare le preferenze di routing per il calcolo delle route.

L'impostazione predefinita è Risultati senza dati sul traffico. Puoi selezionare le opzioni relative al traffico con le preferenze di routing TRAFFIC_UNAWARE, TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Ogni preferenza di routing produce risultati diversi in termini di qualità del percorso, orario di arrivo stimato e latenza di risposta.

Condizioni del traffico

Le condizioni del traffico caratterizzano la velocità del flusso di traffico:

  • Traffico normale: nessun ingorgo, il traffico scorre a una velocità normale.

  • Traffico da leggero a moderato: congestione in aumento, con il traffico che scorre a velocità ridotta.

  • Traffico intenso: ingorgo grave con velocità del traffico notevolmente ridotta.

Traffico non rilevato

TRAFFIC_UNAWARE è l'impostazione predefinita. Utilizza questa preferenza di routing quando vuoi che le risposte vengano restituite il più rapidamente possibile e i dettagli di routing approssimativi sono sufficienti.

I percorsi TRAFFIC_UNAWARE vengono calcolati senza tenere conto delle condizioni di traffico attuali. Questa preferenza di routing consente di ottenere la risposta più rapida alla richiesta (latenza più bassa).

Se scegli TRAFFIC_UNAWARE, il percorso e la durata scelti si basano sulla rete stradale e sulle condizioni di traffico medie indipendenti dal tempo, non sulle condizioni stradali attuali. Di conseguenza, i percorsi potrebbero includere strade chiuse temporaneamente. I risultati di una determinata richiesta possono variare nel tempo a causa di cambiamenti nella rete stradale, condizioni di traffico medio aggiornate e la natura distribuita del servizio. I risultati possono variare anche tra percorsi quasi equivalenti in qualsiasi momento o con qualsiasi frequenza.

Ecco le risposte che vedrai:

  • duration: contiene l'orario di arrivo stimato per il percorso.

  • staticDuration: l'orario di arrivo stimato per il percorso che prende in considerazione solo le informazioni sul traffico storico. Per TRAFFIC_UNAWARE, contiene lo stesso valore di duration.

Conoscenza del traffico

Utilizza questa preferenza di routing quando vuoi dettagli di routing più precisi rispetto a TRAFFIC_UNAWARE, ma non ti dispiace se le risposte vengono restituite con un aumento moderato della latenza.

Quando imposti la preferenza di routing TRAFFIC_AWARE, il servizio calcola il percorso tenendo conto delle condizioni di traffico attuali. Di conseguenza, il percorso e i dettagli del percorso rispecchiano più accuratamente le condizioni reali. Poiché questo aumento della qualità dei dati avviene a scapito della latenza di risposta, vengono applicate ottimizzazioni delle prestazioni per ridurre gran parte della latenza.

Ecco le risposte che vedrai:

  • duration: l'orario di arrivo stimato che tiene conto delle informazioni sul traffico in tempo reale.

  • staticDuration L'orario di arrivo stimato per il percorso che prende in considerazione solo le informazioni sul traffico storico.

Ottimizzazione in base al traffico

Utilizza questa preferenza di routing se vuoi risultati della massima qualità, indipendentemente dal tempo di risposta. Questa preferenza di routing ha il ritardo più lungo nel restituire le risposte (latenza più elevata).

Quando imposti la preferenza di routing TRAFFIC_AWARE_OPTIMAL, il servizio calcola il percorso tenendo conto delle condizioni di traffico attuali, ma non applica le ottimizzazioni del rendimento. In questa modalità, il server esegue una ricerca più completa della rete stradale per trovare il percorso ottimale.

La preferenza di itinerario TRAFFIC_AWARE_OPTIMAL è equivalente alla modalità utilizzata da maps.google.com e dall' app mobile Google Maps.

Quando utilizzi questa opzione con Compute Routes Matrix, il numero di elementi in una richiesta (numero di origini x numero di destinazioni) non può superare

  1. Per saperne di più sui limiti di Compute Routes Matrix, consulta Calcolo di una tabella di route.

Ecco le risposte che vedrai:

  • duration: l'orario di arrivo stimato per il percorso, tenendo conto delle informazioni sul traffico in tempo reale.

  • staticDuration: l'orario di arrivo stimato per il percorso che prende in considerazione solo le informazioni sul traffico storico.

(Facoltativo) Impostare l'orario di partenza

Utilizza questa proprietà solo per le richieste che tengono conto del traffico in cui l'ora di partenza deve essere nel futuro. Se non imposti la proprietà departureTime, il valore predefinito è il momento in cui effettui la richiesta.

Utilizza la proprietà departureTime insieme alle opzioni TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL quando vuoi modificare il modo in cui il servizio predice il traffico quando scegli un percorso.

  • TRAFFIC_UNAWARE: non consigliato perché la scelta del percorso e della durata si basano sulla rete stradale e sulle condizioni di traffico medie indipendenti dal tempo.

  • TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL: consigliate per le partenze che si verificano nel prossimo futuro perché queste preferenze prendono in considerazione le condizioni di traffico in tempo reale. Il traffico in tempo reale diventa più importante e pertinente man mano che departureTime si avvicina. Più avanti nel tempo imposti l'ora di partenza, più viene data considerazione alle condizioni di traffico storiche nella selezione delle route.

Esempio: come selezionare il calcolo dell'itinerario in base al traffico

Il seguente codice JSON mostra come impostare la preferenza di routing TRAFFIC_AWARE_OPTIMAL 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"
}

Configurare il traffico sulle polilinee

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