Specifica il tipo di modello di traffico da utilizzare

Sviluppatori dello Spazio economico europeo (SEE)

I modelli di traffico utilizzano algoritmi e fattori specifici per prevedere l'impatto delle condizioni del traffico sul tempo di percorrenza totale di un determinato itinerario. L'API Routes offre diversi tipi di modelli di traffico per dare la priorità a fattori diversi utilizzati per calcolare la durata nel traffico. Puoi specificare il tipo di modello di traffico che vuoi che i tuoi percorsi utilizzino per calcolare la durata dei tuoi percorsi o della matrice di percorsi. Quando imposti il tipo di modello di traffico, il valore restituito nel campo duration varia a seconda del modello di traffico scelto.

Sia l'API Routes Compute Routes sia i metodi Compute Route Matrix supportano i tipi di modelli di traffico.

Per impostazione predefinita, entrambi i metodi utilizzano il tipo di modello di traffico BEST_GUESS.

Per specificare un tipo di traffico

  1. Imposta il punto di partenza e la destinazione.

  2. Se l'orario di partenza è futuro, includi l'ora utilizzando il parametro departure_time. Se non specifichi un orario di partenza, il valore predefinito è ora.

  3. Imposta il parametro routingPreference su TRAFFIC_AWARE_OPTIMAL. L'impostazione di routingPreference su TRAFFIC_UNAWARE o TRAFFIC_AWARE non è compatibile con il parametro trafficModel.

  4. Seleziona il modello di traffico da utilizzare con il parametro trafficModel e uno dei seguenti tipi:

    • BEST_GUESS (valore predefinito) per richiedere che il duration_in_traffic restituito sia la migliore stima del tempo di viaggio in base a ciò che è noto sia sulle condizioni del traffico storiche sia sul traffico in tempo reale. Il traffico in tempo reale diventa più importante quanto più departure_time è vicino al momento attuale. L'utilizzo del tipo predefinito di BEST_GUESS fornisce le previsioni più utili per la maggior parte dei casi d'uso.

    • PESSIMISTIC per richiedere che i modelli duration_in_traffic restituiti modellino l'ora in base alle condizioni del traffico storiche nei giorni di traffico intenso. Questo tipo fornisce una durata stimata che molto probabilmente è superiore al tempo di percorrenza effettivo nella maggior parte dei giorni. I giorni occasionali con condizioni particolarmente sfavorevoli potrebbero comunque superare questa stima.

    • OPTIMISTIC per richiedere che i modelli duration_in_traffic restituiti calcolino il tempo in base alle condizioni di traffico storiche nei giorni di traffico normale. Questo tipo fornisce una durata stimata che molto probabilmente è inferiore al tempo di percorrenza effettivo nella maggior parte dei giorni. Le giornate occasionali con condizioni particolarmente buone potrebbero comunque essere più veloci di questa stima.

    Ad esempio: 

    "trafficModel": "OPTIMISTIC"

  5. Specifica il campo routes.duration nella maschera del campo.

    REST

    -H X-Goog-FieldMask: routes.duration

    RPC

    const (fieldMask = "routes.duration")

Quando l'API Routes stima il tempo nel traffico, utilizza il tipo di modello di traffico che hai richiesto.

Esempio: richiesta di modello di traffico

Ad esempio, questa richiesta specifica che la durata deve essere stimata utilizzando il tipo di modello di traffico OPTIMISTIC a un orario di partenza specifico:

curl -X POST -H 'content-type: application/json' -d ' {
"origin": {
  "address": "Kyoto, Japan"
  },
"destination": {
  "placeId": "ChIJrYtcv-urAWAR3XzWvXv8n_s"
  },
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE_OPTIMAL",
"trafficModel": "OPTIMISTIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Questa richiesta restituisce la durata stimata utilizzando il tipo di modello di traffico OPTIMISTIC per il viaggio:

"duration": "1238s"

Se modifichi il tipo di modello di traffico in PESSIMISTIC, la durata restituita è maggiore:

"duration": "2436s"