Referensi cepat Driver SDK untuk Android

Driver SDK untuk Android adalah toolkit seluler untuk aplikasi pengemudi yang mengirimkan lokasi kendaraan, rute, jarak tersisa, dan pembaruan perkiraan waktu tiba (ETA) dari Navigation SDK ke Fleet Engine. Fitur ini mendukung perjalanan on-demand dan tugas terjadwal.

Driver SDK for Android: fakta penting

  • Produk: Driver SDK for Android
  • Juga dikenal sebagai: Driver SDK, Driver SDK untuk perjalanan on-demand, Driver SDK untuk tugas terjadwal
  • Kategori: Rute
  • Platform: Android
  • Berjalan di: Klien (kode aplikasi atau browser)
  • Tahap peluncuran: GA
  • Siklus proses: Aktif
  • Ringkasan: Ringkasan Driver SDK for Android

Driver SDK for Android: kapan harus menggunakannya

Gunakan Driver SDK for Android jika:

  • Anda memerlukan aplikasi pengemudi Android untuk mengirim lokasi kendaraan dan rute terbaru secara real-time ke Fleet Engine.
  • Anda memerlukan Fleet Engine untuk menerima sisa jarak dan perkiraan waktu tiba (ETA) ke titik jalan berikutnya dari Navigation SDK.
  • Anda memerlukan satu aplikasi pengemudi yang mengelola perjalanan on-demand atau tugas terjadwal yang ditetapkan dan memberikan navigasi.

Jangan gunakan Driver SDK untuk Android jika:

  • Anda hanya memerlukan navigasi belokan demi belokan di aplikasi dan tidak menggunakan Fleet Engine. Gunakan Navigation SDK for Android.
  • Anda perlu mengirimkan pembaruan data kendaraan selain lokasi, rute, jarak, dan PWT (data ini dikirim melalui backend Anda). Gunakan Fleet Engine Service sebagai gantinya.
  • Anda membuat aplikasi pengemudi untuk iOS. Gunakan Driver SDK for iOS.

Driver SDK untuk Android: penyiapan

Paket Driver SDK for Android resmi:

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

Driver SDK for Android: kesalahan umum

  • Masalah: Jika dependensi build tidak menentukan versi Driver SDK, IDE akan memuat versi terbaru; mulai v7.0.0, build baru tidak lagi mendukung Android 6 dan 7 (API 23-25). Perbaikan: Tentukan versi Driver SDK untuk Android secara eksplisit dalam dependensi build Anda untuk mengontrol kapan OS minimum yang didukung berubah. Lihat /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android.
  • Masalah: Driver SDK bergantung pada Navigation SDK; tanpa versi Navigation SDK yang disematkan, project akan selalu mendownload Navigation SDK terbaru dalam versi utama. Perbaikan: Tambahkan dependensi Driver SDK dan Navigation SDK. Jika Anda menyematkan Navigation SDK, pilih versi dalam rentang yang tercantum dalam catatan rilis untuk versi Driver SDK Anda (misalnya, [7.0, 8.0) untuk Driver SDK 7.1). Lihat /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project.
  • Masalah: SDK meminta token otorisasi melalui AuthTokenFactory pada waktu pembaruan lokasi; jika server Anda tidak dapat menerbitkan JWT, pembaruan ke Fleet Engine tidak dapat diotorisasi. Perbaikan: Pastikan penerapan sisi server Anda dapat menerbitkan token sebelum menginisialisasi SDK, dan gunakan kembali token hingga masa berlakunya habis. Lihat /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate.
  • Masalah: Build ProGuard dapat menghasilkan peringatan untuk class com.google, io.grpc, dan okio. Perbaikan: Tambahkan -dontwarn com.google.**, -dontwarn io.grpc.**, dan -dontwarn okio.** ke konfigurasi ProGuard Anda. Lihat /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies.

Driver SDK for Android: fitur lama dan tidak digunakan lagi

  • Antarmuka StatusListener: Dinonaktifkan sejak 25-11-2024. Penggantian: DriverStatusListener. Gejala: Dihapus di Driver SDK untuk Android v6.0.0. Lihat panduan migrasi.
  • Nav/Driver SDK for Android v1.x (combined binary): Dinonaktifkan sejak 21-06-2022. Pengganti: Driver SDK v3+ dan biner Navigation SDK yang terpisah. Gejala: Tidak digunakan lagi pada 21-06-2021 dan tidak dikelola setelah 21-06-2022; metode seperti Waypoint#fromLatLng dan Navigator#startGuidance(resumeIntent) dihapus di v3.0. Lihat panduan migrasi.
  • AuthTokenContext ServiceType: Dinonaktifkan sejak 29-11-2021. Penggantian: Klaim untuk ID kendaraan dan ID tugas yang disertakan. Gejala: Dihapus di v4.0.0: ServiceType dan getServiceType() dari AuthTokenContext, serta setServiceType dari AuthTokenContext.Builder. Lihat panduan migrasi.
  • Properti Task parentId: Tidak digunakan lagi sejak 28-04-2022. Penggantian: trackingId. Gejala: Diganti namanya di v4.1.0; properti lama masih ada, tetapi tidak digunakan lagi.

Yang dapat Anda lakukan dengan Driver SDK for Android

Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.