创建自定义指导

本页介绍了在自定义导航体验中创建自定义引导的概要步骤。

此过程与导航路线中所述的过程不同，具体如下：

  • 您首先独立建立导航会话，然后通过会话（而不是调用视图控制器）获取导航器实例。
  • 您可以设置事件监听器来响应和管理导航事件。
  1. 使用 GMSNavigationService.createNavigationSession 创建导航会话，然后通过 setDestination 调用开始导航。如果 Google 导航体验通过导航地图视图调用导航器，GMSNavigationServices 会独立于界面实例控制和接收导航会话中的事件流。这意味着，它既可以在没有界面的情况下运行，也可以传递给任何基于界面的体验。采用这种方法时，导航会话会在您的应用中继续运行，直到从中移除最后一个引用。
  2. 建立基于道路的路线位置信息提供器。如果您希望应用持续监控位置信息（例如，在显示沿路线显示蓝点的导航视图时），请使用位置信息提供程序。
  3. 通过实现 GMSNavigatorListener 协议，设置用于详细精细导航的监听器。然后，将这些信息转换为自定义导航体验所需的任何信息。例如：
    1. 实现纯文本字段，以便简单地将路线投屏到屏幕上。
    2. 为您自己的界面设计并填充字段。
  4. 设置导航模拟器。这对于开发和测试至关重要。

创建独立的导航会话

以下代码段来自该演示，展示了独立于视图控制器建立的导航。然后，该代码会添加一个概览地图，并将其配置为显示当前的道路贴合位置。

// Create the navigation session.

 _navigationSession = [GMSNavigationServices createNavigationSession];
 GMSRoadSnappedLocationProvider *roadSnappedLocationProvider =
     _navigationSession.roadSnappedLocationProvider;
 [roadSnappedLocationProvider startUpdatingLocation];
 GMSNavigator *navigator = _navigationSession.navigator;
 [navigator addListener:self];
 navigator.voiceGuidance = GMSNavigationVoiceGuidanceSilent;
 navigator.sendsBackgroundNotifications = NO;
 _navigationSession.started = YES;
​​ [navigator setDestinations:@[ destination ]
                   callback:^(GMSRouteStatus routeStatus) {
                      // …handle changes in route status.
                    }];

 // Add an overview map.
 _mapView = [[GMSMapView alloc] initWithFrame:CGRectZero];
 [self.mainStackView addArrangedSubview:_mapView];
 [self.mainStackView setNeedsLayout];
 _mapView.settings.compassButton = YES;
 _mapView.delegate = self;
 _mapView.myLocationEnabled = YES;
 _mapView.roadSnappedMyLocationSource = roadSnappedLocationProvider;

将导航从自定义体验传递到 Google 体验

以下代码段展示了您的应用如何允许用户从自定义导航体验进入 Google 导航体验。此代码段还显示了您的应用在分享地图时如何进行此转换。

`UIButton *button = [UIButton buttonWithType:UIButtonTypePlain`];

[`button addTarget:self action:@selector(didTapEnterGoogleNavigationButton:)
forControlState:[_directionsButton addTarget:self`];

`…`

[`_mapView enableNavigationWithSession:_navigationSession`];