规划路线

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

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

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

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

启用 ComputeCustomRoutes 方法

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

使用 ComputeCustomRoutes 方法

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

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

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

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

如需了解详情，请参阅：

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

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

计算通行费

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

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