精细导航数据 Feed 为并非专为基于地图的导航设计的设备提供导航专用信息。它使用您提供的元素为即将发生的操作提供:
- 图标(向左、向右、调头)
- 在环岛中转弯数字
- 道路名称
- 预计到达下一导航路段或最终目的地的距离和时间
您可以使用精细导航信息流来打造不适合完整 Navigation SDK 界面的体验,例如针对小屏幕显示屏。例如,您可以针对双轮机动车乘客使用此设置,以便投影纯导航指导,帮助他们更快速、更自信地到达目的地,最大限度地减少干扰。
基本导航显示元素
每个导航路段的主要字段包括完整的道路名称、操作和路段的总距离,这些信息可在 GMSNavigationStepInfo 中找到。
对于整个行程,您可能希望显示距当前路段或目的地的剩余时间和距离,所有这些都在 GMSNavigationNavInfo 中提供。右图显示了这些基本导航元素的示例。
设置事件监听器
如需使用仅限导航的数据,您必须为 didChangeNavInfo
事件实现事件监听器。在事件监听器中,访问行程和步数信息,以向用户提供精细导航。
若要实现事件处理脚本,地图的视图控制器必须实现 GMSNavigatorListener
协议。如需详细了解如何在 iOS 版 Navigation SDK 中处理事件,请参阅监听导航事件。
处理 didChangeNavInfo
事件
为 didChangeNavInfo
事件创建监听器,以向应用添加精细导航支持。在事件监听器中,使用以下类和枚举控制精细导航:
GMSNavigationNavInfo
- 用于定义导航状态相关信息的类。GMSNavigationStepInfo
- 用于定义导航路线中某个路段的相关信息的类。GMSNavigationNavState
- 定义导航的当前状态的枚举,例如路线中、重新规划路线或已停止。GMSNavigationDrivingSide
- 枚举定义此路段是在右边驾车路线还是在左边驾车路线上。GMSNavigationManeuver
- 定义要执行的导航操作的枚举,例如左转或右转。
以下是 didChangeNavInfo
事件的事件监听器示例:
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; ... } } ... }
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 ... } } } }
导航状态
使用 GMSNavigationNavInfo
的 navState
属性获取导航的当前状态,可以是以下状态之一:
途中 -
GMSNavigationNavStateEnroute
状态表示引导式导航当前处于活动状态,并且用户位于提供的路线上。提供有关当前即将进行的操作步骤的信息。正在重选路线 -
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];