浏览路线

按照本指南中的说明操作,使用 Navigation SDK for iOS 在应用内规划前往单个目的地的路线。

概览

  1. 按照设置项目部分中的说明,将 Navigation SDK 集成到您的应用中。
  2. 配置 GMSMapView
  3. 提示用户接受条款及条件,并授权位置服务和后台通知。
  4. 创建一个包含一个或多个目的地的数组。
  5. 定义一个 GMSNavigator 来控制精细导航。

查看代码

提示用户进行必要的授权

在使用 Navigation SDK 之前,用户必须同意相关条款及条件,并授权使用位置信息服务(导航功能需要此权限)。如果应用将在后台运行,则还必须提示用户授权指导提醒通知。本部分展示了如何显示所需的授权提示。

授权位置信息服务

Navigation SDK 使用位置信息服务,这需要用户授权。如需启用位置信息服务并显示授权对话框,请按以下步骤操作:

  1. 在 Xcode 中启用位置信息和后台功能:

    1. 在 Xcode 中打开您的目标,然后选择签名和功能标签页。如需了解详情,请参阅 Apple 关于向应用添加功能的指南。
    2. 添加位置信息(始终)位置信息(使用时)功能。在每个文本字段中,简要说明您的应用需要位置信息服务的原因(例如:“此应用需要使用位置信息服务的权限,以便提供精细的导航服务。”)。
    3. 添加后台模式功能,然后选中位置信息更新复选框。如果没有此功能,应用会在开始导航时崩溃。如需了解详情,请参阅 Apple 关于在后台处理位置信息更新的指南。
  2. 如需显示授权对话框,请调用位置信息管理器实例的 requestAlwaysAuthorization() 方法。

Swift

self.locationManager.requestAlwaysAuthorization()

Objective-C

[_locationManager requestAlwaysAuthorization];

如需查看位置服务授权的完整 Apple 文档,请点击此处

授权后台指导的提醒通知

当应用在后台运行时,Navigation SDK 需要用户权限才能提供提醒通知。添加以下代码,提示用户授予显示这些通知的权限:

Swift

UNUserNotificationCenter.current().requestAuthorization(options: [.alert]) {
  granted, error in
    // Handle denied authorization to display notifications.
    if !granted || error != nil {
      print("User rejected request to display notifications.")
    }
}

Objective-C

// Request authorization for alert notifications.
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
UNAuthorizationOptions options = UNAuthorizationOptionAlert;
[center requestAuthorizationWithOptions:options
                      completionHandler:
 ^(
   BOOL granted,
   NSError *_Nullable error) {
     if (!error && granted) {
       NSLog(@"iOS Notification Permission: newly Granted");
     } else {
       NSLog(@"iOS Notification Permission: Failed or Denied");
     }
   }];

授权使用运动传感器

在未来的主要版本中,Navigation SDK for iOS 将核心位置数据与设备运动传感器 (CMAltimeter) 相结合,以计算路线海拔。当 SDK 访问高度计时,iOS 会自动使用此字符串提示用户授予权限。

现在添加此键不会影响当前行为,但可防止在您稍后升级 SDK 时发生初始化崩溃。

为了为将来升级 SDK 做准备,请按如下方式配置运动传感器授权:

  1. 在 Xcode 中打开您的目标,然后前往 Info 标签页,或打开 Info.plist 文件。

  2. 添加新密钥:隐私权 - 运动使用情况说明 (NSMotionUsageDescription)。

  3. 为用户添加简短说明。例如:“此应用需要访问运动传感器,以计算海拔高度并提高地图路线规划准确性。”

接受相关条款及条件

使用以下代码可显示条款及条件对话框,并在用户接受条款时启用导航。请注意,此示例包含位置信息服务和指导提醒通知(之前已显示)的代码。

Swift

  let termsAndConditionsOptions = GMSNavigationTermsAndConditionsOptions(companyName: "Ride Sharing Co.")

  GMSNavigationServices.showTermsAndConditionsDialogIfNeeded(
    with: termsAndConditionsOptions) { termsAccepted in
    if termsAccepted {
      // Enable navigation if the user accepts the terms.
      self.mapView.isNavigationEnabled = true
      self.mapView.settings.compassButton = true

      // Request authorization to use location services.
      self.locationManager.requestAlwaysAuthorization()

      // Request authorization for alert notifications which deliver guidance instructions
      // in the background.
    UNUserNotificationCenter.current().requestAuthorization(options: [.alert]) {
      granted, error in
        // Handle rejection of notification authorization.
        if !granted || error != nil {
          print("Authorization to deliver notifications was rejected.")
        }
      }
    } else {
      // Handle rejection of terms and conditions.
    }
  }

Objective-C

GMSNavigationTermsAndConditionsOptions *termsAndConditionsOptions = [[GMSNavigationTermsAndConditionsOptions alloc] initWithCompanyName:@"Ride Sharing Co."];

[GMSNavigationServices
  showTermsAndConditionsDialogIfNeededWithOptions:termsAndConditionsOptions
  callback:^(BOOL termsAccepted) {
   if (termsAccepted) {
     // Enable navigation if the user accepts the terms.
     _mapView.navigationEnabled = YES;
     _mapView.settings.compassButton = YES;

     // Request authorization to use the current device location.
     [_locationManager requestAlwaysAuthorization];

     // Request authorization for alert notifications which deliver guidance instructions
     // in the background.
     UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
     UNAuthorizationOptions options = UNAuthorizationOptionAlert;
     [center requestAuthorizationWithOptions:options
                           completionHandler:
     ^(
       BOOL granted,
       NSError *_Nullable error) {
         if (!error && granted) {
           NSLog(@"iOS Notification Permission: newly Granted");
         } else {
           NSLog(@"iOS Notification Permission: Failed or Denied");
         }
       }];
   } else {
     // Handle rejection of the terms and conditions.
   }
 }];

创建路线并开始引导

如需绘制路线,请使用一个或多个要访问的 GMSNavigationWaypoint 目的地数组调用导航器的 setDestinations 方法。如果成功计算出路线,该路线会显示在地图上。如需开始沿路线提供引导,请在回调中将 isGuidanceActive 设置为 true

下例显示了:

  • 创建包含一个目的地的新路线。
  • 入门指导。
  • 启用后台指导通知。
  • 模拟沿路线旅行(可选)。
  • 将相机模式设置为“跟随”(可选)。

Swift

func startNav() {
  var destinations = [GMSNavigationWaypoint]()
  destinations.append(GMSNavigationWaypoint.init(placeID: "ChIJnUYTpNASkFQR_gSty5kyoUk",
                                                 title: "PCC Natural Market")!)

  mapView.navigator?.setDestinations(destinations) { routeStatus in
    self.mapView.navigator?.isGuidanceActive = true
    self.mapView.locationSimulator?.simulateLocationsAlongExistingRoute()
    self.mapView.cameraMode = .following
  }
}

Objective-C

- (void)startNav {
  NSArray<GMSNavigationWaypoint *> *destinations =
  @[[[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJnUYTpNASkFQR_gSty5kyoUk"
                                             title:@"PCC Natural Market"]];

  [_mapView.navigator setDestinations:destinations
                             callback:^(GMSRouteStatus routeStatus){
                               [_mapView.locationSimulator simulateLocationsAlongExistingRoute];
                               _mapView.navigator.guidanceActive = YES;
                               _mapView.cameraMode = GMSNavigationCameraModeFollowing;
                             }];
}

如需了解地点 ID,请参阅地点 ID

多停车点方案

您最多可以配置 25 个途经点。

setDestinations 方法不支持多停靠点行程。使用 continueToNextDestinationWithCompletion() 将航点推进到旅程的下一段。

设置出行方式

出行模式定义了要提取的路线类型以及如何确定用户的航向。您可以为路线设置四种出行模式之一:驾车、骑车、步行和乘坐出租车。在驾驶和出租车模式下,用户的航向基于行驶方向;在骑车和步行模式下,航向由设备朝向(在横屏模式下,朝向设备顶部)表示。

设置地图视图的 travelMode 属性,如以下示例所示:

Swift

self.mapView.travelMode = .cycling

Objective-C

_mapView.travelMode = GMSNavigationTravelModeCycling;

设置要避开的道路

使用 avoidsHighwaysavoidsTolls BOOL 属性可避免在路线中经过高速公路、收费公路或两者兼而有之。

Swift

self.mapView.navigator?.avoidsTolls = true

Objective-C

_mapView.navigator.avoidsTolls = YES;

设置音频指导音量

如需调整语音导航音量,请将导航器上的 volumeLevel 属性设置为低、正常或高。导航器使用上次持久保存的音量级别,或默认为正常。

Swift

self.mapView.navigator?.volumeLevel = .low

Objective-C

_mapView.navigator.volumeLevel = GMSNavigationVolumeLevelLow;

地点 ID 查找工具

您可以使用地点 ID 查找工具查找可用于路线目的地的地点 ID。从具有 GMSNavigationWaypointplaceID 添加目的地。

浮动文字

您可以在应用中的任何位置添加浮动文字,但不得遮盖 Google 提供方信息。Navigation SDK 不支持将文字锚定到地图上的特定坐标(纬度、经度)或标签。如需了解详情,请参阅信息窗口