调整路线偏好设置

路线计算(包括重新规划)将返回用最短导航时间作为默认最佳路线的路线。不过,您可以更改路线策略,改为返回较短的备选路线。

“较短”一词是指根据默认费用模型计算的最佳路由中最短的路线。较短的路线可能不是绝对最短路线,因为该选项可能不是更好的替代方案。例如,如果绝对最短路线为 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);