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 trafic 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 estimée 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 de congestion, les conditions de circulation sont considérées comme normales et le trafic se déroule à la vitesse normale sans entrave.
À l'approche de l'heure de pointe, la densité du trafic augmente, ce qui le ralentit et entraîne des conditions de circulation légères à modérées.
Dans un embouteillage, le débit est à l'arrêt, ce qui entraîne des conditions de trafic dense.
Sans info 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 trafic. Cette préférence de routage offre la latence de réponse la plus faible (les réponses sont renvoyées le plus rapidement possible).
Utilisez cette préférence de routage lorsque vous souhaitez obtenir les réponses le plus rapidement possible et que des informations de routage approximatives vous suffisent.
Trafic pris en compte
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 ses détails 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 de routage lorsque vous souhaitez obtenir des informations de routage plus précises, mais que vous acceptez que les réponses soient renvoyées avec une latence légèrement plus élevée.
Routage optimal prenant en compte le 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 offre la latence de réponse la plus élevée (c'est-à-dire que les réponses reviennent 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" }