规划路线

本产品或功能目前为正式发布前的预览版。正式发布前的产品和功能获得的支持可能较为有限，对其做出的更改可能不兼容其他正式发布前的版本。正式发布前的产品或功能受《Google Maps Platform 服务专用条款》约束。如需了解详情，请参阅发布阶段说明。

在确定网约车行程的最佳路线时，最快的路线可能并不总是最佳选择。您可能需要规划路线。

Routes Preferred API 可让您使用 ComputeCustomRoutes 方法指定路线目标，从而规划路线。

ComputeCustomRoutes 方法还可以帮助您确保路线合规性，让您尽可能缩小运营商选择的路线与实际行驶路线之间的差异。

同时使用 Routes Preferred API 和 Navigation SDK，充分发挥路线规划的优势。

注意：您不必为 Routes Preferred API 和 Navigation SDK 使用相同的云项目。

注意：与 ComputeRoutes API 不同，ComputeCustomRoutes 仅支持两种出行模式：DRIVE（或等效的 TRAVEL_MODE_UNSPECIFIED）和 TWO_WHEELER。此方法也不支持 via 中间航点。 如果您尝试使用其他出行方式或 via 途经点，请求会失败。如需详细了解 via 航点，请参阅 Routes Preferred API 航点。

启用 ComputeCustomRoutes 方法

您必须先启用 ComputeCustomRoutes 方法，然后才能在代码中使用该方法。如需详细了解如何启用 Routes Preferred API 方法，请参阅使用入门。

重要提示： 请查看 Routes Preferred API 方法的配额限制。如果您需要提高配额限制，请在 Google Cloud 控制台的 Google Maps Platform 支持页面上提交支持请求，或拨打 Google Cloud 支持热线与支持团队联系。

使用 ComputeCustomRoutes 方法

ComputeCustomRoutes 方法要求您在输入中指定响应字段掩码。您可以使用网址参数 $fields 或 fields 提供响应字段掩码，也可以使用 HTTP/gRPC 标头 X-Goog-FieldMask。如需了解详情，请参阅系统参数。

字段掩码值是以英文逗号分隔的字段路径列表。每个字段路径都是一个以英文句点分隔的字段名称列表，表示消息层次结构。字段名称可以是 JSON 对象键，也可以是 protobuf 字段标记名称。字段路径从顶级响应消息类型开始，可以选择性地后跟一个或多个点，然后是下一级字段名称。一般来说，字段路径的构建方式如下：

topLevelField[.secondLevelField][.thirdLevelField][...]

一种特殊情况的字段掩码是通配符“*”，它会选择所有根级字段。

如需了解详情，请参阅：

• gRPC API 参考文档
• REST API 参考文档

如需查看使用 ComputeCustomRoutes 方法的示例，请参阅计算自定义路线（Beta 版）示例。

计算通行费

如需了解如何计算过路费，请参阅计算过路费。

如需查看计算过路费的示例，请参阅计算自定义路线示例。