请按照本指南中的说明,使用 Navigation SDK for iOS 在应用内绘制前往单个目的地的路线。
概览
- 按照设置项目部分中的说明,将 Navigation SDK 集成到您的应用中。
- 配置
GMSMapView。 - 提示用户接受条款及条件,并授权使用位置信息服务和后台通知。
- 创建一个包含一个或多个目的地的数组。
定义
GMSNavigator以控制精细导航。- 使用
setDestinations添加目的地。 - 将
isGuidanceActive设置为true以开始导航。 - 使用
simulateLocationsAlongExistingRoute模拟车辆沿路线行驶的进度,以便测试、调试和演示您的应用。
- 使用
查看代码
提示用户进行必要的授权
在使用 Navigation SDK 之前,用户必须同意条款及条件,并授权使用导航所需的位置信息服务。如果您的应用将在后台运行,则还必须提示用户授权接收引导提醒通知。本部分介绍了如何显示所需的授权提示。
授权位置信息服务
Navigation SDK 使用位置信息服务,这需要用户授权。如需启用位置信息服务并显示授权对话框,请按以下步骤操作:
在 Xcode 中启用位置信息和后台功能:
- 在 Xcode 中打开目标平台,然后选择 Signing & Capabilities(签名和功能)标签页。如需了解详情,请参阅 Apple 关于向应用添加功能的指南。
- 添加位置信息(始终)和位置信息(使用期间)功能。在每个文本字段中,简要说明应用为何需要位置信息服务(例如:“此应用需要获得使用位置信息服务的权限,以便提供精细导航。”)。
- 添加后台模式功能,然后选中位置信息更新复选框。如果没有此功能,应用会在开始导航时崩溃。如需了解详情,请参阅 Apple 关于在后台处理位置信息更新的指南。
如需显示授权对话框,请调用位置信息管理器实例的
requestAlwaysAuthorization()方法。
Swift
self.locationManager.requestAlwaysAuthorization()
Objective-C
[_locationManager requestAlwaysAuthorization];
授权在后台导航时发送提醒通知
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 的未来升级做好准备,请按如下方式配置移动传感器授权:
在 Xcode 中打开目标,然后前往 Info 标签页,或打开
Info.plist文件。添加新键:Privacy - Motion Usage Description (
NSMotionUsageDescription)。为用户添加简短说明。例如:“此应用需要访问移动传感器,以便计算海拔高度并提高地图路线规划的准确性。”
接受相关条款及条件
使用以下代码显示条款及条件对话框,并在用户接受条款后启用导航功能。请注意,此示例包含位置信息服务和引导提醒通知的代码(如上所示)。
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.
}
}];
创建路线并开始导航
如需规划路线,请调用导航器的 setDestinations 方法,并传入一个包含一个或多个 GMSNavigationWaypoint 目的地的数组。如果路线计算成功,则会显示在地图上。如需开始沿路线导航,请在回调中将 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;
设置要避开的道路
使用 avoidsHighways 和 avoidsTolls 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。使用 GMSNavigationWaypoint 从 placeID 添加目的地。
浮动文字
您可以在应用中的任何位置添加浮动文字,只要不遮盖 Google 归属信息即可。Navigation SDK 不支持将文本锚定到地图上的特定坐标(纬度、经度)或标签。如需了解详情,请参阅信息窗口。