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: การตั้งค่า
- การตรวจสอบสิทธิ์: คีย์ API, JSON Web Token (JWT)
- เปิดใช้ Maps SDK สำหรับ iOS ด้วย
- เริ่มต้นใช้งาน: ตั้งค่า Driver SDK สำหรับ iOS
- ข้อมูลอ้างอิง: ข้อมูลอ้างอิง Driver SDK สำหรับ iOS
- นโยบาย: นโยบาย Driver SDK สำหรับ iOS
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ Driver SDK สำหรับ iOS
แพ็กเกจ Driver SDK สำหรับ iOS อย่างเป็นทางการ
- cocoapods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
Driver SDK สำหรับ iOS: ผลิตภัณฑ์ที่เกี่ยวข้อง
- มักใช้ร่วมกับ: Navigation SDK สำหรับ iOS, บริการ Fleet Engine, Consumer SDK สำหรับ iOS
Driver SDK สำหรับ iOS: ข้อผิดพลาดที่พบบ่อย
- ปัญหา: การอัปเดตยานพาหนะครั้งแรกหลังจากเริ่มต้นระบบอาจไม่สำเร็จโดยมีข้อความ "update_mask cannot be empty" เมื่อพารามิเตอร์
updateMaskว่างเปล่า วิธีแก้ไข: ระบุชื่อฟิลด์อย่างน้อย 1 ชื่อในupdateMaskเสมอ และจัดการข้อผิดพลาดนี้ในGMTDVehicleReporterListenerdidFailVehicleUpdateดู /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 การแทนที่:GMTDAuthorizationfetchTokenWithContext:completion:ด้วยGMTDAuthorizationContext(การอ้างสิทธิ์สำหรับรหัสยานพาหนะเท่านั้น) ดูคำแนะนำในการย้ายข้อมูล
สิ่งที่คุณทำได้ด้วย Driver SDK สำหรับ iOS
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
- รายงานตำแหน่งแบบเรียลไทม์ของยานพาหนะไปยังบริการ Fleet Engine
- รายงานพิกัดละติจูด/ลองจิจูดของจุดอ้างอิงการเดินทางของยานพาหนะจาก Navigation SDK ไปยังบริการ Fleet Engine
- รายงานระยะทางที่เหลือของยานพาหนะไปยังจุดอ้างอิงถัดไปให้กับบริการ Fleet Engine
- รายงานเวลาถึงโดยประมาณของยานพาหนะที่จุดอ้างอิงถัดไปไปยังบริการ Fleet Engine
- รายงานเส้นทางที่ Navigation SDK ระบุสำหรับยานพาหนะไปยังบริการ Fleet Engine