Impostare il livello dei dati sul traffico

Sviluppatori dello Spazio economico europeo (SEE)

Le preferenze del traffico che selezioni bilanciano l'accuratezza dei dettagli del percorso con le prestazioni della richiesta in uno dei due modi seguenti:

  • Rilevamento del traffico: restituisce i risultati più accurati possibili (latenza maggiore).

  • Traffico sconosciuto: restituisce i risultati il più rapidamente possibile (latenza più bassa).

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), che consentono di specificare le preferenze di routing per il calcolo delle route.

L'impostazione predefinita è "Risultati non sensibili al traffico". Seleziona le opzioni di 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, ETA stimato e latenza della risposta.

Condizioni del traffico

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

  • Traffico normale: nessun ingorgo e traffico che scorre a velocità normale.

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

  • Traffico intenso: grave congestione, 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 genera la risposta alla richiesta più rapida (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 temporaneamente chiuse. I risultati di una determinata richiesta possono variare nel tempo a causa di modifiche alla rete stradale, aggiornamenti delle condizioni medie del traffico e della natura distribuita del servizio. I risultati possono variare anche tra percorsi quasi equivalenti in qualsiasi momento o 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 considerando solo le informazioni sul traffico storico. Per TRAFFIC_UNAWARE, questo campo contiene lo stesso valore di duration.

Consapevole del traffico

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

Quando imposti la preferenza di routing TRAFFIC_AWARE, il servizio calcola l'itinerario tenendo conto delle condizioni del traffico attuali. Di conseguenza, il percorso e i relativi dettagli riflettono in modo più preciso 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 tenendo conto delle informazioni sul traffico in tempo reale.

  • staticDuration L'ETA per l'itinerario considerando solo le informazioni storiche sul traffico.

Ottimale in base al traffico

Utilizza questa preferenza di routing quando vuoi risultati di massima qualità senza tenere conto dei tempi 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 del traffico attuali, ma non applica ottimizzazioni delle prestazioni. In questa modalità, il server esegue una ricerca più esaustiva della rete stradale per trovare il percorso ottimale.

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

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

  1. Per saperne di più sui limiti di Compute Route Matrix, consulta Calcolare una matrice di itinerari.

Ecco le risposte che vedrai:

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

  • staticDuration: l'orario di arrivo stimato per il percorso considerando solo le informazioni sul traffico storico.

Impostare l'orario di partenza (facoltativo)

Utilizza questa proprietà solo per le richieste sensibili al traffico in cui l'orario di partenza deve essere nel futuro. Se non imposti la proprietà departureTime, il valore predefinito è l'ora 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 prevede il traffico quando scegli un percorso.

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

  • TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL: Consigliato per le partenze che avverranno nel prossimo futuro perché queste preferenze tengono conto delle condizioni del traffico in tempo reale. Il traffico in tempo reale diventa più importante e pertinente quanto più si avvicina il departureTime al presente. Più lontano nel futuro imposti l'orario di partenza, maggiore è la considerazione delle condizioni del traffico storico nella selezione dei percorsi.

Esempio: come selezionare il routing in base al traffico

Il seguente codice JSON mostra come impostare la preferenza di routing TRAFFIC_AWARE_OPTIMAL nel corpo di un'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 ti consente di richiedere informazioni sulle condizioni del traffico lungo una polilinea sensibile al traffico. Per saperne di più, consulta Richiedere polilinee.