ข้อมูลอ้างอิงคลาส GMSNavigator

เพิ่ม Listener

ผู้ฟังมีการอ้างอิงที่ไม่รัดกุม

พารามิเตอร์

Listener

ออบเจ็กต์ที่สอดคล้องกับโปรโตคอล GMSNavigatorListener

นำ Listener ออก

พารามิเตอร์

Listener

ออบเจ็กต์ที่สอดคล้องกับโปรโตคอล GMSNavigatorListener

การคืนสินค้า:

ส่งคืน "ใช่" หากนำผู้ฟังออก แสดงผล NO หากออบเจ็กต์ไม่ใช่ Listener

ตั้งค่าจุดหมายหลายแห่งสำหรับการนำทาง โดยจะลบล้างปลายทางที่ตั้งค่าไว้ก่อนหน้านี้

ระบบจะเรียก Callback ที่ระบุด้วย GMSRouteStatusOK หากพบเส้นทางจากตำแหน่งของอุปกรณ์ไปยังปลายทางที่ระบุ หากมีการตั้งค่าปลายทางใหม่ก่อนที่จะพบเส้นทาง คำขอจะถูกยกเลิกและการเรียกกลับจะมีการเรียกใช้ด้วย GMSRouteStatusCanceled หากไม่พบเส้นทางด้วยเหตุผลอื่น ระบบจะเรียกใช้ Callback พร้อมสถานะข้อผิดพลาดที่เหมาะสม

ระบบจะส่ง Callback แบบไม่พร้อมกันในคิวหลักเสมอ

ตั้งค่าจุดหมายหลายแห่งสำหรับการนำทาง โดยจะลบล้างปลายทางที่ตั้งค่าไว้ก่อนหน้านี้

ระบบจะคำนวณเส้นทางที่แสดงผลโดยใช้ตัวเลือกการกำหนดเส้นทาง

พารามิเตอร์

ปลายทาง	อาร์เรย์ของจุดอ้างอิงปลายทาง
routingOptions	ตัวเลือกที่ส่งผลต่อตรรกะการกำหนดเส้นทาง (กลยุทธ์การกำหนดเส้นทาง)
Callback	เรียกใช้เมื่อพบเส้นทางจากตำแหน่งของผู้บริโภคไปยังปลายทางที่ระบุ หรือไม่พบด้วยเหตุผลที่ระบุโดย RouteStatus

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

เส้นทางจะเหมือนกัน คือเปลี่ยนโมดูโลไปยังตำแหน่งเริ่มต้นของผู้ขับ และกับสภาพถนน/การจราจร การเปลี่ยนเส้นทางจะยังคงเกิดขึ้นตามตัวเลือกการกำหนดเส้นทางที่เข้ารหัสในโทเค็น

รองรับเฉพาะ GMSNavigationTravelModeDriving และ GMSNavigationTravelModeTwoWheeler เท่านั้นเมื่อคุณใช้โทเค็นเส้นทางเพื่อเริ่มเซสชันการนำทาง กำหนดค่าโหมดการเดินทางโดยการตั้งค่าtravelMode การโทรจะล้มเหลวหากระบบไม่รองรับโหมดการเดินทางปัจจุบัน และจะแสดงผล GMSRouteStatusTravelModeUnsupported ใน Callback

พารามิเตอร์

ปลายทาง	อาร์เรย์ของจุดอ้างอิงปลายทางควรเหมือนกับปลายทางที่กำหนดให้กับ Routes Preferred API เพื่อรับโทเค็นเส้นทาง
routeToken	สตริงโทเค็นเส้นทางที่แสดงโดย Routes Preferred API ระบบจะเข้ารหัสตัวเลือกการกำหนดเส้นทางที่ระบุใน RoutesPreferences API ในโทเค็นเส้นทางนี้และจะใช้เพื่อสร้างเส้นทางที่คำนวณไว้ล่วงหน้าหรือเส้นทางใหม่เมื่อมีการเปลี่ยนเส้นทาง
Callback	มีการเรียกใช้เมื่อพบเส้นทางจากตำแหน่งของผู้บริโภคไปยังปลายทางที่ระบุ หรือไม่พบด้วยเหตุผลที่ระบุโดย RouteStatus

ส่งคืนข้อมูลเส้นทางตามกลยุทธ์การกำหนดเส้นทาง: เริ่มต้นเส้นทางที่ดีที่สุดหรือสั้นลง

วิธีการนี้ใช้ได้เฉพาะกับลูกค้า Mobility Services ที่ Google เรียกเก็บเงินจากลูกค้าเป็นรายธุรกรรมเท่านั้น แสดงผลค่า "nil" หากโปรเจ็กต์ไม่มีสิทธิ์เรียกใช้ API นี้

พารามิเตอร์

ปลายทาง	จุดอ้างอิงปลายทาง
routingOptions	ตัวเลือกที่ใช้ในการดึงข้อมูลเส้นทาง ระบบจะไม่พิจารณากลยุทธ์การกำหนดเส้นทางและกลยุทธ์เส้นทางอื่น เนื่องจากวิธีนี้จะแสดงข้อมูลเส้นทางสำหรับกลยุทธ์การกำหนดเส้นทางทั้งหมด
Callback	Callback ที่เรียกใช้เมื่อได้รับข้อมูลเส้นทาง

เลิกใช้งานแล้ว

เรียกเมธอด -setDestinations:... วิธีใดวิธีหนึ่งด้วยรายการปลายทางใหม่แทน

ใส่จุดหมายแรกจากรายการจุดหมายปัจจุบัน หลังจากการพูดคุยครั้งนี้ เราจะนำคำแนะนำไปสู่จุดหมายถัดไป (หากมี)

การคืนสินค้า:

ขณะนี้คำแนะนำเกี่ยวกับการชี้ทางกำลังมุ่งหน้าไปสู่ หรือเป็น "ค่าศูนย์" หากไม่มีจุดอ้างอิงเหลืออยู่แล้ว

หมายเหตุ

เลิกใช้งานแล้ว โปรดใช้เมธอด -setDestinations:... อย่างใดอย่างหนึ่งแทน

ล้างจุดหมายที่ตั้งไว้ก่อนหน้านี้ทั้งหมดและลบเส้นทางที่คำนวณไว้ออกจากแผนที่

หากคำแนะนำทำงานอยู่ การดำเนินการนี้จะหยุดโดยอัตโนมัติ

แสดงเวลาโดยประมาณไปยังจุดอ้างอิงที่ระบุ หรือ CLTimeIntervalMax หากจุดอ้างอิงไม่ได้เป็นส่วนหนึ่งของเส้นทางปัจจุบัน

ระบบจะอัปเดตตามตําแหน่งปัจจุบันของอุปกรณ์ในขณะที่เปิดคําแนะนําอยู่

แสดงผล CLTimeIntervalMax หากจุดอ้างอิงที่ระบุไม่ใช่ปลายทางในเส้นทางปัจจุบัน

แสดงระยะทางโดยประมาณไปยังจุดอ้างอิงที่ระบุ หรือ CLLocationDistanceMax หากจุดอ้างอิงนั้นไม่ได้เป็นส่วนหนึ่งของเส้นทางปัจจุบัน

ระบบจะอัปเดตข้อมูลนี้โดยอิงตามตำแหน่งปัจจุบันของอุปกรณ์ขณะที่คำแนะนำทำงานอยู่

แสดงผล CLLocationDistanceMax หากจุดอ้างอิงที่ระบุไม่ใช่ปลายทางในเส้นทางปัจจุบัน

ตั้งค่าและบันทึกรหัสธุรกรรมที่ใช้งานอยู่กับเหตุการณ์การนำทางในระหว่างเซสชันการนำทางปัจจุบันไปยังเซิร์ฟเวอร์

ระบบจะล้างรหัสธุรกรรมเมื่อสิ้นสุดเซสชันการนำทาง วิธีการนี้ใช้ได้เฉพาะกับลูกค้า Mobility Services ที่ Google เรียกเก็บเงินจากลูกค้าเป็นรายธุรกรรมเท่านั้น แสดงผลค่า "nil" หากโปรเจ็กต์ไม่มีสิทธิ์เรียกใช้ API นี้

พารามิเตอร์

transactionIDs	รหัสธุรกรรมที่ใช้กับเซสชันการนำทางปัจจุบัน รหัสธุรกรรมของธุรกรรมที่เรียกเก็บเงินได้แต่ละรายการต้องไม่ซ้ำกัน รหัสธุรกรรมแต่ละรายการต้องมีอักขระอย่างน้อย 1 ตัวและไม่เกิน 64 ตัว รายการอาจว่างเปล่าเมื่อธุรกรรมสิ้นสุดลง (แต่เซสชันยังคงดำเนินอยู่)
errorHandler	การบล็อกที่จะเรียกใช้แบบไม่พร้อมกันในเทรดหลักหากเกิดข้อผิดพลาดเมื่อรหัสธุรกรรมไม่ถูกต้อง

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

มีการเรียกเมื่อคำนวณข้อมูลเส้นทาง (เวลาถึงโดยประมาณและระยะทาง) ไปยังจุดอ้างอิงที่ระบุ

พารามิเตอร์

routeInfo

ข้อมูลเส้นทางไปยังจุดหมายที่ระบุ ซึ่งจะไม่เป็น ค่าศูนย์ หากคำนวณไม่สำเร็จ

เรียกใช้หากตั้งค่ารหัสธุรกรรมผ่าน setTransactionIDs ไม่สำเร็จ

โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบเกี่ยวกับ API

เลี่ยงทางหลวงเมื่อสร้างเส้นทางไปยังจุดหมายหรือไม่

ค่าเริ่มต้นคือ NO

เลี่ยงถนนที่เรียกเก็บค่าผ่านทางเมื่อสร้างเส้นทางไปยังจุดหมายหรือไม่

ค่าเริ่มต้นคือ NO

จะเลี่ยงเส้นทางเรือขณะสร้างเส้นทางไปยังจุดหมายหรือไม่

ค่าเริ่มต้นคือ YES

ตั้งค่าการจำกัดป้ายทะเบียนด้วยตัวเลขหลักสุดท้ายของป้ายทะเบียนปัจจุบันและรหัสประเทศของผู้ขับขี่

ช่วยให้เราสามารถใช้เส้นทางเลี่ยงข้อจำกัดทางถนนบางประเภทโดยอิงตามหมายเลขทะเบียนรถ วิธีนี้จะมีผลกับการเรียกใช้ setDestinations หลังจากตั้งค่านี้เท่านั้น คุณควรตั้งค่านี้ทันทีหลังจากที่ได้รับตัวนำทาง

ตั้งเป็น nil หากไม่มีข้อจำกัดด้านป้ายทะเบียน ค่าเริ่มต้นคือศูนย์

เปิดใช้คำแนะนำแบบเลี้ยวต่อเลี้ยวอยู่หรือไม่

หากคำแนะนำมีสถานะ "ใช่" แต่ขณะนี้ไม่มีเส้นทาง คำแนะนำจะเริ่มต้นเมื่อมีเส้นทาง พร็อพเพอร์ตี้นี้จะตั้งค่าเป็น NO หากมีการเรียก clearDestinations หรือเรามาถึงจุดอ้างอิง

ควรหยุดการแนะนำโดยอัตโนมัติหรือไม่เมื่อมีการเรียกใช้ -navigator:didServeAtWaypoint:

หากไม่ใช่ ส่วนหัวและส่วนท้ายของการนำทางจะยังคงแสดงอยู่หลังจากมาถึง ส่วนหัวของการนำทางจะยังคงแสดงขั้นตอนแนะนำสุดท้ายต่อไป และส่วนท้ายของการนำทางจะยังคงอัปเดตเวลาและระยะทางที่เหลือจนกว่าจะถึงเวลา/ระยะทางเป็น 0 นอกจากนั้น การอัปเดต -navigator:didUpdateRemainingTime และ -navigator:didUpdateRemainingDistance จะดำเนินการต่อด้วย ตั้งค่า guidanceActive เป็น NO อย่างชัดเจนเพื่อหยุดคำแนะนำและการอัปเดตเวลา/ระยะทางที่เหลือ

เมื่อ "ใช่" ระบบจะตั้งค่า guidanceActive เป็น NO โดยอัตโนมัติเมื่อเดินทางมาถึง

ค่าเริ่มต้นคือ YES

การเปลี่ยนแปลงขั้นต่ำของเวลาโดยประมาณไปยังจุดหมายถัดไปที่จะทำให้เกิดการเรียกเมธอด navigator:didUpdateRemainingTime:

หากตั้งค่าเป็น NSTimeIntervalMax อยู่ ระบบจะปิดใช้ Callback สำหรับการอัปเดตเวลา หากตั้งค่าเป็นลบ ระบบจะใช้เกณฑ์เริ่มต้น 1 วินาที ค่าเริ่มต้นคือ 1 วินาที

หมายเหตุ

ระบบจะละเว้นค่านี้หากไม่มี Listener ที่ใช้ navigator:didUpdateRemainingTime:

การเปลี่ยนแปลงขั้นต่ำของระยะทางโดยประมาณไปยังปลายทางถัดไปที่จะทำให้เกิดการเรียกเมธอด navigator:didUpdateRemainingDistance:

หากตั้งค่าเป็น CLLocationDistanceMax ค่า Callback การอัปเดตระยะทางจะถูกปิดใช้งาน หากตั้งค่าเป็นลบ ระบบจะใช้เกณฑ์เริ่มต้น 1 เมตร ค่าเริ่มต้นคือ 1 เมตร

หมายเหตุ

ระบบจะละเว้นค่านี้หากไม่มี Listener ที่ใช้ navigator:didUpdateRemainingDistance:

ส่งคืนเวลาโดยประมาณไปยังปลายทางถัดไป

ระบบจะอัปเดตข้อมูลนี้โดยอิงตามตำแหน่งปัจจุบันของอุปกรณ์ขณะที่คำแนะนำทำงานอยู่

แสดงผล CLTimeIntervalMax หากไม่มีเส้นทางที่ใช้ได้

ส่งคืนระยะทางโดยประมาณไปยังจุดหมายถัดไป

ระบบจะอัปเดตข้อมูลนี้โดยอิงตามตำแหน่งปัจจุบันของอุปกรณ์ขณะที่คำแนะนำทำงานอยู่

แสดงผล CLLocationDistanceMax หากไม่มีเส้นทาง

แสดงผลหมวดหมู่การหน่วงเวลาไปยังปลายทางถัดไป

ระบบจะอัปเดตข้อมูลนี้โดยอิงตามตำแหน่งปัจจุบันของอุปกรณ์ขณะที่คำแนะนำทำงานอยู่

แสดงผล GMSnavigationDelayCategoryNoData หากไม่มีเส้นทางหรือไม่มีข้อมูลการจราจร

การเดินทางในปัจจุบัน

GMSRouteLeg นี้จะมีตำแหน่งเริ่มต้นเป็นตำแหน่งล่าสุดที่ทราบ (ลากเส้นทาง) ของอุปกรณ์

อาร์เรย์ของเส้นทางต่างๆ โดยที่แต่ละขาเชื่อมกับจุดหมายที่ตั้งไว้

เส้นทางที่ผู้ใช้ใช้ในเซสชันการแนะนำล่าสุด ซึ่งระบุเป็นครั้งสุดท้ายที่ Guide ใช้งานอยู่ถูกตั้งค่าเป็น "ใช่"

เส้นทางนี้ประกอบด้วยตำแหน่งที่มีการกั้นถนนซึ่งส่งคืนโดย GMSRoadSnappedLocationProvider และทำให้การสร้างส่วนของเส้นถนนง่ายขึ้น

หมายเหตุ

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

กำหนดว่าควรเปิดใช้การนำทางด้วยเสียงสำหรับการจราจรและการแจ้งเตือนแบบเลี้ยวต่อเลี้ยวหรือไม่

ค่าเริ่มต้นจะเป็น GMSnavigationVoiceGuidanceAlertsAndGuidance

กำหนดว่าสามารถเล่นการนำทางด้วยเสียงของอุปกรณ์เสียงประเภทใดได้บ้าง

ค่าเริ่มต้นคือ GMSVoiceGuidanceAudioDeviceTypeBluetooth

กำหนดว่าอุปกรณ์ควรสั่นด้วยเมื่อมีการเล่นการแจ้งเตือนด้วยเสียงหรือไม่

กำหนดว่าจะแสดง UILocalNotifications ที่มีข้อมูลคำแนะนำหรือไม่เมื่อแอปอยู่ในเบื้องหลัง

ค่าเริ่มต้นคือ YES

โหมดแสงที่แนะนำ โดยอิงตามช่วงเวลาของวันและตำแหน่งของอุปกรณ์

กำหนดว่าจะแสดงข้อความแจ้งสำหรับการจราจร เส้นทางและเหตุการณ์ที่ดีขึ้นหรือไม่

ค่าเริ่มต้นคือ YES

GMSNavigationSpeedAlertOptions สำหรับการปรับแต่งเกณฑ์การเรียกใช้สำหรับ GMSnavigationSpeedAlertSeverity

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

เมื่อตั้งค่าเป็น nil คุณจะไม่ได้รับข้อมูลฟีดที่เร่งความเร็วใดๆ และการแจ้งเตือนความเร็วเริ่มต้นของ NavSDK จะแสดงขึ้น โดยการแจ้งเตือนความเร็วจะแสดงข้อความสีแดงเมื่อความเร็วสูงกว่า 5 ไมล์ต่อชั่วโมงหรือ 10 กิโลเมตรต่อชั่วโมง และจะแสดงข้อความสีขาวและพื้นหลังสีแดงเมื่อเร่งความเร็วมากกว่า 10 ไมล์ต่อชั่วโมงหรือ 20 กิโลเมตรต่อชั่วโมง