启用精细数据 Feed

精细导航数据 Feed 可向未设计为基于地图的导航指导的设备提供仅限导航的信息。它会根据您提供的元素提供即将到来的机动：

  • 图标（左转、右转、掉头）
  • 环岛中的数字
  • 道路名称
  • 到下一个导航步骤或最终目的地的估计距离和时间

您可以使用逐向导航 Feed 来创建不适合使用完整 Navigation SDK 界面的体验，例如 Android Auto 或无法使用完整 Android 堆栈的小屏幕显示屏。例如，您可能会针对两轮车辆驾驶员使用此功能，仅投影导航指导，帮助他们更快、更自信地到达目的地，同时尽可能减少干扰。

如需使用该 SDK，您需要创建一个服务并将其注册到 Navigation SDK for Android，以便该服务能够实时接收新的导航信息（在导航期间大约每秒一次）。

本文档介绍了如何创建和注册导航服务，该服务可从 SDK 接收导航信息，并将导航状态提供给接收设备。

概览

本部分总结了启用逐向导航功能的高级流程。

使用 TurnByTurn 功能

以下是启用逐向导航功能的简要步骤。以下各部分详细介绍了每个步骤。

  1. 创建用于接收导航更新的服务。

  2. 注册服务。

  3. 了解导航状态。

创建用于接收导航更新的服务

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 的引导卡片的视觉和文本元素。

一个手机屏幕，显示前方 100 英尺处即将左转进入 W Ahwanee 大道。屏幕底部显示到达目的地剩余时间为 46 分钟，剩余距离为 39 英里。

当用户进入引导式导航模式时，顶部会显示一个导航卡片，其中包含从 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

使用生成的图标

由 Navigation SDK 提供的一小部分生成的图标。

为了方便 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 字段。

后续步骤