ภาพรวม
นี่คือคลาสหลักของ 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 ตัวเลือกที่มีผลต่อตรรกะการกำหนดเส้นทาง (กลยุทธ์การกำหนดเส้นทาง) Callback เรียกใช้เมื่อพบเส้นทางจากสถานที่ตั้งของผู้บริโภคไปยังปลายทางที่ระบุ หรือไม่พบด้วยเหตุผลที่ระบุโดย RouteStatus
- (เป็นโมฆะ) setDestinations: | (NSArray< GMSNavigationWaypoint * > *) | ปลายทาง | |
โทเค็นเส้นทาง: | (NSString *) | routeToken | |
ติดต่อกลับ: | (GMSRouteStatusCallback) | ติดต่อกลับ | |
ตั้งค่าจุดหมายหลายแห่งสำหรับการนำทาง โดยใช้โทเค็นสำหรับเส้นทางเพื่อไปยังส่วนต่างๆ ในเส้นทางที่คำนวณไว้ล่วงหน้า
เส้นทางจะเหมือนกัน คือมีการเปลี่ยนแปลงตำแหน่งเริ่มต้นของผู้ขับและสภาพถนน/การจราจร แต่การเปลี่ยนเส้นทางจะยังเกิดขึ้นตามตัวเลือกการกำหนดเส้นทางที่เข้ารหัสในโทเค็น
รองรับเฉพาะ GMSNavigationTravelModeDriving
และ GMSNavigationTravelModeTwoWheeler
เมื่อคุณใช้โทเค็นเส้นทางเพื่อเริ่มเซสชันการนําทาง กำหนดค่าโหมดการเดินทางโดยการตั้งค่า travelMode
การโทรจะล้มเหลวหากระบบไม่รองรับรูปแบบการเดินทางปัจจุบัน และจะแสดงผล GMSRouteStatusTravelModeUnsupported
ในโค้ดเรียกกลับ
- พารามิเตอร์:
-
ปลายทาง อาร์เรย์ของจุดอ้างอิงปลายทางควรเหมือนกับปลายทางที่กําหนดให้กับ RoutesPreferred API เพื่อรับโทเค็นเส้นทาง routeToken สตริงโทเค็นเส้นทางที่แสดงผลโดย RoutesPreferred API ตัวเลือกการกำหนดเส้นทางที่ระบุใน RoutesPreferred API จะได้รับการเข้ารหัสในโทเค็นเส้นทางนี้ และระบบจะใช้เพื่อสร้างเส้นทางที่คำนวณไว้ล่วงหน้าใหม่หรือเส้นทางใหม่เมื่อมีการเปลี่ยนเส้นทาง Callback เรียกใช้เมื่อพบเส้นทางจากตำแหน่งของผู้บริโภคไปยังปลายทางที่ระบุ หรือไม่พบด้วยเหตุผลที่ระบุโดย RouteStatus
- (เป็นโมฆะ) getRouteInfoForDestination: | (GMSNavigationWaypoint *) | ปลายทาง | |
withRoutingOptions: | (GMSNavigationRoutingOptions *) | routingOptions | |
ติดต่อกลับ: | (GMSRouteInfoCallback) | ติดต่อกลับ | |
แสดงผลข้อมูลเส้นทางตามกลยุทธ์การกำหนดเส้นทาง: เส้นทางที่ดีที่สุดหรือสั้นลงตามค่าเริ่มต้น
แสดงผลค่า nil
หากโปรเจ็กต์ไม่มีสิทธิ์เรียก API นี้
- พารามิเตอร์:
-
ปลายทาง จุดอ้างอิงที่เป็นจุดหมาย routingOptions ตัวเลือกที่ใช้เพื่อดึงข้อมูลเส้นทาง ระบบจะไม่สนใจกลยุทธ์การกำหนดเส้นทางและกลยุทธ์เส้นทางอื่น เนื่องจากวิธีนี้จะแสดงข้อมูลเส้นทางสำหรับกลยุทธ์การกำหนดเส้นทางทั้งหมด Callback ระบบจะโทรกลับเมื่อได้รับข้อมูลเส้นทาง
- (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 กิโลเมตรต่อชั่วโมง