L'API Routes Preferred fournit trois préférences de routage pour le calcul des routes. Elles diffèrent dans la mesure où 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é des itinéraires, d'heure d'arrivée prévue estimée et de latence de réponse.
À propos des conditions de circulation
Les conditions de circulation décrivent le taux de circulation. Exemple :
En l'absence d'embouteillages, les conditions de circulation sont considérées comme normales et le trafic s'écoule à la vitesse normale, sans entrave.
À l'approche des heures de pointe, la densité du trafic augmente, ce qui ralentit le trafic et génère des conditions de circulation faibles à modérées.
Dans un trafic de type bumper à bumper, le débit s'arrête, ce qui génère des conditions de circulation denses.
Sans tenir compte du trafic
Lorsque vous définissez la préférence de routage TRAFFIC_UNAWARE, les routes sont calculées sans tenir compte des conditions de trafic. Cette préférence de routage fournit la latence de réponse la plus faible (les réponses sont renvoyées le plus rapidement).
Utilisez cette préférence de routage si vous souhaitez que les réponses soient renvoyées le plus rapidement possible et que les informations de routage approximatives soient suffisantes.
Compatible avec le trafic
Lorsque vous définissez la préférence de routage pour 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 et que cela ne vous dérange pas que des réponses soient renvoyées avec une augmentation modérée de la latence.
Optimisé pour la détection 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 sur le réseau routier afin de 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 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é, quel que soit le délai de réponse.
Exemple
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"
}