Specifica il tipo di modello di traffico da utilizzare

I modelli di traffico utilizzano fattori e algoritmi specifici per prevedere l'impatto delle condizioni del traffico sul tempo totale di percorrenza per un determinato percorso. L'API Routes offre diversi tipi di modelli di traffico per dare la priorità ai diversi fattori utilizzati nel calcolo della durata del traffico. Puoi specificare il tipo di modello di traffico che le route devono utilizzare per il calcolo della durata delle route o della matrice di route. Quando imposti il tipo di modello di traffico, il valore restituito nel campo duration 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.

Specificare un tipo di traffico

  1. Imposta il luogo di partenza e la destinazione.

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

  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 restituito sia la migliore stima del tempo di percorrenza in base alle informazioni note sulle condizioni del traffico storico e sul traffico in tempo reale. Il traffico in tempo reale diventa più importante più si avvicina il giorno departure_time. L'utilizzo del tipo predefinito BEST_GUESS offre le previsioni più utili per la maggior parte dei casi d'uso.

    • PESSIMISTIC per richiedere che il valore duration_in_traffic restituito modelli l'ora in base alle condizioni storiche del traffico nei giorni di traffico intenso. Questo tipo fornisce una durata stimata che molto probabilmente è più lunga rispetto al tempo di percorrenza effettivo nella maggior parte dei giorni. I giorni occasionali con condizioni particolarmente peggiori possono comunque superare questa stima.

    • OPTIMISTIC per richiedere che il valore duration_in_traffic restituito modelli l'ora in base alle condizioni storiche del traffico nei giorni di traffico più favorevoli. Questo tipo fornisce una durata stimata che molto probabilmente è più breve rispetto al tempo di percorrenza effettivo nella maggior parte dei giorni. I giorni occasionali con condizioni particolarmente buone potrebbero essere comunque più veloci di questa stima.

    Ad esempio: 

    "trafficModel": "OPTIMISTIC"

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

    RESTO

    -H X-Goog-FieldMask: routes.duration

    RPC

    const (fieldMask = "routes.duration")

Quando l'API Routes stima il tempo del 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 la corsa:

"duration": "1238s"

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

"duration": "2436s"