指定要避免的路线特征

欧洲经济区 (EEA) 开发者

如果您的账单邮寄地址在欧洲经济区，自 2025 年 7 月 8 日起，您在使用服务时需遵守 Google Maps Platform EEA 服务条款。具体功能因地区而异。 了解详情。

注意： Routes API 的“计算路线矩阵”功能不支持避开路线功能。

您可以通过向请求添加路线修改器来指定要避免的路线特征，例如避开收费站或高速公路。然后，该 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,
  }
}