I modelli di traffico utilizzano fattori e algoritmi specifici per prevedere in che modo il traffico
influiscono sul tempo totale di percorrenza per un determinato percorso. API Routes
offre diversi tipi di modelli di traffico per dare la priorità ai diversi fattori utilizzati nelle
calcolare la durata del traffico. Puoi specificare il tipo di modello di traffico che
ad esempio i percorsi da utilizzare per calcolare la durata dei percorsi o del percorso
. Quando imposti il tipo di modello di traffico, il valore restituito nel
Il campo duration
varia a seconda del modello di traffico scelto.
Sia l'API Routes Compute Routes
che
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
.
Specificare un tipo di traffico
Imposta il luogo di partenza e la destinazione.
Se l'orario di partenza è nel futuro, includi l'orario utilizzando la Parametro
departure_time
. Se non specifichi un orario di partenza, il valore predefinito è ora.Seleziona il modello di traffico da utilizzare con il parametro
trafficModel
e uno dei seguenti tipi:BEST_GUESS
(predefinito) per richiedere che l'oggettoduration_in_traffic
restituito è la stima migliore del tempo di percorrenza, considerando le informazioni condizioni storiche del traffico e traffico in tempo reale. Il traffico in tempo reale diventa più importante più è vicino al momentodeparture_time
. Utilizzo del tipo predefinito diBEST_GUESS
fornisce le previsioni più utili per la maggior parte dei e casi d'uso specifici.PESSIMISTIC
per richiedere che il valoreduration_in_traffic
restituito modelli la in base alle condizioni storiche del traffico nei giorni di traffico intenso. Questo tipo fornisce una durata stimata che è molto probabilmente più lunga di il tempo di percorrenza effettivo nella maggior parte dei giorni. Giornate occasionali con parti intime possono comunque superare questa stima.OPTIMISTIC
per richiedere che il valoreduration_in_traffic
restituito modelli la in base alle condizioni storiche del traffico nei giorni di traffico più favorevoli. Questo tipo fornisce una durata stimata che molto probabilmente è più breve di il tempo di percorrenza effettivo nella maggior parte dei giorni. Giornate occasionali con parti buone condizioni potrebbero comunque essere più rapide rispetto a questa stima.
Ad esempio:
"trafficModel": "OPTIMISTIC"
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 traffico che hai richiesto.
Esempio: richiesta di modello di traffico
Ad esempio, questa richiesta specifica che la durata deve essere stimata utilizzando
OPTIMISTIC
tipo di modello di traffico 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 modello di traffico OPTIMISTIC
tipo di viaggio:
"duration": "1238s"
Se modifichi il tipo di modello di traffico in PESSIMISTIC
, la durata restituita è
più lungo:
"duration": "2436s"