精细导航数据 Feed 可向未设计为基于地图的导航指导的设备提供仅限导航的信息。它会根据您提供的元素提供即将到来的机动:
- 图标(左转、右转、掉头)
- 环岛中的数字
- 道路名称
- 到下一个导航步骤或最终目的地的估计距离和时间
您可以使用逐向导航 Feed 来创建不适合使用完整 Navigation SDK 界面的体验,例如 Android Auto 或无法使用完整 Android 堆栈的小屏幕显示屏。例如,您可能会针对两轮车辆驾驶员使用此功能,仅投影导航指导,帮助他们更快、更自信地到达目的地,同时尽可能减少干扰。
如需使用该 SDK,您需要创建一个服务并将其注册到 Navigation SDK for Android,以便该服务能够实时接收新的导航信息(在导航期间大约每秒一次)。
本文档介绍了如何创建和注册导航服务,该服务可从 SDK 接收导航信息,并将导航状态提供给接收设备。
概览
本部分总结了启用逐向导航功能的高级流程。
使用 TurnByTurn 功能
以下是启用逐向导航功能的简要步骤。以下各部分详细介绍了每个步骤。
创建用于接收导航更新的服务
Navigation SDK 会绑定到您的 TurnByTurn 服务,并通过 Android Messenger 向其发送导航更新。您可以为这些更新创建新的导航服务,也可以使用现有服务。
使用服务接收导航更新的好处是,该服务可以驻留在单独的后台进程中。
以下示例中的服务接收导航信息,并使用 TurnByTurnManager
将数据转换为包含导航详细信息的 NavInfo
对象。
/** * Receives turn-by-turn navigation information forwarded from NavSDK. */ public class NavInfoReceivingService extends Service { /** The messenger used by the service to receive nav step updates. */ private Messenger incomingMessenger; private TurnByTurnManager turnByTurnManager; private final class IncomingNavStepHandler extends Handler { public IncomingNavStepHandler(Looper looper) { super(looper); } @Override public void handleMessage(Message msg) { // Identify the message through the msg.what field. if (TurnByTurnManager.MSG_NAV_INFO == msg.what) { // Extract the NavInfo object using the TurnByTurnManager. NavInfo navInfo = turnByTurnManager .readNavInfoFromBundle(msg.getData())); // Do something with the NavInfo } } } @Nullable @Override public IBinder onBind(Intent intent) { return incomingMessenger.getBinder(); } @Override public void onCreate() { turnByTurnManager = TurnByTurnManager.createInstance(); HandlerThread thread = new HandlerThread("NavInfoReceivingService", Process.THREAD_PRIORITY_DEFAULT); thread.start(); incomingMessenger = new Messenger( new IncomingNavStepHandler(thread.getLooper())); }
消息代码
可以通过 Message
类的 Message.what 字段(设置为 TurnByTurnManager.MSG_NAV_INFO
的值)来识别 NavInfo
消息。
注册服务以接收导航更新
以下代码段注册了导航服务。
boolean isNavInfoReceivingServiceRegistered = navigator.registerServiceForNavUpdates( getPackageName(), NavInfoReceivingService.class.getName(), numNextStepsToPreview);
启动和停止服务
只要 Navigation SDK 绑定到导航服务,该服务就会处于活跃状态。您可以手动调用 startService()
和 stopService()
来控制导航服务生命周期,但当您向 Navigation SDK 注册服务时,服务会自动启动,并且只有在您取消注册时才会停止。根据应用的设置方式,您可能需要考虑启动前台服务,如 Android 文档服务概览中所述。
取消注册服务
如需停止接收导航更新,请从 Navigation SDK 中取消注册该服务。
navigator.unregisterServiceForNavUpdates();
了解导航状态
使用 NavInfo.getNavState()
获取导航的当前状态,该状态是以下状态之一:
在途 -
ENROUTE
状态表示引导式导航处于有效状态,并且用户正在按照提供的路线行驶。有关当前即将到来的机动步骤的信息。重新规划路线 -
REROUTING
表示导航正在进行中,但导航器正在寻找新路线。由于尚无新路线,因此无法提供即将到来的机动步骤。在示例应用中,导航信息显示界面会显示“正在重新规划路线…”消息。找到路线后,系统会发送一条包含状态ENROUTE
的NavInfo
消息。已停止 -
STOPPED
表示导航已结束。例如,当用户在应用中退出导航时,导航会停止。在示例应用中,STOPPED
状态会清除导航信息显示,以防止显示残留的路线指引。
填充 Feed 显示
现在,您已设置好逐向导航服务,本部分将介绍可用于填充逐向导航 Feed 的引导卡片的视觉和文本元素。
导航卡信息字段
当用户进入引导式导航模式时,顶部会显示一个导航卡片,其中包含从 Navigation SDK 填充的导航数据。相关图片显示了这些基本导航元素的示例。
下表显示了导航信息的字段以及这些字段的显示位置。
每个导航步骤的字段 | 整个行程的字段 |
---|---|
在 StepInfo 中发现 |
在 NavInfo 中发现 |
完整道路名称 | 剩余时间 |
机动动作图标 | 与目的地之间的距离 |
到下一步的距离 | |
车道引导字段 |
车道导航
Navigation SDK 将导航转向卡片中的车道表示为 Lane 和 LaneDirection 数据对象。Lane
对象表示导航期间的特定车道,并包含一个 LaneDirection
对象列表,用于描述可从该车道进行的所有转弯。
车道中用户应采取的建议方向由 isRecommended 字段标记。
车道导航示例
以下代码段展示了上述泳道的数据表示形式。
// Lane 1
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false},
{/*laneShape=*/ SLIGHT_LEFT, /*isRecommended=*/ true}]
// Lane 2
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false}]
为机动动作创建图标
Maneuver
枚举定义了导航时可能发生的每种机动动作,您可以通过 StepInfo.getManeuver()
方法获取给定步的机动动作。
您必须创建机动图标,并将其与关联的机动配对。
对于某些动作,您可以设置与图标的一对一映射,例如 DESTINATION_LEFT
和 DESTINATION_RIGHT
。不过,由于某些操作类似,您可能希望将多个操作映射到单个图标。例如,TURN_LEFT
和 ON_RAMP_LEFT
都可以映射到左转图标。
某些机动动作包含额外的 clockwise
或 counterclockwise
标签,SDK 会根据国家/地区的驾驶侧来确定这些标签。例如,在靠左行驶的国家/地区,驾驶员会以顺时针方向绕环岛或掉头,而在靠右行驶的国家/地区,驾驶员则会以逆时针方向绕环岛或掉头。Navigation SDK 会检测到机动动作是在左侧通行还是右侧通行的情况下发生的,并输出相应的机动动作。因此,顺时针机动与逆时针机动的机动图标可能会有所不同。
展开即可查看不同操作的示例图标
图标示例 | 逐向导航操作 |
---|---|
![]() |
DEPART UNKNOWN |
![]() |
STRAIGHT ON_RAMP_UNSPECIFIED OFF_RAMP_UNSPECIFIED NAME_CHANGE
|
![]() |
TURN_RIGHT ON_RAMP_RIGHT
|
![]() |
TURN_LEFT ON_RAMP_LEFT
|
![]() |
TURN_SLIGHT_RIGHT ON_RAMP_SLIGHT_RIGHT OFF_RAMP_SLIGHT_RIGHT
|
![]() |
TURN_SLIGHT_LEFT ON_RAMP_SLIGHT_LEFT OFF_RAMP_SLIGHT_LEFT
|
![]() |
TURN_SHARP_RIGHT ON_RAMP_SHARP_RIGHT OFF_RAMP_SHARP_RIGHT
|
![]() |
TURN_SHARP_LEFT ON_RAMP_SHARP_LEFT OFF_RAMP_SHARP_LEFT
|
![]() |
TURN_U_TURN_COUNTERCLOCKWISE ON_RAMP_U_TURN_COUNTERCLOCKWISE OFF_RAMP_U_TURN_COUNTERCLOCKWISE
|
![]() |
TURN_U_TURN_CLOCKWISE ON_RAMP_U_TURN_CLOCKWISE OFF_RAMP_U_TURN_CLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_STRAIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_U_TURN_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_U_TURN_CLOCKWISE
|
![]() |
ROUNDABOUT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_CLOCKWISE
|
![]() |
ROUNDABOUT_EXIT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_EXIT_CLOCKWISE
|
![]() |
MERGE_RIGHT OFF_RAMP_RIGHT
|
![]() |
MERGE_LEFT OFF_RAMP_LEFT
|
![]() |
FORK_RIGHT TURN_KEEP_RIGHT ON_RAMP_KEEP_RIGHT OFF_RAMP_KEEP_RIGHT
|
![]() |
FORK_LEFT TURN_KEEP_LEFT ON_RAMP_KEEP_LEFT OFF_RAMP_KEEP_LEFT
|
![]() |
MERGE_UNSPECIFIED
|
![]() |
DESTINATION
|
![]() |
DESTINATION_RIGHT
|
![]() |
DESTINATION_LEFT
|
![]() |
FERRY_BOAT
|
![]() |
FERRY_TRAIN
|
使用生成的图标
为了方便 Android Auto 用例,Navigation SDK 支持生成机动和车道引导图标。这些图标符合 Android Auto 汽车应用库的图片尺寸调整指南,该指南建议将目标定位到 500 x 74 dp 的边界框。如需了解详情,请参阅 Android 参考文档中的 setsLaneImage 和 CarIcon。
图标生成示例
NavigationUpdatesOptions options =
NavigationUpdatesOptions.builder()
.setNumNextStepsToPreview(numNextStepsToPreview)
.setGeneratedStepImagesType(GeneratedStepImagesType.BITMAP)
.setDisplayMetrics(getResources().getDisplayMetrics())
.build();
boolean isRegistered =
navigator.registerServiceForNavUpdates(
getPackageName(),
NavInfoReceivingService.class.getName(),
options);
启用图标生成功能后,TurnbyTurn StepInfo
对象会使用图标填充 maneuverBitmap 和 lanesBitmap 字段。
后续步骤
- 对于 Android Auto 应用: