启用精细数据 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()));
}

消息代码

NavInfo 消息可以通过 Message 类的 Message.what 字段进行标识，该字段设置为 TurnByTurnManager.MSG_NAV_INFO 的值。

注册服务以接收导航更新

以下代码段会注册导航服务。

boolean isNavInfoReceivingServiceRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(), NavInfoReceivingService.class.getName(), numNextStepsToPreview);

启动和停止服务

只要 Navigation SDK 绑定到导航服务，该服务就会处于活跃状态。您可以手动调用 startService() 和 stopService() 来控制导航服务生命周期，但当您向 Navigation SDK 注册服务时，服务会自动启动，并且仅在您取消注册时才会停止。根据您设置应用的方式，您可能需要考虑启动前台服务，如 Android 文档服务概览中所述。

取消注册服务

如需停止接收导航更新，请从 Navigation SDK 中取消注册该服务。

navigator.unregisterServiceForNavUpdates();

了解导航状态

使用 NavInfo.getNavState() 获取导航的当前状态，该状态为以下状态之一：

• Enroute - ENROUTE 状态表示引导式导航处于活跃状态，并且用户正在按照提供的路线行驶。提供有关当前即将执行的操控步骤的信息。

• Rerouting - REROUTING 表示正在导航，但导航器正在寻找新路线。即将执行的操作步骤不可用，因为还没有新路线。在示例应用中，导航信息显示屏中会显示“正在重新规划路线…”消息。找到路线后，系统会发送一条状态为 ENROUTE 的 NavInfo 消息。

• 已停止 - STOPPED 表示导航已结束。例如，当用户在应用中退出导航时，导航会停止。在示例应用中，STOPPED 状态会清除导航信息显示，以防止显示残留的步骤说明。

填充信息流显示

现在，您已设置好精细导航服务，本部分将介绍可用于填充精细导航 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 会检测车辆是在左侧还是右侧行驶，并输出适当的操作。因此，顺时针和逆时针操作的操作图标可能不同。

使用生成的图标

为了便于 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 应用：
  • 绘制地图并启用导航。