Specifica il tipo di modello di traffico da utilizzare

I modelli di traffico utilizzano algoritmi e fattori specifici per prevedere l'impatto delle condizioni di 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 venga utilizzato per i tuoi percorsi durante il calcolo della durata dei percorsi o della matrice di percorsi. Quando imposti il tipo di modello di traffico, il valore restituito nel duration campo varia a seconda del modello di traffico scelto.

Entrambi i metodi Compute Routes e Compute Route Matrix dell'API Routes 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 la località di partenza e quella di arrivo.

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

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

   • BEST_GUESS (valore predefinito) per richiedere che il valore duration_in_traffic riferito sia la stima migliore del tempo di percorrenza in base alle informazioni disponibili sia sulle condizioni del traffico storico sia su quelle in tempo reale. Il traffico in tempo reale diventa più importante quanto più departure_time è vicino al momento attuale. L'utilizzo del tipo predefinito BEST_GUESS fornisce le previsioni più utili per la maggior parte dei casi d'uso.

   • PESSIMISTIC per richiedere che duration_in_traffic restituito modelli il tempo in base alle condizioni di traffico storiche nei giorni di traffico elevato. Questo tipo fornisce una durata stimata che è molto probabilmente più lunga del tempo di percorrenza effettivo nella maggior parte dei giorni. In alcuni giorni con condizioni particolarmente avverse, la stima potrebbe essere superata.

   • OPTIMISTIC per richiedere che duration_in_traffic restituito modelli il tempo in base alle condizioni di traffico storiche nei giorni di traffico intenso. Questo tipo fornisce una durata stimata molto probabilmente più breve del tempo di percorrenza effettivo nella maggior parte dei giorni. In alcuni giorni con condizioni particolarmente favorevoli, la consegna potrebbe essere comunque più rapida di questa stima.

   Ad esempio:

   "trafficModel": "OPTIMISTIC"

4. Specifica il campo routes.duration nella maschera di 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 OPTIMISTIC tipo di modello di traffico a un'ora di partenza specifica:

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 OPTIMISTIC modello di traffico per il viaggio:

"duration": "1238s"

Se modifichi il tipo di modello di traffico in PESSIMISTIC, la durata restituita è più lunga:

"duration": "2436s"