L'API Routes Preferred propose trois préférences de calcul des itinéraires. Elles 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 calcul d'itinéraire produit des résultats qui diffèrent dans une certaine mesure en termes de qualité de l'itinéraire, de l'heure d'arrivée estimée et de la 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 circule à la vitesse normale sans entrave.
À l'approche de l'heure de pointe, la densité du trafic augmente, ce qui ralentit le trafic, produisant des conditions de circulation légères à 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 calcul d'itinéraire 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 possible).
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.
Prise en compte du trafic
Lorsque vous définissez la préférence d'itinéraire 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 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.
Utilisez cette préférence de calcul d'itinéraire lorsque vous souhaitez obtenir des informations de calcul d'itinéraire plus précises, mais que vous n'êtes pas gêné si les réponses sont renvoyées avec une augmentation modérée de la latence.
Routage optimal tenant compte du trafic
Lorsque vous définissez la préférence d'itinéraire 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, 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 de la durée des réponses.
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"
}