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
- Autentikasi: Kunci API, Token Web JSON (JWT)
- Aktifkan juga: Maps SDK for Android
- Memulai: Menyiapkan Driver SDK untuk Android
- Referensi: Referensi Driver SDK for Android
- Kebijakan: Kebijakan Driver SDK for Android
- Catatan rilis: Catatan rilis Driver SDK untuk Android
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: produk terkait
- Sering digunakan dengan: Navigation SDK for Android, Fleet Engine Service
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
AuthTokenFactorypada 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, danokio. 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#fromLatLngdanNavigator#startGuidance(resumeIntent)dihapus di v3.0. Lihat panduan migrasi. AuthTokenContextServiceType: Dinonaktifkan sejak 29-11-2021. Penggantian: Klaim untuk ID kendaraan dan ID tugas yang disertakan. Gejala: Dihapus di v4.0.0:ServiceTypedangetServiceType()dariAuthTokenContext, sertasetServiceTypedariAuthTokenContext.Builder. Lihat panduan migrasi.- Properti
TaskparentId: 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.
- Melaporkan posisi real-time kendaraan ke layanan Fleet Engine.
- Laporkan koordinat lintang/bujur titik jalan perjalanan kendaraan dari Navigation SDK ke layanan Fleet Engine.
- Laporkan sisa jarak kendaraan ke titik jalan berikutnya ke layanan Fleet Engine.
- Laporkan perkiraan waktu tiba kendaraan di titik jalan berikutnya ke layanan Fleet Engine.
- Melaporkan rute yang disediakan untuk kendaraan oleh Navigation SDK ke layanan Fleet Engine.