요청에 경로 수정자를 추가하여 통행료 또는 고속도로를 피하는 등 피하려는 경로 지형지물을 지정합니다. 그러면 API는 이러한 기능이 필요하지 않은 경로를 제공하려고 시도합니다.
요청에서 RouteModifiers 유형의 routeModifiers 속성을 사용합니다. avoidTolls, avoidHighways, avoidFerries, avoidIndoor를 지정할 수 있습니다.
경로 수정자를 지정한다고 해서 제한된 지형지물이 포함된 경로가 반드시 제외되는 것은 아닙니다. API는 수정자를 사용하여 결과를 더 유리한 경로로 편향시킵니다. 우회 옵션을 요청해도 경로가 변경되지 않는 데는 몇 가지 이유가 있을 수 있습니다. 예를 들어 출발지에서 목적지로 가는 유일한 경로로 인해 고속도로나 페리를 피할 수 없는 경우입니다. 또는 대체 경로로 인해 이동 시간이 실제로 크게 늘어납니다.
다음 예는 computeRoutes 메서드 (REST) 요청 본문에서 경로 수정자를 설정하는 방법을 보여줍니다. 이 옵션을 ComputeRoutes 메서드 (gRPC)에 지정할 수도 있습니다. 이 예에서는 유료도로와 고속도로를 피하도록 지정합니다.
[null,null,["최종 업데이트: 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```"]]