请按照本指南在应用中绘制前往单个目的地的路线, 使用 iOS 版 Navigation SDK
概览
- 按照说明将 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.
}
}];
创建路线并开始导航
要绘制路线,请使用数组调用 Navigator 的 setDestinations()
方法
包含一个或多个要访问的目的地 (GMSNavigationWaypoint
)。如果成功
路线就会在地图上显示出来。如需开始沿路线导航,请执行以下操作:
从第一个目的地开始,在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。
设置出行方式
出行方式决定要提取的路线类型,以及 确定用户的课程。您可以为不同目的地 路线:驾车、骑车、步行和打出租车。在驾车和打出租车模式下,用户的路线为 基于行进方向、在骑车和步行模式下 用设备所面向的方向来表示
设置 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;
PlaceID 查找工具
您可以使用 PlaceID 查找工具
查找用于路线目的地的地点 ID。使用 GMSNavigationWaypoint
从 placeID
添加目的地。
浮动文本
您可以在应用中的任意位置添加悬浮文本,只要 Google 支持 未涉及归因。Navigation SDK 不支持在 文本映射到地图上的纬度/经度,或者是标签。如需更多信息 请参见信息窗口。