调整路线偏好设置

路线计算（包括重新路线规划）会将导航时间最短的路线作为默认最佳路线返回。不过，您可以更改路由策略，以便系统改为返回路线选项中的较短路线。

更短是指根据默认费用模型，在所有最佳路线中距离最短的路线。较短的路线可能不是绝对最短的路线，因为该选项可能不是一个好的替代方案。例如，如果绝对最短路线为 10 公里，需要 50 分钟导航，而另一条路线为 15 公里，但只需 20 分钟导航，则第二种选择是最佳选择，因为花费 30 分钟缩短 5 公里的路程不是一个好的权衡。

为行程设置路线策略后，除非行程结束，否则该策略不会发生变化。如需更改现有行程的路线策略，您必须清除目的地，然后使用新的路线策略重新设置目的地。

获取路线详情

如需确定哪种路线策略是给定航点的最佳选择，请调用 getRouteInfo() 以获取默认最佳路线和绝对更短路线的路线详细信息。详细信息包括时长和到达目的地航点的距离。

这些详细信息来自 RouteInfo，并在 ListenableResultFuture 中返回。

示例

以下代码示例演示了如何获取这两种路由策略的路线详细信息。

ListenableResultFuture<RouteInfo> routeInfoFuture =
        navigator.getRouteInfo(waypoint, routingOptions);

设置路由策略

您可以在调用 setDestinations() 时设置 RoutingOptions.routingStrategy 来配置路由策略。

RoutingOptions.routingStrategy 采用以下枚举值之一：

枚举值说明
RoutingStrategy.DEFAULT_BEST 根据 Navigation SDK 的默认费用模型对路线进行排名。这是默认的路由策略。
RoutingStrategy.SHORTER 按距离对路线进行排名。排名最高的路线是返回的路线中最短的路线。

示例

以下代码示例演示了如何设置更短路线偏好设置。

RoutingOptions routingOptions = new RoutingOptions();
routingOptions.routingStrategy(RoutingStrategy.SHORTER);
navigator.setDestinations(destinations, routingOptions, displayOptions);

包含轮渡的路线

默认情况下，NavSDK 会排除包含渡轮的路线。如果您希望在路线中包含渡轮选项，可以将 avoidFerries 设置为 false，以调整此路线偏好设置，以便将行程显示为渡轮路段。

示例

RoutingOptions routingOptions = new RoutingOptions().avoidFerries(true);
// Add additional routing preferences
navigator.setDestination(destination, routingOptions);

路线宣传信息格式

在“更短路线”偏好设置下，路线沿途的宣传信息会显示距离详情。不过，您可以改用预计到达时间宣传信息。

配置路线宣传信息格式

您可以在 NavigationView（或 NavigationFragment）中调用 setRouteCalloutInfoFormat 来更改路线宣传信息格式。setRouteCalloutInfoFormat 采用以下枚举值之一：

枚举值说明
RouteCalloutInfoFormat.DEFAULT 显示使用默认最佳路线路由策略时剩余的时间。显示使用更短路线路由策略时剩余的距离。
RouteCalloutInfoFormat.TIME 显示剩余时间。
RouteCalloutInfoFormat.DISTANCE 显示剩余距离。

示例

以下代码示例演示了如何配置路线宣传信息格式。

mNavFragment.setRouteCalloutInfoFormat(RouteCalloutInfoFormat.TIME);