Điều hướng một tuyến đường

Hãy làm theo hướng dẫn này để vẽ một tuyến đường trong ứng dụng của bạn đến một điểm đến, bằng cách sử dụng SDK Điều hướng cho iOS.

Tổng quan

1. Tích hợp SDK Điều hướng vào ứng dụng của bạn, như mô tả trong phần Thiết lập dự án.
2. Định cấu hình GMSMapView.
3. 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 dịch vụ vị trí và thông báo trong nền.
4. Tạo một mảng chứa một hoặc nhiều đích đến.

5. Xác định GMSNavigator để kiểm soát đường đi từng chặng.

   • Thêm đích đến bằng setDestinations.
   • Đặt isGuidanceActive thành true để bắt đầu đi theo chỉ dẫn.
   • Sử dụng simulateLocationsAlongExistingRoute để mô phỏng tiến trình của xe dọc theo tuyến đường, nhằm mục đích kiểm thử, gỡ lỗi và minh hoạ ứng dụng của bạn.

Lưu ý: Để ngăn màn hình mờ đi hoặc tắt trong khi điều hướng, ứng dụng của bạn phải tắt bộ hẹn giờ rảnh, vì SDK Điều hướng không làm việc này cho bạn. Để tắt bộ hẹn giờ rảnh, hãy thực hiện lệnh gọi sau:
[UIApplication sharedApplication].idleTimerDisabled = YES;.

Xem mã

Hiện/Ẩn mã Swift cho trình điều khiển thành phần hiển thị điều hướng.

/*
 * Copyright 2017 Google Inc. All rights reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

import GoogleNavigation
import UIKit

class ViewController: UIViewController {

  var mapView: GMSMapView!
  var locationManager: CLLocationManager!

  override func loadView() {

    locationManager = CLLocationManager()

    // Set up the map view.
    let camera = GMSCameraPosition.camera(withLatitude: 47.67, longitude: -122.20, zoom: 14)
    mapView = GMSMapView.map(withFrame: .zero, camera: camera)

    // Show the terms and conditions.
    let companyName = "Ride Sharing Co."
    GMSNavigationServices.showTermsAndConditionsDialogIfNeeded(
      withCompanyName: companyName
    ) { 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 denied authorization to display notifications.
          if !granted || error != nil {
            print("User rejected request to display notifications.")
          }
        }
      } else {
        // Handle rejection of terms and conditions.
      }
    }

    view = mapView

    makeButton()
  }

  // Create a route and start guidance.
  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
      guard routeStatus == .OK else {
        print("Handle route statuses that are not OK.")
        return
      }
      self.mapView.navigator?.isGuidanceActive = true
      self.mapView.locationSimulator?.simulateLocationsAlongExistingRoute()
      self.mapView.cameraMode = .following
    }
  }

  // Add a button to the view.
  func makeButton() {
    // A button to start navigation.
    let navButton = UIButton(frame: CGRect(x: 5, y: 150, width: 200, height: 35))
    navButton.backgroundColor = .blue
    navButton.alpha = 0.5
    navButton.setTitle("Start navigation", for: .normal)
    navButton.addTarget(self, action: #selector(startNav), for: .touchUpInside)
    self.mapView.addSubview(navButton)
  }

}

Hiện/Ẩn mã Objective-C cho trình điều khiển chế độ xem điều hướng.

/*
 * Copyright 2017 Google Inc. All rights reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#import "ViewController.h"
@import GoogleNavigation;

@interface ViewController ()
@end

@implementation ViewController {
  GMSMapView *_mapView;
  CLLocationManager *_locationManager;
}

- (void)loadView {

  _locationManager = [[CLLocationManager alloc] init];

  // Set up the map view.
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.67
                                                          longitude:-122.20
                                                               zoom:14];
  _mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];

  // Show the terms and conditions.
  NSString *companyName = @"Ride Sharing Co.";
  [GMSNavigationServices
    showTermsAndConditionsDialogIfNeededWithCompanyName:companyName
                                               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.
     }
   }];

  self.view = _mapView;

  [self makeButton];
}

// Create a route and initiate navigation.
- (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.navigator.sendsBackgroundNotifications = YES;
                               _mapView.cameraMode = GMSNavigationCameraModeFollowing;
                             }];
}

// Add a button to the view.
- (void)makeButton {
  // A button to start navigation.
  UIButton *navButton = [UIButton buttonWithType:UIButtonTypeCustom];
  [navButton addTarget:self
                action:@selector(startNav)
      forControlEvents:UIControlEventTouchUpInside];
  [navButton setTitle:@"Navigate" forState:UIControlStateNormal];
  [navButton setBackgroundColor:[UIColor blueColor]];
  navButton.frame = CGRectMake(5.0, 150.0, 100.0, 35.0);
  [_mapView addSubview:navButton];
}

@end

Nhắc người dùng cấp các quyền cần thiết

Trước khi sử dụng SDK Điều hướng, 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 để điều hướng). Nếu ứng dụng của bạn chạy ở chế độ nền, thì ứng dụng đó cũng phải nhắc người dùng cho phép thông báo cảnh báo hướng dẫn. Phần này cho biết cách hiển thị lời nhắc uỷ quyền bắt buộc.

Cho phép dịch vụ vị trí

SDK Điều hướng sử dụng dịch vụ vị trí, nên cần có sự cho phép của người dùng. Để bật dịch vụ vị trí và hiển thị hộp thoại uỷ quyền, hãy làm theo các bước sau:

1. Bật các chức năng vị trí và nền trong Xcode:

   1. Mở mục tiêu trong Xcode rồi chọn thẻ Signing & Capabilities (Ký và các chức năng). Để biết thông tin chi tiết, hãy xem hướng dẫn của Apple về cách thêm tính năng vào ứng dụng.
   2. Thêm các chức năng Vị trí (Luôn luôn) và Vị trí (Khi đang sử dụng). Trong trường văn bản cho mỗi mục, hãy thêm nội dung giải thích ngắn gọn về lý do ứng dụng của bạn yêu cầu 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 từng chặng").
   3. Thêm chức năng Background Modes (Chế độ nền), sau đó chọn hộp đánh dấu Location updates (Thông tin cập nhật về vị trí). Nếu không có chức năng này, ứng dụng sẽ gặp sự cố khi bắt đầu điều hướng. Để biết thông tin chi tiết, hãy xem hướng dẫn của Apple về cách xử lý thông báo cập nhật vị trí ở chế độ nền.

2. Để hiển thị hộp thoại uỷ quyền, hãy gọi phương thức requestAlwaysAuthorization() của thực thể trình quản lý vị trí.

Swift

self.locationManager.requestAlwaysAuthorization()

Objective-C

[_locationManager requestAlwaysAuthorization];

Xem toàn bộ tài liệu của Apple về việc uỷ quyền cho dịch vụ vị trí.

Cho phép thông báo cảnh báo cho tính năng hướng dẫn trong nền

SDK Điều hướng cần có sự cho phép của người dùng để cung cấp thông báo cảnh báo khi ứng dụng đang chạy ở chế độ nền. Thêm mã sau đây để nhắc người dùng cấp quyền 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");
     }
   }];

Cho phép sử dụng cảm biến chuyển động

Quan trọng: Để tránh sự cố ứng dụng trong một bản phát hành chính trong tương lai (phiên bản 11.0.0 trở lên), hãy thêm khoá NSMotionUsageDescription vào Info.plist của ứng dụng ngay bây giờ.

Trong một bản phát hành chính trong tương lai, SDK Điều hướng cho iOS sẽ kết hợp dữ liệu vị trí cốt lõi với cảm biến chuyển động của thiết bị (CMAltimeter) để tính toán độ cao của tuyến đường. Khi SDK truy cập vào cao độ kế, iOS sẽ tự động sử dụng chuỗi này để nhắc người dùng cấp quyền.

Việc thêm khoá này hiện không ảnh hưởng đến hành vi hiện tại nhưng sẽ ngăn chặn sự cố khởi chạy khi bạn nâng cấp SDK sau này.

Để chuẩn bị cho các bản nâng cấp SDK trong tương lai, hãy định cấu hình quyền cho cảm biến chuyển động như sau:

1. Mở mục tiêu trong Xcode rồi chuyển đến thẻ Info (Thông tin) hoặc mở tệp Info.plist.

2. Thêm một khoá mới: Privacy – Motion Usage Description (Quyền riêng tư – Nội dung mô tả về việc sử dụng chuyển động) (NSMotionUsageDescription).

3. Thêm nội dung giải thích ngắn gọn cho người dùng. Ví dụ: "Ứng dụng này cần có quyền truy cập vào cảm biến chuyển động để tính toán độ cao và cải thiện độ chính xác của tuyến đường trên bản đồ".

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 hướng dẫn (đã 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 hướng dẫn

Để vẽ tuyến đường, hãy gọi phương thức setDestinations của trình điều hướng 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 tuyến đường được tính toán thành công, tuyến đường đó sẽ xuất hiện trên bản đồ. Để bắt đầu hướng dẫn 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 tuyến đường mới có một điểm đến.
• Bắt đầu hướng dẫn.
• Bật thông báo hướng dẫn trong nền.
• Mô phỏng hành trình dọc theo tuyến đường (không bắt buộc).
• Đặt chế độ camera thành "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, hãy tham khảo bài viết Mã địa điểm.

Trường hợp có nhiều điểm dừng

Bạn có thể thiết lập 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 continueToNextDestinationWithCompletion() để chuyển điểm tham chiếu sang chặng tiếp theo của hành trình.

Thận trọng: Đôi khi, việc gọi phương thức continueToNextDestinationWithCompletion() có thể dẫn đến sự kiện đến không chính xác, trong đó điểm đến vừa hoàn tất có vẻ như được chọn lại.

Đặt chế độ di chuyển

Phương thức di chuyển xác định cả loại tuyến đường cần tìm nạp và cách xác định lộ trình của người dùng. Bạn có thể đặt một trong bốn phương thức 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ế độ đi xe đạp và đi bộ, hướng đi được thể hiện bằng hướng mà thiết bị đang hướng tới (về phía trên cùng của thiết bị ở chế độ ngang).

Quan trọng: Chế độ taxi là một tính năng thử nghiệm.

Lưu ý: Khi thử nghiệm chế độ đi xe đạp hoặc đi bộ bằng trình mô phỏng, cả hướng chữ V và hướng bản đồ đều không thay đổi. Tuy nhiên, khi sử dụng một thiết bị thực, hướng bản đồ sẽ thay đổi khi bạn xoay thiết bị, trong khi mũi tên chữ v tiếp tục chỉ về hướng mà thiết bị đang hướng tới.

Đặ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 đường cần tránh

Sử dụng các thuộc tính avoidsHighways và avoidsTolls BOOL để tránh đường cao tốc, đường có thu phí hoặc cả hai dọc theo một tuyến đường.

Swift

self.mapView.navigator?.avoidsTolls = true

Objective-C

_mapView.navigator.avoidsTolls = YES;

Đặt âm lượng cho hướng dẫn bằng âm thanh

Để điều chỉnh âm lượng hướng dẫn bằng giọng nói, hãy đặt thuộc tính volumeLevel trên trình điều hướng thành thấp, bình thường hoặc cao. Trình điều hướng sử dụng mức âm lượng được duy trì gần đây nhất hoặc mặc định là bình thường.

Swift

self.mapView.navigator?.volumeLevel = .low

Objective-C

_mapView.navigator.volumeLevel = GMSNavigationVolumeLevelLow;

Công cụ tìm mã địa điểm

Bạn có thể sử dụng Trình tìm mã địa điểm để tìm mã địa điểm dùng cho các điểm đến trên tuyến đường. Thêm đích đế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 cứ đâu trong ứng dụng, miễn là không che mất thông tin ghi nhận tác giả của Google. Navigation SDK không hỗ trợ việc neo văn bản vào toạ độ cụ thể (vĩ độ, kinh độ) trên bản đồ hoặc vào nhãn. Để biết thêm thông tin, hãy xem phần Cửa sổ thông tin.