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

Développeurs de l'Espace économique européen (EEE)

Les modèles de trafic utilisent des algorithmes et des facteurs spécifiques pour prédire l'impact des conditions de trafic sur la durée totale du trajet pour un itinéraire donné. L'API Routes propose différents types de modèles de trafic pour hiérarchiser les différents facteurs utilisés pour calculer la durée dans le trafic. Vous pouvez spécifier le type de modèle de trafic que vous souhaitez que vos itinéraires utilisent lors du calcul de leur durée ou de celle de votre matrice d'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 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

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

  2. Si votre heure de départ est dans le futur, 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 "maintenant".

  3. Définissez le paramètre routingPreference sur TRAFFIC_AWARE_OPTIMAL. Définir routingPreference sur TRAFFIC_UNAWARE ou TRAFFIC_AWARE est incompatible avec le paramètre trafficModel.

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

    • BEST_GUESS (par défaut) pour demander que le duration_in_traffic renvoyé corresponde à la meilleure estimation du temps de trajet compte tenu des conditions de circulation historiques et en temps réel. Plus departure_time est proche de l'heure actuelle, plus la circulation en temps réel devient importante. L'utilisation du type par défaut BEST_GUESS permet d'obtenir les prédictions les plus utiles pour la grande majorité des cas d'utilisation.

    • PESSIMISTIC pour demander que le duration_in_traffic renvoyé modélise le temps en fonction des conditions de circulation historiques les jours de trafic difficile. Ce type de durée donne une estimation qui est supérieure à la durée réelle du trajet la plupart du temps. Les jours où la circulation est particulièrement difficile, le temps de trajet peut être plus long.

    • OPTIMISTIC pour demander que la duration_in_traffic renvoyée modélise le temps en fonction des conditions de circulation historiques les jours où la circulation est fluide. Ce type de durée donne une estimation qui est le plus souvent inférieure à la durée réelle du trajet la plupart du temps. Les jours où la circulation est particulièrement fluide, le temps de trajet peut être plus court.

    Exemple : 

    "trafficModel": "OPTIMISTIC"

  5. 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 passé dans le trafic, elle utilise le type de modèle de trafic que vous avez demandé.

Exemple : Demande 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 définissez le type de modèle de trafic sur PESSIMISTIC, la durée renvoyée est plus longue :

"duration": "2436s"