按照本指南中的说明操作,使用 Navigation SDK for iOS 在应用内规划前往单个目的地的路线。
概览
- 按照设置项目部分中的说明,将 Navigation SDK 集成到您的应用中。
- 配置
GMSMapView。 - 提示用户接受条款及条件,并授权位置信息服务和后台通知。
- 创建包含一个或多个目的地的数组。
定义
GMSNavigator以控制精细导航。- 使用
setDestinations添加目的地。 - 将
isGuidanceActive设置为true以开始导航。 - 使用
simulateLocationsAlongExistingRoute模拟车辆沿路线行驶的进度,以便测试、调试和演示您的应用。
- 使用
查看代码
提示用户提供必要的授权
在使用 Navigation SDK 之前,用户必须同意相关条款及条件,并授权使用位置信息服务(导航功能需要此服务)。如果您的应用将在后台运行,则还必须提示用户授权指导提醒通知。本部分展示了如何显示所需的授权提示。
授权位置信息服务
Navigation SDK 使用位置信息服务,这需要用户授权。如需启用位置信息服务并显示授权对话框,请按以下步骤操作:
- 将
NSLocationAlwaysUsageDescription键添加到Info.plist。 对于该值,请简要说明您的应用为何需要位置信息服务。例如:“此应用需要获得使用位置信息服务的权限,才能提供精细的导航服务。”
如需显示授权对话框,请调用位置信息管理器实例的
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"); } }]; 接受相关条款及条件
使用以下代码可显示条款及条件对话框,并在用户接受条款时启用导航。请注意,此示例包含位置信息服务和指导提醒通知的代码(如前所示)。
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) 的数组调用 Navigator 的 setDestinations() 方法。如果成功计算出路线,则会在地图上显示该路线。如需开始沿路线提供指导(从第一个目的地开始),请在回调中将 isGuidanceActive 设置为 true。
下例显示了:
- 创建包含两个目的地的新路线。
- 入门指导。
- 启用后台指导通知。
- 模拟沿路线旅行(可选)。
- 将相机模式设置为“跟随”(可选)。
Swift
func startNav() { var destinations = [GMSNavigationWaypoint]() destinations.append(GMSNavigationWaypoint.init(placeID: "ChIJnUYTpNASkFQR_gSty5kyoUk", title: "PCC Natural Market")!) destinations.append(GMSNavigationWaypoint.init(placeID:"ChIJJ326ROcSkFQRBfUzOL2DSbo", title:"Marina Park")!) 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"], [[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJJ326ROcSkFQRBfUzOL2DSbo" title:@"Marina Park"]]; [_mapView.navigator setDestinations:destinations callback:^(GMSRouteStatus routeStatus){ [_mapView.locationSimulator simulateLocationsAlongExistingRoute]; _mapView.navigator.guidanceActive = YES; _mapView.cameraMode = GMSNavigationCameraModeFollowing; }]; } 如需了解地点 ID,请参阅地点 ID。
多停车点场景
setDestinations 方法不支持多停靠点行程。使用 continueToNextDestination() 将途经点推进到旅程的下一段。
设置出行方式
出行模式决定了系统将提取哪种类型的路线,以及确定用户航向的方式。您可以为路线设置四种出行模式之一:驾车、骑车、步行和乘坐出租车。在驾驶模式和出租车模式下,用户路线基于行驶方向;在骑车模式和步行模式下,路线由设备朝向(在横屏模式下为设备顶部)表示。
设置地图视图的 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; 地点 ID 查找工具
您可以使用地点 ID 查找工具查找可用于路线目的地的地点 ID。从具有 GMSNavigationWaypoint 的 placeID 中添加目的地。
悬浮文字
您可以在应用中的任意位置添加浮动文字,但前提是不能遮盖 Google 提供方信息。Navigation SDK 不支持将文本锚定到地图上的某个纬度/经度或某个标签。如需了解详情,请参阅信息窗口。