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