L'API Routes Preferred fournit 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 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 un ralentissement et des conditions de circulation légères à modérées.
Dans un trafic pare-chocs à pare-chocs, le débit s'arrête, ce qui entraîne des conditions de circulation denses.
Sans prise en compte du trafic
Lorsque vous définissez la
TRAFFIC_UNAWARE
préférence de routage, 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 de routage lorsque vous souhaitez que les réponses soient renvoyées le plus rapidement possible et que des informations de routage approximatives suffisent.
Avec prise en compte du trafic
Lorsque vous définissez la
TRAFFIC_AWARE
préférence de routage, 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 routage lorsque vous souhaitez obtenir des informations de routage plus précises, mais que vous n'avez pas d'inconvénient à ce que les réponses soient renvoyées avec une augmentation modérée de la latence.
Optimal avec prise en compte du trafic
Lorsque vous définissez la
TRAFFIC_AWARE_OPTIMAL
préférence de routage, 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 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 nécessaire pour renvoyer les réponses.
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" }