ฟังเหตุการณ์การนําทาง

ประกาศ: โปรโตคอล GMSNavigatorDelegate และ GMSRoadSnappedLocationProviderDelegate เลิกใช้งานแล้วใน Navigation SDK สำหรับ iOS เวอร์ชัน 2.0 ดูรายละเอียดการแทนที่ได้ที่บันทึกประจำรุ่น

ใช้คู่มือนี้เพื่อเปิดใช้แอปเพื่อฟังและตอบสนองต่อเหตุการณ์ต่างๆ ที่เปลี่ยนแปลงไปเมื่อผู้ใช้ไปยังเส้นทางต่างๆ คู่มือนี้ไม่ครอบคลุมการกำหนดเส้นทาง แต่จะครอบคลุมเฉพาะการตอบสนองต่อเหตุการณ์ตามเส้นทางเท่านั้น

ภาพรวม

Navigation SDK สำหรับ iOS มี Listener ที่เชื่อมโยงกับตำแหน่งของผู้ใช้และสภาพตามเส้นทาง รวมถึงข้อมูลเวลาและระยะทางที่สำคัญ ในตัวควบคุมมุมมองของแผนที่ แอปของคุณต้องใช้โปรโตคอลสำหรับ Listener ต่อไปนี้ GMSRoadSnappedLocationProviderListener และ GMSNavigatorListener

รายการนี้แสดงเมธอด Listener ที่ใช้ได้สำหรับเหตุการณ์การนำทาง

• GMSNavigatorListener.didArriveAtWaypoint ซึ่งจะทริกเกอร์เมื่อถึงปลายทาง
• GMSNavigatorListener.navigatorDidChangeRoute จะทริกเกอร์เมื่อเส้นทางมีการเปลี่ยนแปลง
• GMSNavigatorListener.didUpdateRemainingTime ซึ่งจะเรียกซ้ำๆ เมื่อเวลาที่ใช้เดินทางไปยังจุดหมายถัดไปเปลี่ยนแปลงขณะที่การนำทางทำงานอยู่
• GMSNavigatorListener.didUpdateRemainingDistance ระบบจะเรียกใช้ซ้ำๆ เมื่อระยะทางไปยังจุดหมายถัดไปเปลี่ยนแปลงขณะที่การนำทางทำงานอยู่
• GMSNavigatorListener.didUpdateDelayCategory จะเรียกใช้เมื่อหมวดหมู่ความล่าช้าไปยังจุดหมายถัดไปมีการเปลี่ยนแปลงขณะที่การนำทางทำงานอยู่
• GMSNavigatorListener.didChangeSuggestedLightingMode จะทริกเกอร์เมื่อมีการอัปเดตสภาพแสงโดยประมาณ ตัวอย่างเช่น เมื่อถึงเวลากลางคืนในตำแหน่งปัจจุบันของผู้ใช้ แสงจะเปลี่ยนไป
• GMSNavigatorListener.didUpdateSpeedingPercentage จะทริกเกอร์เมื่อคนขับขับรถเกินขีดจำกัดความเร็ว
• GMSRoadSnappedLocationProviderListener.didUpdateLocation ซึ่งจะเรียกใช้ซ้ำๆ เมื่อตำแหน่งของผู้ใช้เปลี่ยนแปลง

หมายเหตุ: หากการออกแบบแอปของคุณต้องจัดการเหตุการณ์ที่อยู่นอกขอบเขตของคู่มือนี้ ให้พิจารณาใช้โปรโตคอล GMSMapViewDelegate ของ Maps SDK สำหรับ iOS โปรโตคอลนี้ช่วยให้ฟังเหตุการณ์อื่นๆ ได้ เช่น การเปลี่ยนแปลงของกล้องหรือความใกล้ชิดกับจุดที่น่าสนใจ ดูรายละเอียดได้ที่กิจกรรม

ดูโค้ด

แสดง/ซ่อนโค้ด Swift สำหรับ Listener เหตุการณ์

/*
 * Copyright 2020 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,
  GMSNavigatorListener,
  GMSRoadSnappedLocationProviderListener
{

  var mapView: GMSMapView!
  var locationManager: CLLocationManager!

  override func loadView() {

    locationManager = CLLocationManager()

    let camera = GMSCameraPosition.camera(withLatitude: 47.67, longitude: -122.20, zoom: 14)
    mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)

    // Add listeners for GMSNavigator and GMSRoadSnappedLocationProvider.
    mapView.navigator?.add(self)
    mapView.roadSnappedLocationProvider?.add(self)

    // Set the time update threshold (seconds) and distance update threshold (meters).
    mapView.navigator?.timeUpdateThreshold = 10
    mapView.navigator?.distanceUpdateThreshold = 100

    // Set the initial lighting mode on launch or setup.
    mapView.lightingMode = mapView.navigator?.suggestedLightingMode ?? .normal

    // 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

        // 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("Authorization to deliver notifications was rejected.")
          }
        }
      } else {
        // Handle the case when the user rejects the terms and conditions.
      }
    }

    view = mapView

    makeButton()
  }

  // Create a route and start guidance.
  @objc 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.cameraMode = .following
      self.mapView.locationSimulator?.simulateLocationsAlongExistingRoute()
    }

    mapView.roadSnappedLocationProvider?.startUpdatingLocation()
  }

  // Listener to handle continuous location updates.
  func locationProvider(
    _ locationProvider: GMSRoadSnappedLocationProvider,
    didUpdate location: CLLocation
  ) {
    print("Location: \(location.description)")
  }

  // Listener to handle speeding events.
  func navigator(
    _ navigator: GMSNavigator, didUpdateSpeedingPercentage percentageAboveLimit: CGFloat
  ) {
    print("Speed is \(percentageAboveLimit) above the limit.")
  }

  // Listener to handle arrival events.
  func navigator(_ navigator: GMSNavigator, didArriveAt waypoint: GMSNavigationWaypoint) {
    print("You have arrived at: \(waypoint.title)")
    mapView.navigator?.continueToNextDestination()
    mapView.navigator?.isGuidanceActive = true
  }

  // Listener for route change events.
  func navigatorDidChangeRoute(_ navigator: GMSNavigator) {
    print("The route has changed.")
  }

  // Listener for time to next destination.
  func navigator(_ navigator: GMSNavigator, didUpdateRemainingTime time: TimeInterval) {
    print("Time to next destination: \(time)")
  }

  // Delegate for distance to next destination.
  func navigator(
    _ navigator: GMSNavigator,
    didUpdateRemainingDistance distance: CLLocationDistance
  ) {
    let miles = distance * 0.00062137
    print("Distance to next destination: \(miles) miles.")
  }

  // Delegate for traffic updates to next destination
  func navigator(
    _ navigator: GMSNavigator,
    didUpdate delayCategory: GMSNavigationDelayCategory
  ) {
    print("Delay category to next destination: \(String(describing: delayCategory)).")
  }

  // Delegate for suggested lighting mode changes.
  func navigator(
    _ navigator: GMSNavigator,
    didChangeSuggestedLightingMode lightingMode: GMSNavigationLightingMode
  ) {
    print("Suggested lighting mode has changed: \(String(describing: lightingMode))")

    // Change to the suggested lighting mode.
    mapView.lightingMode = lightingMode
  }

  // Add a button to the view.
  func makeButton() {
    // 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)
  }

}

แสดง/ซ่อนโค้ด Objective-C สำหรับ Listener เหตุการณ์

/*
 * Copyright 2020 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 () <GMSNavigatorListener, GMSRoadSnappedLocationProviderListener>

@end

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

- (void)loadView {

  _locationManager = [[CLLocationManager alloc] init];

  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.67
                                                          longitude:-122.20
                                                               zoom:14];
  _mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];

  // Add listeners for GMSNavigator and GMSRoadSnappedLocationProvider.
  [_mapView.navigator addListener:self];
  [_mapView.roadSnappedLocationProvider addListener:self];

  // Set the time update threshold (seconds) and distance update threshold (meters).
  _mapView.navigator.timeUpdateThreshold = 10;
  _mapView.navigator.distanceUpdateThreshold = 100;

  // Set the initial lighting mode on launch or setup.
  _mapView.lightingMode = _mapView.navigator.suggestedLightingMode;

  // 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;

       // Request authorization to use location services.
       [_locationManager requestAlwaysAuthorization];

     } else {
       // Handle the case when the user rejects 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.navigator.guidanceActive = YES;
                               _mapView.navigator.sendsBackgroundNotifications = YES;
                               _mapView.cameraMode = GMSNavigationCameraModeFollowing;
                               [_mapView.locationSimulator simulateLocationsAlongExistingRoute];
                             }];

  [_mapView.roadSnappedLocationProvider startUpdatingLocation];
}

#pragma mark - GMSNavigatorListener
// Listener for continuous location updates.
- (void)locationProvider:(GMSRoadSnappedLocationProvider *)locationProvider
      didUpdateLocation:(CLLocation *)location {
  NSLog(@"Location: %@", location.description);
}

// Listener to handle speeding events.
- (void)navigator:(GMSNavigator *)navigator
    didUpdateSpeedingPercentage:(CGFloat)percentageAboveLimit {
  NSLog(@"Speed is %f percent above the limit.", percentageAboveLimit);
}

// Listener to handle arrival events.
- (void)navigator:(GMSNavigator *)navigator didArriveAtWaypoint:(GMSNavigationWaypoint *)waypoint {
  NSLog(@"You have arrived at: %@", waypoint.title);
  [_mapView.navigator continueToNextDestination];
  _mapView.navigator.guidanceActive = YES;
}

// Listener for route change events.
- (void)navigatorDidChangeRoute:(GMSNavigator *)navigator {
  NSLog(@"The route has changed.");
}

// Listener for time to next destination.
- (void)navigator:(GMSNavigator *)navigator didUpdateRemainingTime:(NSTimeInterval)time {
  NSLog(@"Time to next destination: %f", time);
}

// Listener for distance to next destination.
- (void)navigator:(GMSNavigator *)navigator
      didUpdateRemainingDistance:(CLLocationDistance)distance {
  double miles = distance * 0.00062137;
  NSLog(@"%@", [NSString stringWithFormat:@"Distance to next destination: %.2f.", miles]);
}

// Listener for traffic updates for next destination
- (void)navigator:(GMSNavigator *)navigator
    didUpdateDelayCategory:(GMSNavigationDelayCategory)delayCategory {
  NSLog(@"Delay category to next destination: %ld.", delayCategory);
}

// Listener for suggested lighting mode changes.
-(void)navigator:(GMSNavigator *)navigator
      didChangeSuggestedLightingMode:(GMSNavigationLightingMode)lightingMode {
  NSLog(@"Suggested lighting mode has changed: %ld", (long)lightingMode);

  // Change to the suggested lighting mode.
  _mapView.lightingMode = lightingMode;
}

#pragma mark - Programmatic UI elements

// Add a button to the view.
- (void)makeButton {
  // 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 setAlpha:0.5];
  navButton.frame = CGRectMake(5.0, 150.0, 100.0, 35.0);
  [_mapView addSubview:navButton];
}

@end

การประกาศความสอดคล้องกับโปรโตคอลที่จำเป็น

ก่อนที่จะใช้วิธีการนำทาง ตัวควบคุมมุมมองต้องใช้โปรโตคอลต่อไปนี้

Swift

class ViewController:
  UIViewController,
  GMSNavigatorListener,
  GMSRoadSnappedLocationProviderListener
{
}

Objective-C

@interface ViewController () <GMSNavigatorListener, GMSRoadSnappedLocationProviderListener>
@end

หลังจากใช้โปรโตคอลการนำทางแล้ว ให้ตั้งค่า Listener เป็น View Controller ตัวอย่างเช่น คุณสามารถเพิ่มโค้ดต่อไปนี้ลงในเมธอด viewDidLoad()

Swift

mapView.navigator?.add(self)
mapView.roadSnappedLocationProvider?.add(self)

Objective-C

[_mapView.navigator addListener:self];
[_mapView.roadSnappedLocationProvider addListener:self];

การรับหรือหยุดการอัปเดตตำแหน่ง

ต้องมีการอัปเดตตำแหน่งเพื่อแสดงความคืบหน้าของผู้ใช้บนแผนที่

อินสแตนซ์ location จะแสดงพร็อพเพอร์ตี้ต่อไปนี้

พร็อพเพอร์ตี้สถานที่ตั้ง	คำอธิบาย
ระดับความสูง	ระดับความสูงปัจจุบัน
coordinate.latitude	พิกัดละติจูดปัจจุบันที่สแนปกับถนน
coordinate.longitude	พิกัดลองจิจูดที่สแนปกับถนนในปัจจุบัน
หลักสูตร	ทิศทางปัจจุบันเป็นองศา
ความเร็ว	ความเร็วในปัจจุบัน
การประทับเวลา	วันที่/เวลาของค่าที่อ่านได้ในปัจจุบัน

ข้อควรระวัง: การอัปเดตตำแหน่งอาจส่งผลต่อระยะเวลาการใช้งานแบตเตอรี่ ดังนั้นให้เปิดใช้การอัปเดตเมื่อจำเป็นเท่านั้น เรียกใช้ฟังก์ชัน stopUpdatingLocation

หากต้องการรับการอัปเดตตำแหน่งอย่างต่อเนื่อง ให้เรียกใช้ mapView.roadSnappedLocationProvider.startUpdatingLocation และใช้ GMSRoadSnappedLocationProviderListener เพื่อจัดการเหตุการณ์ didUpdateLocation

ตัวอย่างต่อไปนี้แสดงการเรียก startUpdatingLocation

Swift

mapView.roadSnappedLocationProvider.startUpdatingLocation()

Objective-C

[_mapView.roadSnappedLocationProvider startUpdatingLocation];

โค้ดต่อไปนี้จะสร้าง GMSRoadSnappedLocationProviderListener ที่จัดการเหตุการณ์ didUpdateLocation

Swift

func locationProvider(_ locationProvider: GMSRoadSnappedLocationProvider,
                      didUpdate location: CLLocation) {
  print("Location: \(location.description)")
}

Objective-C

- (void)locationProvider:(GMSRoadSnappedLocationProvider *)locationProvider
       didUpdateLocation:(CLLocation *)location {
  NSLog(@"Location: %@", location.description);
}

หากต้องการรับการอัปเดตตำแหน่งเมื่อแอปทำงานอยู่เบื้องหลัง ให้ตั้งค่า allowsBackgroundLocationUpdates เป็น "จริง" ดังนี้

Swift

mapView.roadSnappedLocationProvider.allowsBackgroundLocationUpdates = true

Objective-C

 _mapView.roadSnappedLocationProvider.allowsBackgroundLocationUpdates = YES;

การตรวจจับเหตุการณ์การมาถึง

แอปของคุณใช้เหตุการณ์ didArriveAtWaypoint เพื่อตรวจจับเมื่อถึงปลายทางแล้ว คุณสามารถกลับมาใช้คำแนะนำและไปยังจุดอ้างอิงถัดไปได้โดยโทรหา continueToNextDestinationWithCompletion() แล้วเปิดใช้คำแนะนำอีกครั้ง แอปของคุณต้องเปิดใช้คำแนะนำอีกครั้งหลังจากเรียกใช้ continueToNextDestinationWithCompletion()

หลังจากที่แอปเรียกใช้ continueToNextDestinationWithCompletion แล้ว เครื่องมือนำทางจะไม่มีข้อมูลเกี่ยวกับจุดหมายก่อนหน้าอีกต่อไป หากต้องการวิเคราะห์ข้อมูลเกี่ยวกับช่วงเส้นทาง คุณต้องดึงข้อมูลนี้จากเครื่องมือนำทางก่อนเรียกใช้ continueToNextDestinationWithCompletion()

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีจัดการเหตุการณ์ didArriveAtWaypoint

Swift

func navigator(_ navigator: GMSNavigator, didArriveAt waypoint: GMSNavigationWaypoint) {
  print("You have arrived at: \(waypoint.title)")
  mapView.navigator?.continueToNextDestinationWithCompletion { _, _ in }
  mapView.navigator?.isGuidanceActive = true
}

Objective-C

- (void)navigator:(GMSNavigator *)navigator didArriveAtWaypoint:(GMSNavigationWaypoint *)waypoint {
  NSLog(@"You have arrived at: %@", waypoint.title);
  [_mapView.navigator continueToNextDestinationWithCompletion:^(GMSNavigationWaypoint *waypoint,
                                                                GMSRouteStatus status){
  }];
  _mapView.navigator.guidanceActive = YES;
}

การรับข้อมูลอัปเดตการเปลี่ยนแปลงเส้นทาง

หากต้องการรับการแจ้งเตือนเมื่อมีการเปลี่ยนแปลงเส้นทาง ให้สร้างเมธอดเพื่อจัดการเหตุการณ์ navigatorDidChangeRoute คุณเข้าถึงเส้นทางใหม่ได้โดยใช้พร็อพเพอร์ตี้ routeLegs และ currentRouteLeg ของ GMSNavigator

Swift

func navigatorDidChangeRoute(_ navigator: GMSNavigator) {
  print("The route has changed.")
}

Objective-C

- (void)navigatorDidChangeRoute:(GMSNavigator *)navigator {
  NSLog(@"The route has changed.");
}

การรับข้อมูลอัปเดตเกี่ยวกับเวลาที่ใช้เดินทางไปยังจุดหมาย

หากต้องการรับข้อมูลอัปเดตเวลาถึงจุดหมายอย่างต่อเนื่อง ให้สร้างเมธอดเพื่อจัดการเหตุการณ์ didUpdateRemainingTime พารามิเตอร์ time จะระบุเวลาโดยประมาณเป็นวินาทีจนกว่าจะถึงจุดหมายถัดไป

Swift

func navigator(_ navigator: GMSNavigator, didUpdateRemainingTime time: TimeInterval) {
  print("Time to next destination: \(time)")
}

Objective-C

- (void)navigator:(GMSNavigator *)navigator didUpdateRemainingTime:(NSTimeInterval)time {
  NSLog(@"Time to next destination: %f", time);
}

หากต้องการตั้งค่าการเปลี่ยนแปลงขั้นต่ำในเวลาที่คาดว่าจะถึงจุดหมายถัดไป ให้ตั้งค่าพร็อพเพอร์ตี้ timeUpdateThreshold ใน GMSNavigator โดยค่าจะระบุเป็นวินาที หากไม่ได้ตั้งค่าพร็อพเพอร์ตี้นี้ บริการจะใช้ค่าเริ่มต้นเป็น 1 วินาที

Swift

navigator?.timeUpdateThreshold = 10

Objective-C

navigator.timeUpdateThreshold = 10;

การรับข้อมูลอัปเดตเกี่ยวกับระยะทางไปยังจุดหมาย

หากต้องการรับข้อมูลอัปเดตระยะทางไปยังจุดหมายอย่างต่อเนื่อง ให้สร้างเมธอดเพื่อจัดการเหตุการณ์ didUpdateRemainingDistance พารามิเตอร์ distance จะระบุระยะทางโดยประมาณเป็นเมตรไปยังจุดหมายถัดไป

Swift

func navigator(_ navigator: GMSNavigator, didUpdateRemainingDistance distance: CLLocationDistance)
{
  let miles = distance * 0.00062137
  print("Distance to next destination: \(miles) miles.")
}

Objective-C

- (void)navigator:(GMSNavigator *)navigator
    didUpdateRemainingDistance:(CLLocationDistance)distance {
  double miles = distance * 0.00062137;
  NSLog(@"%@", [NSString stringWithFormat:@"Distance to next destination: %.2f.", miles]);
}

หากต้องการตั้งค่าการเปลี่ยนแปลงขั้นต่ำในระยะทางโดยประมาณไปยังจุดหมายถัดไป ให้ตั้งค่าพร็อพเพอร์ตี้ distanceUpdateThreshold ใน GMSNavigator (ค่าจะระบุเป็นเมตร) หากไม่ได้ตั้งค่าพร็อพเพอร์ตี้นี้ บริการจะใช้ค่าเริ่มต้นเป็น 1 เมตร

Swift

navigator?.distanceUpdateThreshold = 100

Objective-C

navigator.distanceUpdateThreshold = 100;

การรับข้อมูลอัปเดตการจราจร

หากต้องการรับข้อมูลอัปเดตเกี่ยวกับสภาพการจราจรอย่างต่อเนื่องสำหรับเส้นทางที่เหลือ ให้สร้างเมธอดเพื่อจัดการเหตุการณ์ didUpdateDelayCategory การเรียกใช้ delayCategoryToNextDestination จะแสดงผล GMSNavigationDelayCategory ซึ่งให้ค่าตั้งแต่ 0 ถึง 3 การอัปเดตหมวดหมู่จะอิงตามตำแหน่งปัจจุบันของผู้ใช้แอป หากไม่มีข้อมูลการเข้าชม GMSNavigationDelayCategory จะแสดงผลเป็น 0 ตัวเลข 1-3 บ่งบอกถึงปริมาณการไหลที่เพิ่มขึ้นจากน้อยไปมาก

Swift

func navigator(_ navigator: GMSNavigator,
               didUpdate delayCategory: GMSNavigationDelayCategory)
{
  print("Traffic flow to next destination: \(delayCategory)")
}

Objective-C

- (void)navigator:(GMSNavigator *)navigator
    didUpdateDelayCategory:(GMSNavigationDelayCategory)delayCategory {
  NSLog(@"Traffic flow to next destination: %ld", (long)delayCategory);
}

พร็อพเพอร์ตี้ GMSNavigationDelayCategory จะแสดงระดับความล่าช้าต่อไปนี้

หมวดหมู่ความล่าช้า	คำอธิบาย
GMSNavigationDelayCategoryNoData	0 - ไม่พร้อมใช้งาน ไม่มีข้อมูลสำหรับการเข้าชมหรือ :
	เส้นทาง
GMSNavigationDelayCategoryHeavy	1 - สูงมาก
GMSNavigationDelayCategoryMedium	2 - ปานกลาง
GMSNavigationDelayCategoryLight	3 - สว่าง

กำลังรับข้อมูลอัปเดตเกี่ยวกับการขับรถเร็วเกินกำหนด

หากต้องการรับข้อมูลอัปเดตเมื่อคนขับขับรถเกินขีดจำกัดความเร็ว ให้สร้างเมธอดเพื่อจัดการเหตุการณ์ didUpdateSpeedingPercentage

Swift

// Listener to handle speeding events.
func navigator(_ navigator: GMSNavigator,
               didUpdateSpeedingPercentage percentageAboveLimit: CGFloat)
{
  print("Speed is \(percentageAboveLimit) above the limit.")
}

Objective-C

// Listener to handle speeding events.
- (void)navigator:(GMSNavigator *)navigator
    didUpdateSpeedingPercentage:(CGFloat)percentageAboveLimit {
  NSLog(@"Speed is %f percent above the limit.", percentageAboveLimit);
}

กำลังเปลี่ยนโหมดแสงที่แนะนำ

GMSNavigator จะคำนวณโหมดแสงที่แนะนำตามช่วงเวลาของวันและตำแหน่งของอุปกรณ์ และเรียกใช้เมธอด Listener didChangeSuggestedLightingMode เฉพาะเมื่อโหมดที่แนะนำมีการเปลี่ยนแปลง (เช่น เมื่อพระอาทิตย์ขึ้นหรือพระอาทิตย์ตก) เพื่อให้แผนที่เริ่มต้นด้วยโหมดแสงที่เหมาะสมเมื่อผู้ใช้เปิดแอป ให้ตั้งค่า mapView.lightingMode เป็น suggestedLightingMode ของเครื่องนำทางระหว่างการเริ่มต้น และใช้ didChangeSuggestedLightingMode เพื่อจัดการการเปลี่ยนแปลงที่ตามมา

ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่าโหมดแสงเริ่มต้นและฟังการเปลี่ยนแปลงโหมดแสงที่แนะนำ

Swift

// Set the initial lighting mode on launch or setup.
mapView.lightingMode = mapView.navigator?.suggestedLightingMode ?? .normal

// Define a listener for suggested changes to lighting mode.
func navigator(_ navigator: GMSNavigator,
               didChangeSuggestedLightingMode lightingMode: GMSNavigationLightingMode)
{
  print("Suggested lighting mode has changed: \(String(describing: lightingMode))")

  // Make the suggested change.
  mapView.lightingMode = lightingMode
}

Objective-C

// Set the initial lighting mode on launch or setup.
_mapView.lightingMode = _mapView.navigator.suggestedLightingMode;

// Define a listener for suggested changes to lighting mode.
- (void)navigator:(GMSNavigator *)navigator
    didChangeSuggestedLightingMode:(GMSNavigationLightingMode)lightingMode {
  NSLog(@"Suggested lighting mode has changed: %ld", (long)lightingMode);

  // Make the suggested change.
  _mapView.lightingMode = lightingMode;
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าโหมดแสงอัตโนมัติและด้วยตนเองได้ที่หัวข้อกำหนดค่าโหมดปกติและโหมดแสงน้อย