<GMSNavigatorListener> การอ้างอิงโปรโตคอล

<GMSNavigatorListener> การอ้างอิงโปรโตคอล

ภาพรวม

Listener เหตุการณ์ใน GMSNavigator

ฟังก์ชันสมาชิกแบบสาธารณะ

(void) - ตัวนำทาง:didReachAtWaypoint:
 โทรเมื่อคนขับมาถึง GMSNavigationWaypoint
(void) - navigatorDidChangeRoute:
 เรียกใช้เมื่อมีการเปลี่ยนแปลงหรือล้างเส้นทางปัจจุบัน
(void) - ตัวนำทาง:didUpdateRemainingTime:
 โทรเมื่ออัปเดตเวลาโดยประมาณไปยังจุดหมาย
(void) - ตัวนำทาง:didUpdateRemainingDistance:
 เรียกใช้เมื่อมีการอัปเดตระยะทางโดยประมาณไปยังจุดหมาย
(void) - navigator:didUpdateDelayCategory:
 เรียกใช้เมื่อมีการอัปเดตหมวดหมู่ความล่าช้าไปยังปลายทาง
(void) - ตัวนำทาง:didChangeSuggestedLightingMode:
 เรียกใช้เมื่อมีการอัปเดตสภาพแสงโดยประมาณ เช่น เวลากลางคืนที่ตำแหน่งปัจจุบันของอุปกรณ์
(void) - ตัวนำทาง:didUpdateSpeedingPercentage:
 แจ้งว่าคนขับใช้ความเร็วเกินขีดจำกัดตามเปอร์เซ็นต์ที่ระบุ
(void) - navigator:didUpdateSpeedAlertSeverity:speedingPercentage:
 แจ้งให้คุณทราบว่าอุปกรณ์ตรวจพบว่ารถใช้ความเร็วเกินขีดจำกัดตามเปอร์เซ็นต์ที่ระบุ พร้อมทั้งระดับความรุนแรงของการแจ้งเตือนความเร็วในปัจจุบัน
(void) - ตัวนำทาง:didUpdateNavInfo:
 เรียกใช้เมื่ออัปเดต GMSNavigationNavInfo ปัจจุบัน

เอกสารประกอบเกี่ยวกับฟังก์ชันสมาชิก

- ตัวนำทาง (โมฆะ): (GMSNavigator *) ตัวนำทาง
ได้ไปถึงAtWaypoint: (GMSNavigationWaypoint *) จุดอ้างอิง
[optional]

โทรเมื่อคนขับมาถึง GMSNavigationWaypoint

พารามิเตอร์:
จุดอ้างอิงจุดอ้างอิงที่ไปถึง
- (void) navigatorDidChangeRoute: (GMSNavigator *) ตัวนำทาง [optional]

เรียกใช้เมื่อมีการเปลี่ยนแปลงหรือล้างเส้นทางปัจจุบัน

โปรดทราบว่าทริกเกอร์สำหรับ Listener นี้มีอยู่หลายประเภท ซึ่งรวมถึงแต่ไม่จำกัดเพียงทริกเกอร์ต่อไปนี้

  • อัปเดตการเดินทางที่กำลังดำเนินการอยู่
  • คนขับออกจากเส้นทางปัจจุบัน
  • คนขับเลือกเส้นทางอื่นจาก UI
  • มีการเสนอคนขับหรือต้องใช้เส้นทางที่ดีกว่า
  • คนขับเริ่มนำทางไปยังจุดหมาย (ผ่านการโทรหา setDestinations)
  • คนขับเริ่มนำทางไปยังจุดอ้างอิงใหม่หลังจากไปถึงจุดก่อนหน้า
  • ล้างเส้นทางแล้ว (ผ่านการเรียก clearDestinations)
- ตัวนำทาง (โมฆะ): (GMSNavigator *) ตัวนำทาง
DidUpdateRemainingTime: (NSTimeInterval) เวลา
[optional]

โทรเมื่ออัปเดตเวลาโดยประมาณไปยังจุดหมาย

พารามิเตอร์:
เวลาเวลาที่จะถึงจุดหมายถัดไป
- ตัวนำทาง (โมฆะ): (GMSNavigator *) ตัวนำทาง
DidUpdateRemainingDistance: (CLLocationLocation) ระยะทาง
[optional]

เรียกใช้เมื่อมีการอัปเดตระยะทางโดยประมาณไปยังจุดหมาย

พารามิเตอร์:
ระยะทางระยะทางไปยังจุดหมายถัดไป
- ตัวนำทาง (โมฆะ): (GMSNavigator *) ตัวนำทาง
DidUpdateDelayCategory: (GMSNavigationDelayCategory) delayCategory
[optional]

เรียกใช้เมื่อมีการอัปเดตหมวดหมู่ความล่าช้าไปยังปลายทาง

พารามิเตอร์:
delayCategoryหมวดหมู่ความล่าช้าไปยังจุดหมายถัดไป
- ตัวนำทาง (โมฆะ): (GMSNavigator *) ตัวนำทาง
DidChangesuggestedLightingMode: (GMSNavigationLightingMode) lightingMode
[optional]

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

พารามิเตอร์:
lightingModeโหมดสีที่แนะนำเพื่อให้ตรงกับสภาพแสงในปัจจุบัน
- ตัวนำทาง (โมฆะ): (GMSNavigator *) ตัวนำทาง
DidUpdateSpeedingPercentage: (CGFloat) percentageAboveLimit
[optional]

แจ้งว่าคนขับใช้ความเร็วเกินขีดจำกัดตามเปอร์เซ็นต์ที่ระบุ

พารามิเตอร์:
ตัวนำทางGMSNavigator ที่รายงานความเร็ว
percentageAboveLimitเปอร์เซ็นต์ที่เกินขีดจำกัดความเร็วที่คนขับกำลังขับอยู่ ตั้งค่าเป็น 0 เมื่อคนขับไม่ได้เร่งความเร็ว ตั้งค่าเป็น -1 เมื่อขีดจำกัดความเร็วหรือความเร็วปัจจุบันไม่ถูกต้อง
- ตัวนำทาง (โมฆะ): (GMSNavigator *) ตัวนำทาง
DidUpdateSpeedAlertSeverity: (GMSNavigationSpeedAlertSeverity) speedAlertSeverity
SpeedingPercentage: (CGFloat) percentageAboveLimit
[optional]

แจ้งให้คุณทราบว่าอุปกรณ์ตรวจพบว่ารถใช้ความเร็วเกินขีดจำกัดตามเปอร์เซ็นต์ที่ระบุ พร้อมทั้งระดับความรุนแรงของการแจ้งเตือนความเร็วในปัจจุบัน

ระบบจะเรียกข้อมูลนี้เป็นระยะๆ เมื่อมีการอัปเดตความเร็วหรือขีดจำกัดความเร็วที่ถูกต้อง ซึ่งมักจะส่งผลให้เกิดสายหลายครั้งระหว่างการนำทางที่ใช้งานอยู่เมื่อคนขับเคลื่อนที่

พารามิเตอร์:
ตัวนำทางGMSNavigator ที่รายงานความเร็ว
speedAlertSeverityความรุนแรงของการแจ้งเตือนความเร็วปัจจุบัน ตั้งค่าเป็น GMSNavigationSpeedAlertSeverityUnknown เมื่อไม่ทราบการจำกัดความเร็วหรือความเร็วไม่ถูกต้อง ตั้งค่าเป็น GMSNavigationSpeedAlertSeverityNotSpeeding เมื่อคนขับไม่ได้ปรับความเร็วตามเกณฑ์ที่กำหนดค่าไว้ใน GMSNavigationSpeedAlertOptions เมื่อคนขับเร่งความเร็ว ระบบจะตั้งค่านี้เป็น GMSNavigationSpeedAlertSeverityMinor หรือ GMSNavigationSpeedAlertSeverityMajor ตามเกณฑ์ที่กำหนดค่าไว้
percentageAboveLimitเปอร์เซ็นต์ที่เกินขีดจำกัดความเร็วที่คนขับกำลังขับอยู่ ใช้ได้เฉพาะเมื่อ SpeedAlertSeverity เป็นน้อยหรือสำคัญเท่านั้น
- ตัวนำทาง (โมฆะ): (GMSNavigator *) ตัวนำทาง
DidUpdateNavInfo: (GMSNavigationNavInfo *) navInfo
[optional]

เรียกใช้เมื่ออัปเดต GMSNavigationNavInfo ปัจจุบัน

การเรียกนี้จะเรียกใช้เป็นประจำในระหว่างการนำทางที่ทำงานอยู่

พารามิเตอร์:
navInfoGMSNavigationNavInfo ที่อัปเดตแล้ว