精细导航数据 Feed 的详细信息

精细导航数据 Feed 会向不适合基于地图的导航指引的设备提供纯导航信息。它会根据您提供的元素提供即将执行的操作：

  • 图标（左转、右转、掉头）
  • 在环形交叉路口转弯
  • 道路名称
  • 到下一个导航步骤或最终目的地的预计距离和时间

您可以使用精细导航 Feed 来打造不适合使用完整 Navigation SDK 界面的体验，例如在小屏幕上显示。例如，您可以将其用于两轮车骑手，向他们投射纯导航指引，帮助他们更快、更自信地到达目的地，同时尽量减少干扰。

基本导航显示元素

手机屏幕上显示，前方 50 英尺处右转进入 Church Street。在屏幕底部，距离目的地还有 13 分钟，剩余距离为 2.1 英里。

每个导航步骤的主要字段包括完整道路名称、操作和步骤的总距离，这些信息可在 GMSNavigationStepInfo 中找到。

对于整个行程，您可能需要显示到当前步骤或目的地的剩余时间和距离，所有这些信息都可以在 GMSNavigationNavInfo 中找到。右侧图片展示了这些基本导航元素的示例。

设置事件监听器

如需使用仅限导航的数据，您必须为 didChangeNavInfo 事件实现事件监听器。在事件监听器中，访问行程和路段信息，以便为用户提供精细导航。

如需实现事件处理脚本，地图的视图控制器必须实现 GMSNavigatorListener 协议。如需详细了解如何在 Navigation SDK for iOS 中处理事件，请参阅监听导航事件。

处理 didChangeNavInfo 事件

为 didChangeNavInfo 事件创建监听器，以便为应用添加精细导航支持。在事件监听器中，使用以下类和枚举来控制精细导航：

下面显示了 didChangeNavInfo 事件的事件监听器示例：

Swift

  // ViewController.swift
  class SomeViewController: UIViewController {
    ...
    mapView.navigator?.add(self);
    ...
  }

  extension SomeViewController: GMSNavigatorListener {
    func navigator(_ navigator: GMSNavigator,
                   didUpdateNavInfo navInfo: GMSNavigationNavInfo) {

      // Get the current step information
      if navInfo.navState == .enroute {
        if let currentStep = navInfo.currentStep {
          ...
          roadNameLabel.text = currentStep.simpleRoadName
          ...
        }
      }
    }
  }

Objective-C

  // ViewController.h
  @interface SomeViewController () <GMSNavigatorListener>

  @end

  // ViewController.m
  @implementation SomeViewController
  // Some initialization code.
  ... {
    ...
    [_mapView.navigator addListener:self];
    ...
  }

  #pragma mark GMSNavigatorListener
  - (void)navigator:(GMSNavigator *)navigator didUpdateNavInfo:(GMSNavigationNavInfo *)navInfo {
    // Get the current step information
    if (navInfo.navState == GMSNavigationNavStateEnroute) {
      GMSNavigationStepInfo *currentStep = navInfo.currentStep;
      if (currentStep) {
        ...
        roadNameLabel.text = currentStep.simpleRoadName;
        ...
      }
    }
    ...
  }

使用 GMSNavigationNavInfo 的 navState 属性获取当前导航状态，该状态为以下状态之一：

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

  • Rerouting - GMSNavigationNavStateRerouting 表示正在导航，但导航器正在寻找新路线。即将执行的操作步骤不可用，因为尚无新路线。

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

车道导航

Navigation SDK 将导航转向卡片中的车道表示为 GMSNavigationLane 和 GMSNavigationLaneDirection 数据对象。GMSNavigationLane 对象表示导航期间的特定车道，并包含一个 GMSNavigationLaneDirection 对象列表，用于描述可从此车道进行的所有转弯。

建议驾驶员在车道中行驶的方向使用 recommended 字段标记。

车道导航示例

以下代码段展示了上述屏幕截图中显示的车道的数据表示法。

// Lane 1
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]

// Lane 2
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]

// Lane 3
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false}]

// Lane 4
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false},
{/*GMSNavigationLaneShape=*/ GMSNavigationLaneShapeNormalRight, /*recommended=*/ false}]

车道导航图片

Navigation SDK 支持为 GMSNavigationStepInfo 传达的每个导航步骤生成车道图片。这些图标符合 CarPlay 的图片大小调整指南。

Swift

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)

Objective-C

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];

为操作创建图标

机动图标

GMSNavigationManeuver 枚举定义了导航期间可能发生的每种可能的操作，您可以从 GMSNavigationStepInfo 的 maneuver 属性中获取给定步骤的操作。

您必须创建操作图标，并将其与关联的操作配对。 对于某些操作，您可以设置与图标的一对一映射，例如 GMSNavigationManeuverDestinationLeft 和 GMSNavigationManeuverDestinationRight。不过，由于某些操作与其他操作具有共同特征，您可能需要将多个操作映射到单个图标。例如，GMSNavigationManeuverTurnLeft 和 GMSNavigationManeuverOnRampLeft 都可以映射到左转图标。

某些机动动作包含额外的“顺时针”或“逆时针”标签，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 支持为给定的 GMSNavigationStepInfo 生成操作图标。这些图标符合 CarPlay 图片尺寸指南。

Swift

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)

Objective-C

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];