Spécifier les éléments géographiques de l'itinéraire à éviter
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Développeurs situés dans l'Espace économique européen (EEE)
Vous spécifiez les éléments d'itinéraire que vous préférez éviter, comme les péages ou les autoroutes, en ajoutant des modificateurs d'itinéraire à une requête. L'API tente ensuite de fournir un itinéraire qui ne nécessite pas ces fonctionnalités.
Utilisez la propriété routeModifiers dans une requête de type RouteModifiers. Vous pouvez spécifier avoidTolls, avoidHighways, avoidFerries et avoidIndoor.
Spécifier un modificateur d'itinéraire n'élimine pas nécessairement les itinéraires qui incluent l'élément géographique soumis à des restrictions. L'API utilise le modificateur pour biaiser le résultat vers des itinéraires plus favorables. Plusieurs raisons peuvent expliquer pourquoi la demande d'une option d'évitement ne modifie pas votre itinéraire. Par exemple, le seul itinéraire entre le point de départ et la destination ne permet pas d'éviter une autoroute ou un ferry. Ou le trajet de substitution prolonge-t-il considérablement le temps de trajet ?
L'exemple suivant montre comment définir des modificateurs de parcours dans le corps de requête de la méthode computeRoutes (REST). Vous pouvez également spécifier cette option à la méthode ComputeRoutes (gRPC). Dans cet exemple, vous spécifiez d'éviter les péages et les autoroutes:
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/06/20 (UTC).
[null,null,["Dernière mise à jour le 2025/06/20 (UTC)."],[[["\u003cp\u003eThe Routes API's Compute Route Matrix feature does not support avoiding route features.\u003c/p\u003e\n"],["\u003cp\u003eYou can request routes that avoid tolls, highways, ferries, and indoor travel using the \u003ccode\u003erouteModifiers\u003c/code\u003e property.\u003c/p\u003e\n"],["\u003cp\u003eWhile route modifiers bias the results, they may not eliminate the specified features if alternatives are unavailable or significantly increase travel time.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify route modifiers in both REST and gRPC requests, using the \u003ccode\u003eavoidTolls\u003c/code\u003e, \u003ccode\u003eavoidHighways\u003c/code\u003e, \u003ccode\u003eavoidFerries\u003c/code\u003e, and \u003ccode\u003eavoidIndoor\u003c/code\u003e fields within the \u003ccode\u003erouteModifiers\u003c/code\u003e property.\u003c/p\u003e\n"]]],["Route modifiers, set in the `routeModifiers` property of a request, allow users to express preferences for avoiding tolls, highways, ferries, or indoor routes. The `Compute Route Matrix` feature does not support avoiding route features. Modifiers bias the route calculation, but do not guarantee avoidance. `routeModifiers` also supports `vehicleInfo` and `tollPasses`. The API might include the feature to be avoided if no practical alternative exists. An example in a `computeRoutes` request demonstrates setting `avoidTolls` and `avoidHighways` to `true`.\n"],null,["# Specify route features to avoid\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n| **Note:** Avoiding route features is not supported by the Compute Route Matrix feature of the Routes API.\n\nYou specify which route features you prefer to avoid, such as avoiding tolls or\nhighways, by adding *route modifiers* to a request. The API then attempts to\nprovide a route that does not require those features.\n\nUse the `routeModifiers` property in a request, of type\n[RouteModifiers](/maps/documentation/routes/reference/rest/v2/RouteModifiers). You can specify `avoidTolls`,\n`avoidHighways`, `avoidFerries`, and `avoidIndoor`.\n| **Note:** The `routeModifiers` property supports additional options, including `vehicleInfo` and `tollPasses`. For more on `vehicleInfo`, see [Get an eco-friendly route](/maps/documentation/routes/eco-routes). For more on `tollPasses`, see [Calculate toll fees for a route](/maps/documentation/routes/calculate_toll_fees).\n\nSpecifying a route modifier does not necessarily eliminate routes that include\nthe restricted feature. The API uses the modifier to bias the result to more\nfavorable routes. There can be a few reasons why requesting an avoidance option\ndoesn't change your route. For example, the only route from the origin to the\ndestination makes it impossible to avoid a highway or ferry. Or, the alternate\nroute actually lengthens travel time significantly.\n\nThe following example demonstrates how to set route modifiers in a\n[computeRoutes](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes)\nmethod (REST) request body. You can also specify this option to the\n[ComputeRoutes](/maps/documentation/routes/reference/rpc/google.maps.routing.v2#google.maps.routing.v2.Routes.ComputeRoutes)\nmethod (gRPC). In this example, you specify to avoid tolls and highways: \n\n```json\n{\n \"origin\":{\n \"location\":{\n \"latLng\":{\n \"latitude\":37.419734,\n \"longitude\":-122.0827784\n }\n }\n },\n \"destination\":{\n \"location\":{\n \"latLng\":{\n \"latitude\":37.417670,\n \"longitude\":-122.079595\n }\n }\n },\n \"routeModifiers\": {\n \"avoidTolls\": true,\n \"avoidHighways\": true,\n }\n}\n```"]]