ใช้คู่มือนี้เพื่อเปิดใช้แอปให้ฟังและตอบสนองต่อเหตุการณ์ต่างๆ ที่เปลี่ยนแปลงเมื่อผู้ใช้ไปยังเส้นทาง คู่มือนี้ไม่ได้ครอบคลุมถึง การกำหนดเส้นทาง แต่จะครอบคลุมเฉพาะการตอบสนองต่อเหตุการณ์ตามเส้นทาง
ภาพรวม
Navigation SDK สำหรับ iOS มี Listener
ที่เชื่อมโยงกับตำแหน่งของผู้ใช้และสภาพแวดล้อมตามเส้นทาง รวมถึง
ข้อมูลเวลาและระยะทางที่สำคัญ ในตัวควบคุมมุมมองของแผนที่ แอปของคุณ
ต้องใช้โปรโตคอลสำหรับ Listener เหล่านี้
GMSRoadSnappedLocationProviderListener
และ
GMSNavigatorListener
รายการนี้แสดงเมธอด Listener ที่ใช้ได้สำหรับเหตุการณ์การนำทาง
GMSNavigatorListener.didArriveAtWaypoint
จะทริกเกอร์เมื่อถึงจุดหมายGMSNavigatorListener.navigatorDidChangeRoute
จะทริกเกอร์เมื่อเส้นทางมีการเปลี่ยนแปลงGMSNavigatorListener.didUpdateRemainingTime
จะเรียกซ้ำๆ เมื่อเวลาไปยังจุดหมายถัดไปเปลี่ยนแปลงขณะที่ การนำทางทำงานอยู่GMSNavigatorListener.didUpdateRemainingDistance
จะเรียกใช้ซ้ำๆ เมื่อระยะทางไปยังจุดหมายถัดไปเปลี่ยนแปลงขณะที่ คำแนะนำยังทำงานอยู่GMSNavigatorListener.didUpdateDelayCategory
จะเรียกใช้เมื่อหมวดหมู่ความล่าช้าไปยังจุดหมายถัดไปมีการเปลี่ยนแปลงขณะที่ คำแนะนำใช้งานอยู่GMSNavigatorListener.didChangeSuggestedLightingMode
จะทริกเกอร์เมื่อมีการอัปเดตสภาพแสงโดยประมาณ เช่น เมื่อถึงเวลากลางคืนในตำแหน่งปัจจุบันของผู้ใช้ แสงสว่างจะเปลี่ยนไปGMSNavigatorListener.didUpdateSpeedingPercentage
จะทริกเกอร์เมื่อผู้ขับขี่ใช้ความเร็วเกินขีดจำกัดGMSRoadSnappedLocationProviderListener.didUpdateLocation
จะเรียกใช้ซ้ำๆ เมื่อตำแหน่งของผู้ใช้เปลี่ยนแปลง
ดูรหัส
การประกาศการปฏิบัติตามโปรโตคอลที่จำเป็น
ก่อนที่จะใช้วิธีการนำทาง ตัวควบคุมมุมมองต้องใช้โปรโตคอลต่อไปนี้
Swift
class ViewController: UIViewController, GMSNavigatorListener,
GMSRoadSnappedLocationProviderListener {
Objective-C
@interface ViewController () <GMSNavigatorListener,
GMSRoadSnappedLocationProviderListener>
@end
หลังจากใช้โปรโตคอลการนำทางแล้ว ให้ตั้งค่า Listener เป็น ViewController เช่น คุณเพิ่มโค้ดต่อไปนี้ลงในเมธอด viewDidLoad()
ได้
Swift
mapView.navigator?.add(self) mapView.roadSnappedLocationProvider?.add(self)
Objective-C
[_mapView.navigator addListener:self]; [_mapView.roadSnappedLocationProvider
addListener:self];
การรับหรือหยุดการอัปเดตตำแหน่ง
การอัปเดตตำแหน่งเป็นสิ่งจำเป็นสำหรับการแสดงความคืบหน้าของผู้ใช้บนแผนที่
อินสแตนซ์ location
จะแสดงพร็อพเพอร์ตี้ต่อไปนี้
พร็อพเพอร์ตี้สถานที่ | คำอธิบาย |
---|---|
altitude | ระดับความสูงปัจจุบัน |
coordinate.latitude | พิกัดละติจูดที่สแนปกับถนนปัจจุบัน |
coordinate.longitude | พิกัดลองจิจูดที่สแนปกับถนนปัจจุบัน |
หลักสูตร | การวางแนวปัจจุบันเป็นองศา |
ความเร็ว | ความเร็วปัจจุบัน |
การประทับเวลา | วันที่/เวลาของการอ่านปัจจุบัน |
หากต้องการรับการอัปเดตตำแหน่งอย่างต่อเนื่อง ให้เรียกใช้
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
เป็น true ดังนี้
Swift
mapView.roadSnappedLocationProvider.allowsBackgroundLocationUpdates = true
Objective-C
_mapView.roadSnappedLocationProvider.allowsBackgroundLocationUpdates = YES;
การตรวจหาเหตุการณ์การมาถึง
แอปของคุณใช้เหตุการณ์ didArriveAtWaypoint
เพื่อตรวจหาเมื่อถึงจุดหมาย
คุณสามารถกลับมาขอเส้นทางและไปยังจุดอ้างอิงถัดไปได้โดย
โทรหา continueToNextDestination()
แล้วเปิดใช้การนำทางอีกครั้ง แอปของคุณ
ต้องเปิดใช้คำแนะนำอีกครั้งหลังจากเรียกใช้ continueToNextDestination()
หลังจากที่แอปเรียกใช้ continueToNextDestination
แล้ว Navigator จะไม่มี
ข้อมูลเกี่ยวกับปลายทางก่อนหน้าอีกต่อไป หากต้องการวิเคราะห์ข้อมูลเกี่ยวกับ
ช่วงของเส้นทาง คุณต้องดึงข้อมูลนี้จากเครื่องนำทางก่อนเรียกใช้
continueToNextDestination()
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีจัดการdidArriveAtWaypoint
เหตุการณ์
Swift
func navigator(_ navigator: GMSNavigator, didArriveAt waypoint:
GMSNavigationWaypoint) { print("You have arrived at: \(waypoint.title)")
mapView.navigator?.continueToNextDestination()
mapView.navigator?.isGuidanceActive = true }
Objective-C
- (void)navigator:(GMSNavigator *)navigator
didArriveAtWaypoint:(GMSNavigationWaypoint *)waypoint { NSLog(@"You have
arrived at: %@", waypoint.title); [_mapView.navigator
continueToNextDestination]; _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); }
การเปลี่ยนโหมดแสงที่แนะนำ
หากต้องการรับข้อมูลอัปเดตเกี่ยวกับการเปลี่ยนแปลงแสงโดยประมาณ ให้สร้างวิธีการจัดการdidChangeSuggestedLightingMode
เหตุการณ์
Swift
// 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
// 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; }