L'API Routes Preferred propose trois préférences de routage pour calculer les itinéraires. Elles diffèrent par la mesure dans laquelle elles prennent en compte les conditions de circulation dans le calcul de l'itinéraire. Chaque préférence de routage produit des résultats qui diffèrent dans une certaine mesure en termes de qualité de l'itinéraire, d'heure d'arrivée prévue et de latence de réponse.
À propos des conditions de circulation
Les conditions de circulation caractérisent le débit du trafic. Exemple :
En l'absence d'embouteillages, les conditions de circulation sont considérées comme normales et le trafic s'écoule à la vitesse habituelle, sans entrave.
À l'approche des heures de pointe, la densité du trafic augmente, ce qui ralentit la circulation et entraîne des conditions de circulation légères à modérées.
Dans un trafic très dense, le débit s'arrête, ce qui entraîne des conditions de circulation difficiles.
Sans prise en compte du trafic
Lorsque vous définissez la préférence de routage TRAFFIC_UNAWARE, les itinéraires sont calculés sans tenir compte des conditions de circulation. Cette préférence de routage offre la latence de réponse la plus faible (les réponses sont renvoyées le plus rapidement).
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.
Prise en compte du 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. 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 des réponses, des optimisations des performances sont appliquées pour réduire une grande partie de la latence.
Utilisez cette préférence d'itinéraire lorsque vous souhaitez obtenir des détails d'itinéraire plus précis, et que vous acceptez que les réponses soient renvoyées avec une augmentation modérée de la latence.
Optimal en fonction du trafic
Lorsque vous définissez la préférence de routage TRAFFIC_AWARE_OPTIMAL, les itinéraires sont calculés en tenant compte des conditions de circulation, 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.
Cette préférence de routage fournit 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 souhaitez obtenir des résultats de la plus haute qualité, sans tenir compte du temps de réponse.
Exemple
Le code JSON suivant montre comment définir la préférence de routage 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" }