指定要避開的路線功能

注意： Routes API 的 Compute Route Matrix 功能不支援避免路徑功能。

您可以在要求中加入路線修飾符，指定要避免使用哪些路線地圖項目，例如避開收費站或高速公路。然後 API 會嘗試提供不需要這些功能的路徑。

在要求中使用 routeModifiers 屬性 (類型為 RouteModifiers)。您可以指定 avoidTolls、avoidHighways、avoidFerries 和 avoidIndoor。

注意： routeModifiers 屬性支援其他選項，包括 vehicleInfo 和 tollPasses。如要進一步瞭解 vehicleInfo，請參閱「取得環保路徑」一文。如要進一步瞭解 tollPasses，請參閱計算路線的過路費。

指定路徑修飾符不一定會排除包含受限制地圖項目的路徑。API 會使用修飾符，將結果自訂調整至較喜愛的路徑。有幾個原因可能會導致要求避開選項的選項並未變更路線。例如，從起點到目的地的唯一路線，無法避開高速公路或渡輪。或者，替代路線實際上會大幅延長交通時間。

以下範例說明如何在 computeRoutes 方法 (REST) 要求主體中設定路徑修飾符。您也可以使用 ComputeRoutes 方法 (gRPC) 指定這個選項。在這個範例中，您可以指定避開收費路段和高速公路：

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":37.417670,
        "longitude":-122.079595
      }
    }
  },
  "routeModifiers": {
    "avoidTolls": true,
    "avoidHighways": true,
  }
}