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

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

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

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

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

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

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

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

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

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

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

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-driver
  • maven: com.google.android.libraries.navigation:navigation

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

  • ปัญหา: หากทรัพยากร Dependency ของบิลด์ไม่ได้ระบุเวอร์ชัน Driver SDK ไว้ IDE จะโหลดเวอร์ชันใหม่ล่าสุด โดยตั้งแต่ v7.0.0 เป็นต้นไป บิลด์ใหม่จะไม่รองรับ Android 6 และ 7 (API 23-25) อีกต่อไป วิธีแก้ไข: ระบุ Driver SDK สำหรับ Android เวอร์ชันที่ชัดเจนในทรัพยากร Dependency ของบิลด์เพื่อควบคุมเมื่อระบบปฏิบัติการขั้นต่ำที่รองรับมีการเปลี่ยนแปลง ดู /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android
  • ปัญหา: Driver SDK ต้องใช้ Navigation SDK หากไม่มีเวอร์ชัน Navigation SDK ที่ปักหมุดไว้ โปรเจ็กต์จะดาวน์โหลด Navigation SDK เวอร์ชันล่าสุดภายในเวอร์ชันหลักเสมอ วิธีแก้ไข: เพิ่มทั้งทรัพยากร Dependency ของ Driver SDK และ Navigation SDK หากคุณปักหมุด Navigation SDK ให้เลือกเวอร์ชันในช่วงที่บันทึกประจำรุ่นระบุไว้สำหรับเวอร์ชัน Driver SDK ของคุณ (เช่น [7.0, 8.0) สำหรับ Driver SDK 7.1) ดู /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project
  • ปัญหา: SDK จะขอโทเค็นการให้สิทธิ์ผ่าน AuthTokenFactory ณ เวลาที่อัปเดตตำแหน่ง หากเซิร์ฟเวอร์ของคุณไม่สามารถออก JWT ได้ การอัปเดต Fleet Engine จะไม่ได้รับสิทธิ์ วิธีแก้ไข: ตรวจสอบว่าการติดตั้งใช้งานฝั่งเซิร์ฟเวอร์สามารถออกโทเค็นได้ก่อนที่จะเริ่มต้น SDK และใช้โทเค็นซ้ำจนกว่าจะหมดอายุ ดู /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate
  • ปัญหา: บิลด์ ProGuard อาจสร้างคำเตือนสำหรับคลาส com.google, io.grpc และ okio วิธีแก้ไข: เพิ่ม -dontwarn com.google.**, -dontwarn io.grpc.** และ -dontwarn okio.** ลงในการกำหนดค่า ProGuard ดู /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies

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

  • อินเทอร์เฟซ StatusListener: เลิกใช้งานตั้งแต่วันที่ 25-11-2024 การเปลี่ยนทดแทน: DriverStatusListener Symptom: นำออกใน Driver SDK สำหรับ Android v6.0.0 ดูคำแนะนำในการย้ายข้อมูล
  • Nav/Driver SDK สำหรับ Android v1.x (ไบนารีแบบรวม): เลิกใช้งานตั้งแต่วันที่ 21-06-2022 รายการทดแทน: ไบนารี Driver SDK v3+ และ Navigation SDK แยกกัน อาการ: เลิกใช้งานเมื่อวันที่ 21-06-2021 และไม่มีการดูแลรักษาหลังจากวันที่ 21-06-2022 โดยเมธอดต่างๆ เช่น Waypoint#fromLatLng และ Navigator#startGuidance(resumeIntent) ถูกนำออกในเวอร์ชัน 3.0 ดูคำแนะนำในการย้ายข้อมูล
  • AuthTokenContext ServiceType: เลิกใช้งานตั้งแต่วันที่ 29-11-2021 การเปลี่ยนทดแทน: การอ้างสิทธิ์สำหรับรหัสยานพาหนะและรหัสงานที่รวมอยู่ อาการ: นำออกใน v4.0.0: ServiceType และ getServiceType() จาก AuthTokenContext และ setServiceType จาก AuthTokenContext.Builder ดูคำแนะนำในการย้ายข้อมูล
  • พร็อพเพอร์ตี้ Task parentId: เลิกใช้งานตั้งแต่วันที่ 28-04-2022 การเปลี่ยนทดแทน: trackingId Symptom: เปลี่ยนชื่อใน v4.1.0 พร็อพเพอร์ตี้เก่ายังคงอยู่แต่เลิกใช้งานแล้ว

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

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