Indiquez comment et si vous souhaitez inclure les 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. Lorsque vous faites une demande, vous devez déterminer il est préférable de renvoyer les résultats les plus précis possibles, 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.

Attention :Les requêtes qui utilisent TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL sont facturées à un taux plus élevé. En savoir plus sur la facturation

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

L'API Routes fournit RoutingPreference (REST) et RoutingPreference (gRPC) qui vous permettent de spécifier les préférences de routage pour le calcul des routes. Ces préférences diffèrent dans la mesure où elles prennent en compte les conditions de circulation dans le calcul d'itinéraire. Chaque préférence de routage produit des résultats différents en ce qui concerne la qualité des routes, l'heure d'arrivée prévue estimée et la latence de réponse.

Les conditions de circulation définissent la vitesse de circulation. Exemple :

• En l'absence de congestion, les conditions de circulation sont considérées comme normales et le trafic circule à la vitesse normale sans entrave.
• À l'approche de l'heure de pointe, la densité du trafic augmente, ce qui entraîne ralentissent, entraînant des conditions de circulation faibles à modérées.
• Dans un embouteillage, le débit est presque nul, ce qui entraîne des conditions de circulation difficiles.

Trafic inconnu

Lorsque vous définissez la préférence de routage TRAFFIC_UNAWARE, les routes sont calculées sans tenir compte des conditions de circulation actuelles. Cette préférence de routage fournit la latence de réponse la plus faible (les réponses sont renvoyées le plus rapidement).

TRAFFIC_UNAWARE est le paramètre par défaut.

Si vous choisissez TRAFFIC_UNAWARE, l'itinéraire et la durée choisis sont basés sur le réseau routier et la durée moyenne les conditions de circulation, et non 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.

Dans la réponse :

• L'heure d'arrivée prévue est contenue dans la propriété de réponse duration.

• Les propriétés de réponse duration et staticDuration contiennent les mêmes .

Utilisez cette préférence de calcul d'itinéraire lorsque vous souhaitez que les réponses soient renvoyées le plus rapidement possible et que les détails d'itinéraire approximatifs suffisent.

Remarque : Ce paramètre équivaut à l'absence de trafic actuel dans les API Directions et Distance Matrix.

Sensible au trafic

Lorsque vous définissez la préférence de routage TRAFFIC_AWARE, les itinéraires sont calculés en tenant compte des conditions de circulation actuelles. Par conséquent, l'itinéraire et le routage les détails reflètent plus précisément les conditions du monde réel. Étant donné que cette augmentation 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.

Dans la réponse :

• L'heure d'arrivée prévue qui prend en compte le trafic en temps réel est contenue dans le champ Propriété de réponse duration.

• La propriété de réponse staticDuration contient la durée du trajet sur l'itinéraire, sans tenir compte des conditions de circulation.

Utilisez cette préférence de routage lorsque vous souhaitez obtenir des informations de routage plus précises que TRAFFIC_UNAWARE, mais que vous n'êtes pas gêné si les réponses sont renvoyées avec une augmentation modérée de la latence.

Remarque : Ce paramètre est nouveau pour l'API Routes et n'a pas d'équivalent dans les API Directions et Distance Matrix.

Routage optimal tenant compte du trafic

Lorsque vous définissez la préférence de calcul d'itinéraire TRAFFIC_AWARE_OPTIMAL, les itinéraires sont calculés en tenant compte des conditions de circulation actuelles, mais aucune optimisation des performances n'est appliquée. 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 est équivalente au mode utilisé par sur maps.google.com et par Application mobile Google Maps

Lorsque vous utilisez cette option avec Compute Route Matrix, le nombre de dans une requête (nombre d'origines × nombre de destinations) ne peut pas dépasser 100. Pour en savoir plus sur les limites de Compute Routes Matrix, consultez la section Calculer une matrice de calcul de routes.

Dans la réponse :

• L'heure d'arrivée prévue qui prend en compte le trafic en temps réel est contenue dans le champ Propriété de réponse duration.

• La propriété de réponse staticDuration contient la durée du voyage. sur l'itinéraire sans tenir compte des conditions de circulation.

Cette préférence de routage offre la latence de réponse la plus élevée (c'est-à-dire que les réponses sont renvoyées avec le délai le plus long). Utilisez cette préférence de routage lorsque vous souhaitent obtenir des résultats de la meilleure qualité possible, quelle que soit la durée des réponses.

Remarque :Cette option équivaut à spécifier departure_time dans la propriété API Directions et Distance Matrix

Effet de la définition de l'heure de départ

Vous pouvez éventuellement utiliser la propriété departureTime pour définir l'heure de départ d'un voyage. Si vous ne définissez pas la propriété departureTime, elle est définie par défaut sur au moment de la demande.

• Pour TRAFFIC_UNAWARE, vous ne pouvez pas définir departureTime, car le choix de l'itinéraire et de la durée est basé sur le réseau routier et les conditions de circulation moyennes toutes heures confondues.

• Pour TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL, qui tiennent compte des conditions de trafic en temps réel, le trafic en temps réel devient plus important à mesure que departureTime se rapproche de l'heure actuelle. Plus vous définissez l'heure de départ dans le futur, plus les conditions de circulation historiques sont prises en compte.

Exemple de définition des préférences de routage

Le code JSON suivant montre comment définir la préférence de routage dans le corps d'une entité de 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"
}

Configurer le trafic sur les polylignes

L'API Routes vous permet de demander des informations sur les conditions de circulation le long d'une polyligne tenant compte du trafic. Voir Pour en savoir plus, demandez des polylignes.