Les modèles de trafic utilisent des algorithmes et des facteurs spécifiques pour prédire l'impact des conditions de circulation sur le temps de trajet total pour un itinéraire donné. L'API Routes propose différents types de modèles de trafic pour donner la priorité aux différents facteurs utilisés dans le calcul de la durée du trafic. Vous pouvez spécifier le type de modèle de trafic que vous souhaitez que vos itinéraires utilisent pour calculer la durée de vos itinéraires ou de la matrice des itinéraires. Lorsque vous définissez le type de modèle de trafic, la valeur renvoyée dans le champ duration
varie en fonction du modèle de trafic que vous choisissez.
Les méthodes Compute Routes
et Compute Route Matrix
de l'API Routes sont toutes deux compatibles avec les types de modèles de trafic.
Par défaut, les deux méthodes utilisent le type de modèle de trafic BEST_GUESS
.
Pour spécifier un type de trafic
Définissez votre point de départ et votre destination.
Si votre heure de départ est postérieure à la date du jour, incluez-la à l'aide du paramètre
departure_time
. Si vous ne spécifiez pas d'heure de départ, la valeur par défaut est "now".Sélectionnez le modèle de trafic à utiliser avec le paramètre
trafficModel
et choisissez l'un des types suivants:BEST_GUESS
(par défaut) pour demander que leduration_in_traffic
renvoyé soit la meilleure estimation du temps de trajet compte tenu des conditions de circulation historiques et en temps réel. Plusdeparture_time
est proche de l'heure actuelle, plus la circulation en temps réel devient importante. L'utilisation du type par défaut deBEST_GUESS
donne les prédictions les plus utiles pour la grande majorité des cas d'utilisation.PESSIMISTIC
pour demander que leduration_in_traffic
renvoyé modélise l'heure en fonction de l'historique des conditions de circulation les jours où le trafic est mauvais. Ce type donne une durée estimée qui est très probablement plus longue que le temps de trajet réel la plupart des jours. Certains jours avec des conditions particulièrement mauvaises peuvent toutefois dépasser cette estimation.OPTIMISTIC
pour demander que leduration_in_traffic
renvoyé modélise l'heure en fonction de l'historique des conditions de circulation lorsque le trafic est fluide. Ce type donne une durée estimée qui est probablement plus courte que le temps de trajet réel la plupart des jours. Les jours occasionnels où les conditions sont particulièrement bonnes peuvent encore être plus rapides que cette estimation.
Par exemple :
"trafficModel": "OPTIMISTIC"
Spécifiez le champ
routes.duration
dans le masque de champ.REST
-H X-Goog-FieldMask: routes.duration
RPC
const (fieldMask = "routes.duration")
Lorsque l'API Routes estime le temps du trafic, elle utilise le type de modèle de trafic que vous avez demandé.
Exemple: Requête de modèle de trafic
Par exemple, cette requête spécifie que la durée doit être estimée à l'aide du type de modèle de trafic OPTIMISTIC
à une heure de départ spécifique:
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'
Cette requête renvoie la durée estimée du trajet à l'aide du type de modèle de trafic OPTIMISTIC
:
"duration": "1238s"
Si vous remplacez le type de modèle de trafic par PESSIMISTIC
, la durée renvoyée est plus longue:
"duration": "2436s"