ข้อมูลอ้างอิงฉบับย่อเกี่ยวกับ Driver SDK สำหรับ iOS

Driver SDK สำหรับ iOS เป็นชุดเครื่องมือแอปบนมือถือและคอมโพเนนต์ของ Fleet Engine โดยจะส่งตำแหน่งยานพาหนะ เส้นทาง จุดอ้างอิง ระยะทางที่เหลือ และ ETA ของแอปคนขับจาก Navigation SDK ไปยัง Fleet Engine สำหรับการเดินทางแบบออนดีมานด์และงานที่กำหนดเวลาไว้

Driver SDK สำหรับ iOS: ข้อมูลสำคัญ

  • ผลิตภัณฑ์: Driver SDK สำหรับ iOS
  • หรือที่เรียกว่า Driver SDK, Driver SDK สำหรับการเดินทางแบบออนดีมานด์, Driver SDK สำหรับงานที่กำหนดเวลาไว้
  • หมวดหมู่: เส้นทาง
  • แพลตฟอร์ม: iOS
  • ทำงานใน: ไคลเอ็นต์ (โค้ดแอปหรือเบราว์เซอร์)
  • ระยะการเปิดตัว: GA
  • วงจร: ใช้งานอยู่
  • ภาพรวม: ภาพรวม Driver SDK สำหรับ iOS

Driver SDK สำหรับ iOS: กรณีที่ควรใช้

ใช้ Driver SDK สำหรับ iOS ในกรณีต่อไปนี้

  • คุณต้องมีแอปคนขับบน iOS เพื่อส่งการอัปเดตตำแหน่งยานพาหนะแบบเรียลไทม์ไปยัง Fleet Engine
  • คุณต้องรายงานเส้นทาง จุดอ้างอิง ระยะทางที่เหลือ และ ETA จาก Navigation SDK ไปยัง Fleet Engine
  • คุณต้องการให้คนขับจัดการการเดินทางแบบออนดีมานด์ที่ได้รับมอบหมายและนำทางในแอปเดียวโดยไม่ต้องสลับแอป
  • คุณกำลังสร้างแอปคนขับสำหรับงานที่กำหนดเวลาไว้ของ Fleet Engine บน iOS

อย่าใช้ Driver SDK สำหรับ iOS ในกรณีต่อไปนี้

  • คุณต้องการเพียงการนำทางแบบเลี้ยวต่อเลี้ยวในแอป iOS โดยไม่ต้องติดตาม Fleet Engine โปรดใช้ Navigation SDK สำหรับ iOS แทน
  • คุณต้องแสดงความคืบหน้าของการเดินทางหรือการจัดส่งให้ผู้โดยสารหรือลูกค้าเห็นในแอปผู้บริโภค ให้ใช้ Consumer SDK สำหรับ iOS แทน
  • คุณต้องส่งข้อมูลอัปเดตเกี่ยวกับยานพาหนะนอกเหนือจากตำแหน่งและเส้นทาง โดยข้อมูลเหล่านี้จะส่งผ่านแบ็กเอนด์ไปยัง Fleet Engine โปรดใช้บริการ Fleet Engine แทน
  • แอปคนขับของคุณทำงานบน Android โปรดใช้ Driver SDK สำหรับ Android แทน

Driver SDK สำหรับ iOS: การตั้งค่า

แพ็กเกจ Driver SDK สำหรับ iOS อย่างเป็นทางการ

  • cocoapods: GoogleRidesharingDriver
  • swift_package: https://github.com/googlemaps/ios-driver-sdk

Driver SDK สำหรับ iOS: ข้อผิดพลาดที่พบบ่อย

  • ปัญหา: การอัปเดตยานพาหนะครั้งแรกหลังจากเริ่มต้นระบบอาจไม่สำเร็จโดยมีข้อความ "update_mask cannot be empty" เมื่อพารามิเตอร์ updateMask ว่างเปล่า วิธีแก้ไข: ระบุชื่อฟิลด์อย่างน้อย 1 ชื่อใน updateMask เสมอ และจัดการข้อผิดพลาดนี้ใน GMTDVehicleReporterListener didFailVehicleUpdate ดู /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot
  • ปัญหา: GMSRoadSnappedLocationProvider ไม่ส่งการอัปเดตตำแหน่งอย่างต่อเนื่องเมื่ออุปกรณ์ไม่มีการเคลื่อนไหวตั้งแต่การอัปเดตครั้งล่าสุด เช่น เมื่อคนขับรถจอดรอ วิธีแก้ไข: หากต้องการส่งการอัปเดตตำแหน่งใหม่ขณะที่อุปกรณ์อยู่กับที่ ให้หยุดแล้วเริ่ม GMSRoadSnappedLocationProvider (โดยเพิ่ม GMTDVehicleReporter เป็น Listener แล้ว) ดู /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready
  • ปัญหา: แอปผู้บริโภคแสดงผลการเดินทางไม่ถูกต้องหากพิกัดที่ส่งไปยัง setDestinations() ไม่ตรงกับจุดอ้างอิงของการเดินทาง วิธีแก้ไข: ตรวจสอบว่าละติจูด/ลองจิจูดที่ส่งไปยัง setDestinations() ตรงกับพิกัดจุดอ้างอิงของการเดินทางใน Fleet Engine ดู /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details
  • ปัญหา: การใช้โอเปอเรเตอร์เวอร์ชันที่มองโลกในแง่ดี (~>) อาจทำให้เกิดบิลด์ที่คาดเดาไม่ได้และทำซ้ำไม่ได้ และการละเว้นเวอร์ชันจะโหลด SDK ใหม่ล่าสุด ซึ่งอาจรวมถึงการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบหรือเพิ่มเวอร์ชัน iOS ขั้นต่ำ ไม่รองรับ Carthage วิธีแก้ไข: ปักหมุด Driver SDK เวอร์ชันที่แน่นอนใน CocoaPods หรือ Swift Package Manager และตรวจสอบบันทึกประจำรุ่นก่อนอัปเกรด ดู /maps/documentation/mobility/driver-sdk/on-demand/ios/versions

Driver SDK สำหรับ iOS: ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว

  • คลาส GMTSVehicleMatch: เลิกใช้งานแล้ว การแทนที่: ไม่จำเป็นต้องแทนที่ใน Driver SDK (การจับคู่ยานพาหนะจะดำเนินการใน Fleet Engine) อาการ: เลิกใช้งานใน Driver SDK สำหรับ iOS v2.2.0 และละเว้นจากข้อมูลอ้างอิง Driver SDK ปัจจุบัน ดูคำแนะนำในการย้ายข้อมูล
  • GMTSServiceType และ fetchAuthTokenForServiceType:authorizationContext:completion:: เลิกใช้งานตั้งแต่วันที่ 29-11-2021 การแทนที่: GMTDAuthorization fetchTokenWithContext:completion: ด้วย GMTDAuthorizationContext (การอ้างสิทธิ์สำหรับรหัสยานพาหนะเท่านั้น) ดูคำแนะนำในการย้ายข้อมูล

สิ่งที่คุณทำได้ด้วย Driver SDK สำหรับ iOS

ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ