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: การตั้งค่า
- การตรวจสอบสิทธิ์: คีย์ API, JSON Web Token (JWT)
- เปิดใช้ Maps SDK สำหรับ Android ด้วย
- เริ่มต้นใช้งาน: ตั้งค่า Driver SDK สำหรับ Android
- ข้อมูลอ้างอิง: ข้อมูลอ้างอิง Driver SDK สำหรับ Android
- นโยบาย: นโยบาย Driver SDK สำหรับ Android
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ 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: ผลิตภัณฑ์ที่เกี่ยวข้อง
- มักใช้ร่วมกับ: Navigation SDK สำหรับ Android, บริการ Fleet Engine
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 การเปลี่ยนทดแทน:DriverStatusListenerSymptom: นำออกใน 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 ดูคำแนะนำในการย้ายข้อมูล AuthTokenContextServiceType: เลิกใช้งานตั้งแต่วันที่ 29-11-2021 การเปลี่ยนทดแทน: การอ้างสิทธิ์สำหรับรหัสยานพาหนะและรหัสงานที่รวมอยู่ อาการ: นำออกใน v4.0.0:ServiceTypeและgetServiceType()จากAuthTokenContextและsetServiceTypeจากAuthTokenContext.Builderดูคำแนะนำในการย้ายข้อมูล- พร็อพเพอร์ตี้
TaskparentId: เลิกใช้งานตั้งแต่วันที่ 28-04-2022 การเปลี่ยนทดแทน:trackingIdSymptom: เปลี่ยนชื่อใน v4.1.0 พร็อพเพอร์ตี้เก่ายังคงอยู่แต่เลิกใช้งานแล้ว
สิ่งที่คุณทำได้ด้วย Driver SDK สำหรับ Android
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
- รายงานตำแหน่งแบบเรียลไทม์ของยานพาหนะไปยังบริการ Fleet Engine
- รายงานพิกัดละติจูด/ลองจิจูดของจุดอ้างอิงการเดินทางของยานพาหนะจาก Navigation SDK ไปยังบริการ Fleet Engine
- รายงานระยะทางที่เหลือของยานพาหนะไปยังจุดอ้างอิงถัดไปให้กับบริการ Fleet Engine
- รายงานเวลาถึงโดยประมาณของยานพาหนะที่จุดอ้างอิงถัดไปไปยังบริการ Fleet Engine
- รายงานเส้นทางที่ Navigation SDK ระบุสำหรับยานพาหนะไปยังบริการ Fleet Engine