Définir le niveau de données sur le trafic

Les préférences de trafic que vous sélectionnez équilibrent la précision des détails de l'itinéraire avec les performances des requêtes de l'une des deux manières suivantes :

• Prise en compte du trafic : renvoie les résultats les plus précis possible (latence plus élevée).

• Sans prise en compte du trafic : renvoie les résultats le plus rapidement possible (latence la plus faible).

Lorsque vous effectuez une requête, déterminez s'il est préférable de renvoyer les résultats les plus précis possible ou de renvoyer les résultats le plus rapidement possible. L'API Routes fournit des options qui vous permettent de contrôler la qualité des données de réponse par rapport à la latence de la réponse.

Définir le niveau de trafic

L'API Routes fournit RoutingPreference (REST) et RoutingPreference (gRPC), qui vous permettent de spécifier des préférences de routage pour le calcul des itinéraires.

Par défaut, les résultats ne tiennent pas compte du trafic. Vous sélectionnez les options de trafic avec les préférences de routage TRAFFIC_UNAWARE, TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Chaque préférence de routage produit des résultats qui diffèrent en termes de qualité de l'itinéraire, d'heure d'arrivée prévue et de latence de réponse.

Conditions de circulation

Les conditions de circulation caractérisent le débit du trafic :

• Trafic normal : pas d'embouteillages, le trafic est fluide et les véhicules roulent à une vitesse normale.

• Trafic faible à modéré : embouteillages croissants, avec un trafic circulant à vitesse réduite.

• Trafic dense : embouteillages importants, avec une vitesse de circulation fortement réduite.

Non sensible au trafic

TRAFFIC_UNAWARE est le paramètre par défaut. Utilisez cette préférence d'itinéraire lorsque vous souhaitez obtenir des réponses le plus rapidement possible et que des détails d'itinéraire approximatifs suffisent.

Les itinéraires TRAFFIC_UNAWARE sont calculés sans tenir compte des conditions de circulation actuelles. Cette préférence de routage permet d'obtenir la réponse à la requête la plus rapide (latence la plus faible).

Si vous choisissez TRAFFIC_UNAWARE, l'itinéraire et la durée sont déterminés en fonction du réseau routier et des conditions de circulation moyennes toutes heures confondues, et non de l'état actuel des routes. Par conséquent, l'itinéraire peut inclure des routes temporairement fermées. Les résultats d'une requête donnée peuvent varier au fil du temps en raison des modifications du réseau routier, de l'évolution des conditions de circulation moyennes et de la nature décentralisée du service. Les résultats peuvent également varier entre plusieurs itinéraires presque équivalents à tout moment et à n'importe quelle fréquence.

Voici les réponses que vous verrez :

• duration : contient l'heure d'arrivée prévue pour l'itinéraire.

• staticDuration : heure d'arrivée prévue pour l'itinéraire en ne tenant compte que des informations de l'historique du trafic. Pour TRAFFIC_UNAWARE, ce champ contient la même valeur que duration.

Prise en compte du trafic

Utilisez cette préférence d'itinéraire lorsque vous souhaitez obtenir des détails d'itinéraire plus précis que TRAFFIC_UNAWARE, et que vous acceptez que les réponses soient renvoyées avec une augmentation modérée de la latence.

Lorsque vous définissez la préférence de routage TRAFFIC_AWARE, le service calcule l'itinéraire en tenant compte des conditions de circulation actuelles. Par conséquent, l'itinéraire et les détails de l'itinéraire reflètent plus précisément les conditions réelles. Étant donné que cette amélioration de la qualité des données se fait au détriment de la latence de réponse, des optimisations des performances sont appliquées pour réduire une grande partie de la latence.

Voici les réponses que vous verrez :

• duration : heure d'arrivée prévue en tenant compte des informations sur le trafic en temps réel.

• staticDuration : heure d'arrivée prévue pour l'itinéraire en ne tenant compte que des informations historiques sur le trafic.

Optimal en tenant compte du trafic

Utilisez cette préférence de routage lorsque vous souhaitez obtenir des résultats de la plus haute qualité, quel que soit le temps de réponse. Cette préférence de routage présente le délai de réponse le plus long (latence la plus élevée).

Lorsque vous définissez la préférence de routage TRAFFIC_AWARE_OPTIMAL, le service calcule l'itinéraire en tenant compte des conditions de circulation actuelles, mais n'applique pas d'optimisations des performances. Dans ce mode, le serveur effectue une recherche plus exhaustive du réseau routier pour trouver l'itinéraire optimal.

La préférence de routage TRAFFIC_AWARE_OPTIMAL équivaut au mode utilisé par maps.google.com et par l'application mobile Google Maps.

Lorsque vous utilisez cette option avec Compute Route Matrix, le nombre d'éléments dans une requête (nombre d'origines x nombre de destinations) est limité. Pour en savoir plus sur les limites de Compute Route Matrix, consultez Calculer une matrice d'itinéraires.

Voici les réponses que vous verrez :

• duration : heure d'arrivée prévue pour l'itinéraire, en tenant compte des informations sur le trafic en temps réel.

• staticDuration : heure d'arrivée prévue pour l'itinéraire en ne tenant compte que des informations de l'historique du trafic.

Définir l'heure de départ (facultatif)

N'utilisez cette propriété que pour les requêtes tenant compte du trafic, où l'heure de départ doit être définie sur une date future. Si vous ne définissez pas la propriété departureTime, elle est définie par défaut sur l'heure à laquelle vous effectuez la requête.

Utilisez la propriété departureTime avec les options TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL lorsque vous souhaitez ajuster la façon dont le service prédit le trafic lors du choix d'un itinéraire.

• TRAFFIC_UNAWARE : Non recommandé, car l'itinéraire et la durée sont déterminés en fonction du réseau routier et des conditions de circulation moyennes toutes heures confondues.

• TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL : recommandé pour les départs imminents, car ces préférences tiennent compte des conditions de circulation en temps réel. Plus departureTime est proche de l'heure actuelle, plus la circulation en temps réel devient importante et pertinente. Plus l'heure de départ est éloignée dans le futur, plus les conditions de circulation historiques sont prises en compte dans la sélection des itinéraires.

Exemple : Sélectionner le routage tenant compte du trafic

Le code JSON suivant montre comment définir la préférence de routage TRAFFIC_AWARE_OPTIMAL dans le corps d'entité d'un message de requête.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":37.417670,
        "longitude":-122.079595
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}