ภาพรวม
นี่คือคลาสหลักของ Google Navigation SDK สำหรับ iOS และนำเสนอวิธีการสำหรับการควบคุมการนำทางไปยังปลายทาง ตลอดจนการเข้าถึงข้อมูลเส้นทางและความคืบหน้า
คลาสนี้ไม่รองรับคลาสย่อย
คลาสนี้ไม่ปลอดภัยสำหรับชุดข้อความ ต้องเรียกใช้เมธอดทั้งหมดจากเทรดหลัก
ฟังก์ชันสมาชิกแบบสาธารณะ | |
| (void) | - addListener: |
| เพิ่ม Listener | |
| (BOOL) | - removeListener: |
| นำ Listener ออก | |
| (void) | - setDestinations:callback: |
| ตั้งค่าจุดหมายหลายแห่งสำหรับการนำทาง โดยลบล้างจุดหมายที่กำหนดไว้ก่อนหน้านี้ | |
| (void) | - setDestinations:routingOptions:callback: |
| ตั้งค่าจุดหมายหลายแห่งสำหรับการนำทาง โดยลบล้างจุดหมายที่กำหนดไว้ก่อนหน้านี้ | |
| (void) | - setDestinations:routeToken:callback: |
| ตั้งค่าจุดหมายหลายแห่งสำหรับการนำทาง โดยใช้โทเค็นสำหรับเส้นทางเพื่อไปยังส่วนต่างๆ ในเส้นทางที่คำนวณไว้ล่วงหน้า | |
| (void) | - getRouteInfoForDestination:withRoutingOptions:callback: |
| แสดงผลข้อมูลเส้นทางตามกลยุทธ์การกำหนดเส้นทาง: เส้นทางที่ดีที่สุดหรือสั้นลงตามค่าเริ่มต้น | |
| (GMSNavigationWaypoint *) ที่ไม่มีข้อมูลได้ | - continueToNextDestination |
| เลิกใช้งานแล้ว | |
| (void) | - clearDestinations |
| ล้างจุดหมายที่กำหนดไว้ก่อนหน้านี้ทั้งหมดและนำเส้นทางที่คำนวณแล้วออกจากแผนที่ | |
| (NSTimeInterval) | - timeToWaypoint: |
| แสดงเวลาโดยประมาณไปยังจุดอ้างอิงที่ระบุ หรือ CLTimeIntervalMax หากจุดอ้างอิงไม่ได้เป็นส่วนหนึ่งของเส้นทางปัจจุบัน | |
| (CLLocationLocation) | - distanceToWaypoint: |
| แสดงผลระยะทางโดยประมาณไปยังจุดอ้างอิงที่ระบุ หรือ CLLocationDistanceMax หากจุดอ้างอิงไม่ได้เป็นส่วนหนึ่งของเส้นทางปัจจุบัน | |
| (void) | - setTransactionIDs:errorHandler: |
| ตั้งค่าและบันทึกไปยังเซิร์ฟเวอร์สำหรับรหัสธุรกรรมต่อเนื่องที่ใช้กับเหตุการณ์การนำทางระหว่างเซสชันการนำทางปัจจุบัน | |
พร็อพเพอร์ตี้ | |
| บูลีน | avoidsHighways |
| ควรหลีกเลี่ยงทางหลวงเมื่อสร้างเส้นทางไปยังจุดหมายหรือไม่ | |
| บูลีน | avoidsTolls |
| ควรหลีกเลี่ยงถนนที่เรียกเก็บค่าผ่านทางเมื่อสร้างเส้นทางไปยังจุดหมายหรือไม่ | |
| บูลีน | avoidsFerries |
| ควรหลีกเลี่ยงเรือข้ามฟากเมื่อสร้างเส้นทางไปยังจุดหมายหรือไม่ | |
| GMSNavigationLicensePlateRestriction * | licensePlateRestriction |
| ตั้งค่าการจำกัดป้ายทะเบียนด้วยตัวเลขสุดท้ายของป้ายทะเบียนและรหัสประเทศปัจจุบัน | |
| บูลีน | guidanceActive |
| คำแนะนำแบบเลี้ยวต่อเลี้ยวเปิดใช้งานอยู่หรือไม่ | |
| บูลีน | stopGuidanceAtArrival |
กำหนดว่าคำแนะนำควรหยุดโดยอัตโนมัติหรือไม่เมื่อมีการเรียกใช้ -navigator:didReachAtWaypoint: | |
| NSTimeInterval | timeUpdateThreshold |
การเปลี่ยนแปลงขั้นต่ำโดยประมาณเพื่อไปยังปลายทางถัดไปซึ่งจะเรียกให้เรียกใช้เมธอด navigator:didUpdateRemainingTime: | |
| ระยะทางของ CLLocation | distanceUpdateThreshold |
การเปลี่ยนแปลงต่ำสุดในระยะทางโดยประมาณไปยังจุดหมายถัดไปซึ่งจะเรียกใช้เมธอด navigator:didUpdateRemainingDistance: | |
| NSTimeInterval | timeToNextDestination |
| แสดงเวลาโดยประมาณไปยังจุดหมายถัดไป | |
| ระยะทางของ CLLocation | distanceToNextDestination |
| แสดงระยะทางโดยประมาณไปยังจุดหมายถัดไป | |
| GMSNavigationDelayCategory | delayCategoryToNextDestination |
| แสดงหมวดหมู่ความล่าช้าไปยังปลายทางถัดไป | |
| GMSRouteLeg * | currentRouteLeg |
| ระยะเวลาปัจจุบันของการเดินทาง | |
| NSArray< GMSRouteLeg * > * | routeLegs |
| อาร์เรย์ของขาเส้นทางซึ่งแต่ละขาตรงกับปลายทางที่ตั้งไว้ | |
| GMSPath * | traveledPath |
| ตั้งค่าเส้นทางที่อุปกรณ์ใช้นับตั้งแต่ครั้งล่าสุดที่นำทางมีการใช้งานเป็น "ใช่" | |
| GMSNavigationVoiceGuidance | voiceGuidance |
| กำหนดว่าควรเปิดใช้งานการนำทางด้วยเสียงสำหรับการแจ้งเตือนการจราจรและการแจ้งเตือนแบบเลี้ยวต่อเลี้ยวหรือไม่ | |
| GMSVoiceGuidanceAudioDeviceType | audioDeviceType |
| กำหนดเสียงการนำทางของอุปกรณ์เสียงที่สามารถเล่นได้ | |
| บูลีน | vibrationEnabled |
| กำหนดว่าอุปกรณ์จะสั่นเมื่อมีการเล่นการแจ้งเตือนด้วยเสียงหรือไม่ | |
| บูลีน | sendsBackgroundNotifications |
| กําหนดว่าจะแสดง UILocalNotifications ที่มีข้อมูลคำแนะนำเมื่อแอปอยู่ในเบื้องหลังหรือไม่ | |
| GMSNavigationLightingMode | suggestedLightingMode |
| โหมดแสงที่แนะนำ อิงตามเวลาและตำแหน่งของอุปกรณ์ | |
| บูลีน | shouldDisplayPrompts |
| กำหนดว่าควรแสดงข้อความแจ้งสำหรับการจราจร เส้นทางและเหตุการณ์ที่ดีกว่าหรือไม่ | |
| GMSNavigationSpeedAlertOptions * | speedAlertOptions |
| GMSNavigationSpeedAlertOptions สำหรับการปรับแต่งเกณฑ์ทริกเกอร์สำหรับ GMSNavigationSpeedAlertSeverity | |
ฟังก์ชันที่เกี่ยวข้อง | |
(โปรดทราบว่ารายการเหล่านี้ไม่ใช่ฟังก์ชันสมาชิก) | |
| typedef void(^) | GMSRouteStatusCallback )(GMSRouteStatus pathStatus) |
| เรียกใช้เมื่อพบเส้นทางจากตำแหน่งของอุปกรณ์ไปยังปลายทางที่ระบุ หรือไม่พบด้วยเหตุผลที่ระบุโดย RouteStatus | |
| typedef void(^) | GMSRouteInfoCallback )(GMSNavigationRouteInfo *_Nullable pathInfo) |
| เรียกใช้เมื่อมีการคำนวณข้อมูลเส้นทาง (เวลาถึงโดยประมาณและระยะทาง) ไปยังจุดอ้างอิงที่ระบุ | |
| typedef void(^) | GMSNavigationTransactionIDErrorHandler )(NSError *ข้อผิดพลาด) |
| เรียกใช้หากการตั้งค่ารหัสธุรกรรมผ่าน setTransactionID ไม่สำเร็จ | |
เอกสารประกอบเกี่ยวกับฟังก์ชันของสมาชิก
| - (เป็นโมฆะ) addListener: | (รหัส< GMSNavigatorListener >) | ผู้ฟัง |
เพิ่ม Listener
ผู้ฟังมีการอ้างอิงที่ไม่รัดกุม
- พารามิเตอร์:
-
Listener ออบเจ็กต์ที่สอดคล้องกับโปรโตคอล GMSNavigatorListener
| - (BOOL) removeListener: | (รหัส< GMSNavigatorListener >) | ผู้ฟัง |
นำ Listener ออก
- พารามิเตอร์:
-
Listener ออบเจ็กต์ที่สอดคล้องกับโปรโตคอล GMSNavigatorListener
- การคืนสินค้า:
- ส่งคืน "ใช่" หากผู้ฟังถูกนำออก แสดงผล NO หากออบเจ็กต์ไม่ใช่ Listener
| - (เป็นโมฆะ) setDestinations: | (NSArray< GMSNavigationWaypoint * > *) | ปลายทาง | |
| ติดต่อกลับ: | (GMSRouteStatusCallback) | ติดต่อกลับ | |
ตั้งค่าจุดหมายหลายแห่งสำหรับการนำทาง โดยลบล้างจุดหมายที่กำหนดไว้ก่อนหน้านี้
ระบบจะเรียกใช้โค้ดเรียกกลับที่ระบุด้วย GMSRouteStatusOK หากพบเส้นทางจากตำแหน่งของอุปกรณ์ไปยังปลายทางที่ระบุ หากมีการตั้งค่าปลายทางใหม่ก่อนที่จะพบเส้นทาง ระบบจะยกเลิกคำขอและติดต่อกลับด้วย GMSRouteStatusCanceled หากไม่พบเส้นทางไม่ว่าด้วยเหตุผลอื่นใด ระบบจะเรียกใช้โค้ดเรียกกลับพร้อมด้วยสถานะข้อผิดพลาดที่เหมาะสม
ระบบจะส่งโค้ดเรียกกลับแบบไม่พร้อมกันในคิวหลักเสมอ
| - (เป็นโมฆะ) setDestinations: | (NSArray< GMSNavigationWaypoint * > *) | ปลายทาง | |
| ตัวเลือกการกำหนดเส้นทาง | (GMSNavigationRoutingOptions *) | routingOptions | |
| ติดต่อกลับ: | (GMSRouteStatusCallback) | ติดต่อกลับ | |
ตั้งค่าจุดหมายหลายแห่งสำหรับการนำทาง โดยลบล้างจุดหมายที่กำหนดไว้ก่อนหน้านี้
ระบบจะคำนวณเส้นทางที่ส่งคืนโดยใช้ตัวเลือกการกำหนดเส้นทาง
- พารามิเตอร์:
-
ปลายทาง อาร์เรย์ของจุดอ้างอิงปลายทาง routingOptions ตัวเลือกที่มีผลต่อตรรกะการกำหนดเส้นทาง (กลยุทธ์การกำหนดเส้นทาง) โค้ดเรียกกลับ เรียกใช้เมื่อพบเส้นทางจากสถานที่ตั้งของผู้บริโภคไปยังปลายทางที่ระบุ หรือไม่พบด้วยเหตุผลที่ระบุโดย RouteStatus
| - (เป็นโมฆะ) setDestinations: | (NSArray< GMSNavigationWaypoint * > *) | ปลายทาง | |
| โทเค็นเส้นทาง: | (NSString *) | routeToken | |
| ติดต่อกลับ: | (GMSRouteStatusCallback) | ติดต่อกลับ | |
ตั้งค่าจุดหมายหลายแห่งสำหรับการนำทาง โดยใช้โทเค็นสำหรับเส้นทางเพื่อไปยังส่วนต่างๆ ในเส้นทางที่คำนวณไว้ล่วงหน้า
เส้นทางจะเหมือนกัน คือมีการเปลี่ยนแปลงตำแหน่งเริ่มต้นของผู้ขับและสภาพถนน/การจราจร แต่การเปลี่ยนเส้นทางจะยังเกิดขึ้นตามตัวเลือกการกำหนดเส้นทางที่เข้ารหัสในโทเค็น
รองรับเฉพาะ GMSNavigationTravelModeDriving และ GMSNavigationTravelModeTwoWheeler เมื่อคุณใช้โทเค็นเส้นทางเพื่อเริ่มเซสชันการนําทาง กำหนดค่าโหมดการเดินทางโดยการตั้งค่า travelMode การโทรจะล้มเหลวหากระบบไม่รองรับรูปแบบการเดินทางปัจจุบัน และจะแสดงผล GMSRouteStatusTravelModeUnsupported ในโค้ดเรียกกลับ
- พารามิเตอร์:
-
ปลายทาง อาร์เรย์ของจุดอ้างอิงปลายทางควรเหมือนกับปลายทางที่กําหนดให้กับ RoutesPreferred API เพื่อรับโทเค็นเส้นทาง routeToken สตริงโทเค็นเส้นทางที่แสดงผลโดย RoutesPreferred API ตัวเลือกการกำหนดเส้นทางที่ระบุใน RoutesPreferred API จะได้รับการเข้ารหัสในโทเค็นเส้นทางนี้ และระบบจะใช้เพื่อสร้างเส้นทางที่คำนวณไว้ล่วงหน้าใหม่หรือเส้นทางใหม่เมื่อมีการเปลี่ยนเส้นทาง โค้ดเรียกกลับ เรียกใช้เมื่อพบเส้นทางจากตำแหน่งของผู้บริโภคไปยังปลายทางที่ระบุ หรือไม่พบด้วยเหตุผลที่ระบุโดย RouteStatus
| - (เป็นโมฆะ) getRouteInfoForDestination: | (GMSNavigationWaypoint *) | ปลายทาง | |
| withRoutingOptions: | (GMSNavigationRoutingOptions *) | routingOptions | |
| ติดต่อกลับ: | (GMSRouteInfoCallback) | ติดต่อกลับ | |
แสดงผลข้อมูลเส้นทางตามกลยุทธ์การกำหนดเส้นทาง: เส้นทางที่ดีที่สุดหรือสั้นลงตามค่าเริ่มต้น
แสดงผลค่า nil หากโปรเจ็กต์ไม่มีสิทธิ์เรียก API นี้
- พารามิเตอร์:
-
ปลายทาง จุดอ้างอิงที่เป็นจุดหมาย routingOptions ตัวเลือกที่ใช้เพื่อดึงข้อมูลเส้นทาง ระบบจะไม่สนใจกลยุทธ์การกำหนดเส้นทางและกลยุทธ์เส้นทางอื่น เนื่องจากวิธีนี้จะแสดงข้อมูลเส้นทางสำหรับกลยุทธ์การกำหนดเส้นทางทั้งหมด โค้ดเรียกกลับ ระบบจะโทรกลับเมื่อได้รับข้อมูลเส้นทาง
| - (GMSNavigationWaypoint *) ที่เป็นค่าว่างได้ continueToNextDestination |
เลิกใช้งานแล้ว
เรียกใช้เมธอด -setDestinations:... ด้วยรายการปลายทางใหม่ แทนการเรียกใช้เมธอดนี้
แสดงจุดหมายแรกจากรายการจุดหมายปัจจุบัน หลังจากการโทรครั้งนี้ คำแนะนำจะอยู่ที่ปลายทางถัดไป หากมี
- การคืนสินค้า:
- ตอนนี้การนำทางชี้ทางจะมุ่งหน้าไปยัง หรือไม่มีข้อมูลหากไม่มีจุดอ้างอิงเหลืออยู่
- หมายเหตุ
- เราเลิกใช้งานไปแล้ว โปรดใช้เมธอด -setDestinations:... แบบใดแบบหนึ่งแทน
| - (เป็นโมฆะ) clearDestinations |
ล้างจุดหมายที่กำหนดไว้ก่อนหน้านี้ทั้งหมดและนำเส้นทางที่คำนวณแล้วออกจากแผนที่
หากคำแนะนำทำงานอยู่ คำแนะนำจะหยุดโดยอัตโนมัติ
| - (NSTimeInterval) timeToWaypoint: | (GMSNavigationWaypoint *) | จุดอ้างอิง |
แสดงเวลาโดยประมาณไปยังจุดอ้างอิงที่ระบุ หรือ CLTimeIntervalMax หากจุดอ้างอิงไม่ได้เป็นส่วนหนึ่งของเส้นทางปัจจุบัน
ข้อมูลนี้จะอัปเดตตามตำแหน่งปัจจุบันของอุปกรณ์ขณะที่คำแนะนำทำงานอยู่
แสดงผล CLTimeIntervalMax หากจุดอ้างอิงที่ระบุไม่ใช่ปลายทางในเส้นทางปัจจุบัน
| - (CLLocationDistance) distanceToWaypoint: | (GMSNavigationWaypoint *) | จุดอ้างอิง |
แสดงผลระยะทางโดยประมาณไปยังจุดอ้างอิงที่ระบุ หรือ CLLocationDistanceMax หากจุดอ้างอิงไม่ได้เป็นส่วนหนึ่งของเส้นทางปัจจุบัน
ระบบจะอัปเดตรายการนี้ตามตำแหน่งปัจจุบันของอุปกรณ์ในขณะที่คำแนะนำทำงานอยู่
แสดงผล CLLocationDistanceMax หากจุดอ้างอิงที่ระบุไม่ใช่ปลายทางในเส้นทางปัจจุบัน
| - (เป็นโมฆะ) setTransactionIDs: | (NSArray< NSString * > *) | transactionIDs | |
| เครื่องจัดการข้อผิดพลาด: | (GMSNavigationTransactionIDErrorHandler ที่ไม่มีข้อมูลได้) | errorHandler | |
ตั้งค่าและบันทึกไปยังเซิร์ฟเวอร์สำหรับรหัสธุรกรรมต่อเนื่องที่ใช้กับเหตุการณ์การนำทางระหว่างเซสชันการนำทางปัจจุบัน
ระบบจะล้างรหัสธุรกรรมเมื่อสิ้นสุดเซสชันการนำทาง
- พารามิเตอร์:
-
transactionIDs รหัสธุรกรรมที่ใช้กับเซสชันการนำทางปัจจุบัน รหัสธุรกรรมของธุรกรรมแต่ละรายการที่เรียกเก็บเงินได้ต้องไม่ซ้ำกัน รหัสธุรกรรมแต่ละรายการต้องมีอักขระอย่างน้อย 1 ตัวและไม่เกิน 64 ตัว รายการอาจว่างเปล่าเมื่อธุรกรรมสิ้นสุดลง (แต่เซสชันยังคงดำเนินอยู่) errorHandler การบล็อกที่จะเรียกแบบไม่พร้อมกันในเทรดหลักหากเกิดข้อผิดพลาดเมื่อรหัสธุรกรรมไม่ถูกต้อง
เอกสารเกี่ยวกับเพื่อนและฟังก์ชันที่เกี่ยวข้อง
- (typedef void(^ GMSRouteStatusCallback)(GMSRouteStatus pathStatus)) [related] |
เรียกใช้เมื่อพบเส้นทางจากตำแหน่งของอุปกรณ์ไปยังปลายทางที่ระบุ หรือไม่พบด้วยเหตุผลที่ระบุโดย RouteStatus
- (typedef void(^ GMSRouteInfoCallback)(GMSNavigationRouteInfo *_Nullable pathInfo)) [related]
|
เรียกใช้เมื่อมีการคำนวณข้อมูลเส้นทาง (เวลาถึงโดยประมาณและระยะทาง) ไปยังจุดอ้างอิงที่ระบุ
- พารามิเตอร์:
-
routeInfo ข้อมูลเส้นทางไปยังจุดหมายที่ระบุ เป็นค่า nil หากการคำนวณล้มเหลว
- (typedef void(^ GMSNavigationTransactionIDErrorHandler)(NSError *error)) [related] |
เรียกใช้หากการตั้งค่ารหัสธุรกรรมผ่าน setTransactionID ไม่สำเร็จ
โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบเกี่ยวกับ API
เอกสารประกอบเกี่ยวกับอสังหาริมทรัพย์
- (BOOL) avoidsHighways [read, write, assign] |
ควรหลีกเลี่ยงทางหลวงเมื่อสร้างเส้นทางไปยังจุดหมายหรือไม่
ค่าเริ่มต้นคือ NO
- (BOOL) avoidsTolls [read, write, assign] |
ควรหลีกเลี่ยงถนนที่เรียกเก็บค่าผ่านทางเมื่อสร้างเส้นทางไปยังจุดหมายหรือไม่
ค่าเริ่มต้นคือ NO
- (BOOL) avoidsFerries [read, write, assign] |
ควรหลีกเลี่ยงเรือข้ามฟากเมื่อสร้างเส้นทางไปยังจุดหมายหรือไม่
ค่าเริ่มต้นคือ "ใช่"
- (GMSNavigationLicensePlateRestriction*) licensePlateRestriction [read, write, assign] |
ตั้งค่าการจำกัดป้ายทะเบียนด้วยตัวเลขสุดท้ายของป้ายทะเบียนและรหัสประเทศปัจจุบัน
ซึ่งจะทำให้เราสามารถเดินทางข้ามข้อจำกัดทางถนนบางประเภทที่ยึดตามหมายเลขป้ายทะเบียนรถได้ ซึ่งจะมีผลกับการเรียกใช้ setDestinations หลังจากตั้งค่านี้เท่านั้น โดยหลักการแล้ว คุณควรตั้งค่านี้ทันทีหลังจากได้รับตัวนำทาง
ตั้งค่าเป็น "Nil" หากไม่มีข้อจำกัดป้ายทะเบียน ค่าเริ่มต้นคือ nil
- (BOOL) guidanceActive [read, write, assign] |
คำแนะนำแบบเลี้ยวต่อเลี้ยวเปิดใช้งานอยู่หรือไม่
ถ้าguideActive คือ "ใช่" แต่ไม่มีเส้นทางให้ใช้ในขณะนี้ คำแนะนำจะเริ่มขึ้นเมื่อมีเส้นทางพร้อมใช้งาน คุณสมบัตินี้จะตั้งค่าเป็น ไม่ หากมีการเรียก clearDestinations หรือเรามาถึงจุดอ้างอิง
- (BOOL) stopGuidanceAtArrival [read, write, assign] |
กำหนดว่าคำแนะนำควรหยุดโดยอัตโนมัติหรือไม่เมื่อมีการเรียกใช้ -navigator:didReachAtWaypoint:
หากไม่ ส่วนหัวและส่วนท้ายของการนำทางจะยังคงแสดงต่อไปหลังจากมาถึง ส่วนหัวของการนำทางจะยังคงแสดงขั้นตอนการแนะนำขั้นสุดท้ายต่อไป และส่วนท้ายของการนำทางจะอัปเดตเวลาและระยะทางที่เหลือต่อไปจนกว่าจะครบเวลา/ระยะทางที่ 0 นอกจากนี้ การอัปเดต -navigator:didUpdateRemainingTime และ -navigator:didUpdateRemainingDistance จะยังดำเนินต่อไป ตั้งค่า guidanceActive เป็น "ไม่" อย่างชัดแจ้งเพื่อหยุดข้อมูลอัปเดตและเวลา/ระยะทางที่เหลืออยู่
เมื่อใช่ guidanceActive จะตั้งค่าเป็น "ไม่" โดยอัตโนมัติเมื่อมาถึง
ค่าเริ่มต้นคือ "ใช่"
- (NSTimeInterval) timeUpdateThreshold [read, write, assign] |
การเปลี่ยนแปลงขั้นต่ำโดยประมาณเพื่อไปยังปลายทางถัดไปซึ่งจะเรียกให้เรียกใช้เมธอด navigator:didUpdateRemainingTime:
หากตั้งค่าเป็น NSTimeIntervalMax จะเป็นการปิดใช้การเรียกกลับสำหรับการอัปเดตเวลา หากตั้งค่าเป็นค่าลบ ระบบจะใช้เกณฑ์เริ่มต้นที่ 1 วินาที ค่าเริ่มต้นคือ 1 วินาที
- หมายเหตุ
- ระบบจะไม่สนใจค่านี้หากไม่มี Listener ใช้
navigator:didUpdateRemainingTime:
- (CLLocationระยะทาง) distanceUpdateThreshold [read, write, assign] |
การเปลี่ยนแปลงต่ำสุดในระยะทางโดยประมาณไปยังจุดหมายถัดไปซึ่งจะเรียกใช้เมธอด navigator:didUpdateRemainingDistance:
หากตั้งค่าเป็น CLLocationDistanceMax ระบบจะปิดการเรียกกลับสำหรับการอัปเดตระยะทางด้วย หากกำหนดค่านี้เป็นค่าลบ ระบบจะใช้เกณฑ์เริ่มต้นที่ 1 เมตร ค่าเริ่มต้นคือ 1 เมตร
- หมายเหตุ
- ระบบจะไม่สนใจค่านี้หากไม่มี Listener ใช้
navigator:didUpdateRemainingDistance:
- (NSTimeInterval) timeToNextDestination [read, assign] |
แสดงเวลาโดยประมาณไปยังจุดหมายถัดไป
ระบบจะอัปเดตรายการนี้ตามตำแหน่งปัจจุบันของอุปกรณ์ในขณะที่คำแนะนำทำงานอยู่
แสดงผล CLTimeIntervalMax หากไม่มีเส้นทาง
- (CLLocationDistance) distanceToNextDestination [read, assign] |
แสดงระยะทางโดยประมาณไปยังจุดหมายถัดไป
ระบบจะอัปเดตรายการนี้ตามตำแหน่งปัจจุบันของอุปกรณ์ในขณะที่คำแนะนำทำงานอยู่
แสดงผล CLLocationDistanceMax หากไม่มีเส้นทาง
- (GMSNavigationDelayCategory) delayCategoryToNextDestination [read, assign] |
แสดงหมวดหมู่ความล่าช้าไปยังปลายทางถัดไป
ระบบจะอัปเดตรายการนี้ตามตำแหน่งปัจจุบันของอุปกรณ์ในขณะที่คำแนะนำทำงานอยู่
แสดงผล GMSNavigationDelayCategoryNoData หากไม่มีเส้นทางหรือไม่มีข้อมูลการจราจร
- (GMSRouteLeg*) currentRouteLeg [read, assign] |
ระยะเวลาปัจจุบันของการเดินทาง
GMSRouteLeg จะมีตำแหน่งเริ่มต้นเป็นตำแหน่งล่าสุดที่ทราบ (สแนปถนน) ของอุปกรณ์
- (NSArray<GMSRouteLeg *>*) routeLegs [read, assign] |
อาร์เรย์ของขาเส้นทางซึ่งแต่ละขาตรงกับปลายทางที่ตั้งไว้
- (GMSPath*) traveledPath [read, assign] |
ตั้งค่าเส้นทางที่อุปกรณ์ใช้นับตั้งแต่ครั้งล่าสุดที่นำทางมีการใช้งานเป็น "ใช่"
เส้นทางนี้จะว่างเปล่าหากคำแนะนำยังไม่ได้เริ่มต้น เส้นทางประกอบด้วยตำแหน่งที่สแนปถนนตามที่ GMSRoadSnappedLocationProvider ส่งคืน แต่ทำให้ลบจุดที่ซ้ำซ้อนออกได้ง่ายขึ้น เช่น การเปลี่ยนจุดคอลัมน์ที่ต่อเนื่องกันให้เป็นส่วนของเส้นตรง
- (GMSNavigationVoiceGuidance) voiceGuidance [read, write, assign] |
กำหนดว่าควรเปิดใช้งานการนำทางด้วยเสียงสำหรับการแจ้งเตือนการจราจรและการแจ้งเตือนแบบเลี้ยวต่อเลี้ยวหรือไม่
ค่าเริ่มต้นคือ GMSNavigationVoiceGuidanceAlertsAndGuidance
- (GMSVoiceGuidanceAudioDeviceType) audioDeviceType [read, write, assign] |
กำหนดเสียงการนำทางของอุปกรณ์เสียงที่สามารถเล่นได้
ค่าเริ่มต้นจะเป็น GMSVoiceGuidanceAudioDeviceTypeBluetooth
- (BOOL) vibrationEnabled [read, write, assign] |
กำหนดว่าอุปกรณ์จะสั่นเมื่อมีการเล่นการแจ้งเตือนด้วยเสียงหรือไม่
- (BOOL) sendsBackgroundNotifications [read, write, assign] |
กําหนดว่าจะแสดง UILocalNotifications ที่มีข้อมูลคำแนะนำเมื่อแอปอยู่ในเบื้องหลังหรือไม่
ค่าเริ่มต้นคือ "ใช่"
- (GMSNavigationLightingMode) suggestedLightingMode [read, assign] |
โหมดแสงที่แนะนำ อิงตามเวลาและตำแหน่งของอุปกรณ์
- (BOOL) shouldDisplayPrompts [read, write, assign] |
กำหนดว่าควรแสดงข้อความแจ้งสำหรับการจราจร เส้นทางและเหตุการณ์ที่ดีกว่าหรือไม่
ค่าเริ่มต้นคือ "ใช่"
- (GMSNavigationSpeedAlertOptions*) speedAlertOptions [read, write, assign] |
GMSNavigationSpeedAlertOptions สำหรับการปรับแต่งเกณฑ์ทริกเกอร์สำหรับ GMSNavigationSpeedAlertSeverity
คุณสามารถใช้พร็อพเพอร์ตี้นี้เพื่อปรับแต่งเกณฑ์การทริกเกอร์การแจ้งเตือนความเร็วเป็นเปอร์เซ็นต์สำหรับทั้งการแจ้งเตือนย่อยและการแจ้งเตือนหลัก คุณยังสามารถใช้วิธีนี้เพื่อปรับแต่งเกณฑ์การเรียกตามเวลาสำหรับการแจ้งเตือนความเร็วหลักได้อีกด้วย
เมื่อตั้งค่า nil คุณจะไม่ได้รับข้อมูลฟีดที่เร่งความเร็ว และการแจ้งเตือนความเร็วเริ่มต้นของ NavSDK จะแสดงดังนี้ การแจ้งเตือนความเร็วจะแสดงข้อความสีแดงเมื่อความเร็วสูงกว่า 5 ไมล์ต่อชั่วโมงหรือ 10 กิโลเมตรต่อชั่วโมง และแสดงข้อความสีขาวและพื้นหลังสีแดงเมื่อความเร็วมากกว่า 10 ไมล์ต่อชั่วโมงหรือ 20 กิโลเมตรต่อชั่วโมง