Hãy làm theo hướng dẫn này để vẽ một tuyến đường trong ứng dụng đến một điểm đến duy nhất bằng Navigation SDK cho iOS.
Tổng quan
- Tích hợp Navigation SDK vào ứng dụng của bạn như mô tả trong phần Thiết lập dự án.
- Định cấu hình
GMSMapView. - Nhắc người dùng chấp nhận các điều khoản và điều kiện, đồng thời cho phép sử dụng dịch vụ vị trí và thông báo trong nền.
- Tạo một mảng chứa một hoặc nhiều điểm đến.
Xác định
GMSNavigatorđể kiểm soát tính năng đường đi từng chặng.- Thêm điểm đến bằng cách sử dụng
setDestinations. - Đặt
isGuidanceActivethànhtrueđể bắt đầu chỉ đường. - Sử dụng
simulateLocationsAlongExistingRouteđể mô phỏng tiến trình của xe dọc theo tuyến đường nhằm kiểm thử, gỡ lỗi và minh hoạ ứng dụng.
- Thêm điểm đến bằng cách sử dụng
Xem mã
Nhắc người dùng cấp quyền cần thiết
Trước khi sử dụng Navigation SDK, người dùng phải đồng ý với các điều khoản và điều kiện, đồng thời cho phép sử dụng dịch vụ vị trí (bắt buộc để chỉ đường). Nếu chạy trong nền, ứng dụng của bạn cũng phải nhắc người dùng cho phép nhận thông báo cảnh báo chỉ đường. Phần này trình bày cách hiển thị lời nhắc cấp quyền bắt buộc.
Cho phép sử dụng dịch vụ vị trí
Navigation SDK sử dụng dịch vụ vị trí và yêu cầu người dùng cho phép. Để bật dịch vụ vị trí và hiển thị hộp thoại cấp quyền, hãy thực hiện các bước sau:
- Thêm khoá
NSLocationWhenInUseUsageDescriptionvàNSLocationAlwaysAndWhenInUseUsagevàoInfo.plist. Đối với giá trị, hãy thêm một lời giải thích ngắn gọn về lý do ứng dụng của bạn cần có dịch vụ vị trí. Ví dụ: "Ứng dụng này cần có quyền sử dụng dịch vụ vị trí để chỉ đường đi từng chặng."
Để hiển thị hộp thoại cấp quyền, hãy gọi
requestAlwaysAuthorization()phương thức của thực thể trình quản lý vị trí.
Swift
self.locationManager.requestAlwaysAuthorization()
Objective-C
[_locationManager requestAlwaysAuthorization];
Xem tài liệu đầy đủ của Apple về việc cấp quyền sử dụng dịch vụ vị trí.
Cho phép nhận thông báo cảnh báo để chỉ đường trong nền
Navigation SDK cần có sự cho phép của người dùng để gửi thông báo cảnh báo khi ứng dụng đang chạy trong nền. Thêm mã sau để nhắc người dùng cho phép hiển thị các thông báo này:
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");
}
}];
Chấp nhận các điều khoản và điều kiện
Sử dụng mã sau để hiển thị hộp thoại điều khoản và điều kiện, đồng thời bật tính năng chỉ đường khi người dùng chấp nhận các điều khoản. Xin lưu ý rằng ví dụ này bao gồm mã cho dịch vụ vị trí và thông báo cảnh báo chỉ đường (đã trình bày trước đó).
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.
}
}];
Tạo tuyến đường và bắt đầu chỉ đường
Để vẽ một tuyến đường, hãy gọi phương thức setDestinations() của Navigator bằng một mảng
gồm một hoặc nhiều điểm đến
(GMSNavigationWaypoint)
cần ghé thăm. Nếu tính toán thành công, tuyến đường sẽ xuất hiện trên bản đồ. Để bắt đầu chỉ đường dọc theo tuyến đường, hãy đặt isGuidanceActive thành true trong lệnh gọi lại.
Ví dụ sau đây cho thấy:
- Tạo một tuyến đường mới có một điểm đến.
- Bắt đầu chỉ đường.
- Bật thông báo chỉ đường trong nền.
- Mô phỏng hành trình dọc theo tuyến đường (không bắt buộc).
- Đặt chế độ máy ảnh thành "follow" (theo dõi) (không bắt buộc).
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;
}];
}
Để tìm hiểu về Mã địa điểm, vui lòng tham khảo bài viết Mã địa điểm.
Các trường hợp có nhiều điểm dừng
Bạn có thể định cấu hình tối đa 25 điểm tham chiếu.
Phương thức setDestinations không hỗ trợ hành trình có nhiều điểm dừng. Sử dụng continueToNextDestination() để chuyển điểm tham chiếu sang chặng tiếp theo của hành trình.
Đặt chế độ di chuyển
Chế độ di chuyển xác định loại tuyến đường sẽ được tìm nạp và cách xác định hướng đi của người dùng. Bạn có thể đặt một trong bốn cách di chuyển cho một tuyến đường: lái xe, đạp xe, đi bộ và đi taxi. Ở chế độ lái xe và đi taxi, hướng đi của người dùng dựa trên hướng di chuyển; ở chế độ đạp xe và đi bộ, hướng đi được biểu thị bằng hướng mà thiết bị đang hướng tới (hướng về phía trên cùng của thiết bị ở chế độ ngang).
Đặt thuộc tính travelMode
của chế độ xem bản đồ như trong ví dụ sau:
Swift
self.mapView.travelMode = .cycling
Objective-C
_mapView.travelMode = GMSNavigationTravelModeCycling;
Đặt các con đường cần tránh
Sử dụng các thuộc tính avoidsHighways và avoidsTolls BOOL để tránh đường cao tốc và/hoặc đường thu phí dọc theo một tuyến đường.
Swift
self.mapView.navigator?.avoidsTolls = true
Objective-C
_mapView.navigator.avoidsTolls = YES;
Công cụ tìm PlaceID
Bạn có thể sử dụng Công cụ tìm PlaceID
để tìm mã địa điểm dùng cho điểm đến của tuyến đường. Thêm một điểm đến từ một placeID bằng GMSNavigationWaypoint.
Văn bản nổi
Bạn có thể thêm văn bản nổi ở bất kỳ đâu trong ứng dụng, miễn là thông tin phân bổ của Google không bị che khuất. Navigation SDK không hỗ trợ việc neo văn bản vào một vĩ độ/kinh độ trên bản đồ hoặc vào một nhãn. Để biết thêm thông tin, hãy xem Cửa sổ thông tin.