Specifica le caratteristiche del percorso da evitare
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Sviluppatori nello Spazio economico europeo (SEE)
Puoi specificare le caratteristiche del percorso che preferisci evitare, ad esempio pedaggi o autostrade, aggiungendo modificatori del percorso a una richiesta. L'API tenta quindi di fornire un percorso che non richiede queste funzionalità.
Utilizza la proprietà routeModifiers in una richiesta di tipo
RouteModifiers. Puoi specificare avoidTolls,
avoidHighways, avoidFerries e avoidIndoor.
La specifica di un modificatore di percorso non elimina necessariamente i percorsi che includono la funzionalità limitata. L'API utilizza il modificatore per orientare il risultato verso percorsi più favorevoli. Esistono diversi motivi per cui la richiesta di un'opzione di evitamento
non modifica il percorso. Ad esempio, l'unico percorso dall'origine alla destinazione rende impossibile evitare un'autostrada o un traghetto. In alternativa, il percorso alternativo prolunga notevolmente il tempo di percorrenza.
L'esempio seguente mostra come impostare i modificatori di route nel corpo della richiesta di un metodo (REST) computeRoutes. Puoi anche specificare questa opzione al metodo ComputeRoutes (gRPC). In questo esempio, specifichi di evitare pedaggi e autostrade:
[null,null,["Ultimo aggiornamento 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```"]]
