Spécifier le type de modèle de trafic à utiliser

Les modèles de trafic utilisent des algorithmes et des facteurs spécifiques pour prédire la façon dont le trafic ont une incidence sur le temps de trajet total pour un itinéraire donné. API Routes propose différents types de modèles de trafic pour hiérarchiser les différents facteurs utilisés dans pour calculer la durée en fonction du trafic. Vous pouvez spécifier le type de modèle de trafic tels que les itinéraires à utiliser pour calculer leur durée matricielle. Lorsque vous définissez le type de modèle de trafic, la valeur renvoyée dans le duration varie en fonction du modèle de trafic que vous choisissez.

Les API Routes Compute Routes et Les méthodes Compute Route Matrix sont compatibles avec les types de modèle 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

1. Définissez votre point de départ et votre destination.

2. Si votre heure de départ est située dans le futur, indiquez-la dans le champ Paramètre departure_time. Si vous ne spécifiez pas d'heure de départ, la valeur par défaut est "now".

3. Sélectionnez le modèle de trafic à utiliser avec le paramètre trafficModel. l'un des types suivants:

   • BEST_GUESS (par défaut) pour demander que l'objet duration_in_traffic renvoyé est la meilleure estimation du temps de trajet compte tenu des informations connues l'historique des conditions de circulation et le trafic en temps réel. Trafic plus dense que d'habitude plus la departure_time est proche de l'heure actuelle. Utiliser le type par défaut de BEST_GUESS donne les prédictions les plus utiles pour la grande majorité des différents cas d'utilisation.

   • PESSIMISTIC pour demander que le duration_in_traffic renvoyé modélise en fonction de l'historique des conditions de circulation les jours où le trafic est mauvais. Ce type donne une estimation de la durée qui est très probablement plus longue que le temps de trajet réel la plupart des jours. Parfois, avec des périodes particulièrement mauvais peuvent encore dépasser cette estimation.

   • OPTIMISTIC pour demander que le duration_in_traffic renvoyé modélise en fonction de l'historique des conditions de circulation les jours où le trafic est propice. Ce type fournit une durée estimée qui est très probablement plus courte que le temps de trajet réel la plupart des jours. Parfois, avec des dans de bonnes conditions peut être plus rapide que cette estimation.

   Exemple :

   "trafficModel": "OPTIMISTIC"

4. 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 de trajet, elle utilise le trafic que vous avez demandé.

Exemple: Requête de modèle de trafic

Par exemple, cette requête indique 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 à l'aide du modèle de trafic OPTIMISTIC. pour le trajet:

"duration": "1238s"

Si vous remplacez le type de modèle de trafic par PESSIMISTIC, la durée renvoyée est plus longtemps:

"duration": "2436s"