Referensi cepat Consumer SDK untuk Android

Consumer SDK untuk Android adalah bagian dari Fleet Engine untuk perjalanan on-demand. Library ini menyediakan antarmuka yang memodelkan data perjalanan dan mengikuti perjalanan di Fleet Engine, serta class untuk membuat tampilan berbasis peta yang membagikan progres perjalanan (lokasi kendaraan, rute, perkiraan waktu tiba, jarak tersisa, lalu lintas) kepada konsumen di aplikasi Android.

Consumer SDK untuk Android: fakta penting

  • Produk: Consumer SDK for Android
  • Juga dikenal sebagai: Android Consumer SDK, Consumer SDK, Mobility Services On-demand Trips Android Consumer SDK
  • Kategori: Rute
  • Platform: Android
  • Berjalan di: Klien (kode aplikasi atau browser)
  • Tahap peluncuran: GA
  • Siklus proses: Aktif
  • Ringkasan: Ringkasan Consumer SDK untuk Android

Consumer SDK untuk Android: kapan harus menggunakannya

Gunakan Consumer SDK untuk Android jika:

  • Anda memerlukan konsumen di aplikasi Android untuk mengikuti perjalanan on demand (perjalanan, pesanan, atau pengiriman) yang dilacak backend Anda di Fleet Engine.
  • Anda perlu menampilkan lokasi dan rute kendaraan yang hampir real-time dan disesuaikan dengan jalan di peta dalam aplikasi pelanggan Android.
  • Anda perlu menampilkan perkiraan waktu tiba (ETA) penjemputan dan penurunan, jarak yang tersisa, dan lalu lintas langsung untuk perjalanan Fleet Engine di Android.
  • Anda perlu menyesuaikan penanda perjalanan, polyline rute, atau gaya visual peta untuk peta berbagi perjalanan di Android.

Jangan gunakan Consumer SDK untuk Android jika:

  • Anda memerlukan fitur berbagi perjalanan untuk perjalanan on-demand di aplikasi iOS. Gunakan Consumer SDK untuk iOS.
  • Anda memerlukan fitur berbagi perjalanan di halaman web, atau pelacakan tugas terjadwal seperti pengiriman oleh konsumen. Sebagai gantinya, gunakan JavaScript Consumer SDK.
  • Anda perlu melaporkan lokasi pengemudi dan progres perjalanan dari aplikasi Android pengemudi. Gunakan Driver SDK for Android.

Consumer SDK untuk Android: penyiapan

Paket Consumer SDK untuk Android resmi:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

Consumer SDK untuk Android: kesalahan umum

  • Masalah: Jika dependensi Maps SDK tidak ditetapkan ke versi eksplisit, Consumer SDK akan menggunakan versi Maps SDK minimum yang diperlukan, yang dapat merusak aplikasi yang mengandalkan fitur di versi Maps SDK yang lebih baru. Perbaikan: Deklarasikan versi play-services-maps yang ditentukan secara eksplisit bersama transportation-consumer di Gradle atau Maven. Lihat /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project.
  • Masalah: Tidak menghentikan berbagi perjalanan setelah perjalanan berakhir akan menyebabkan permintaan jaringan yang tidak perlu ke Fleet Engine dan kebocoran memori. Perbaikan: Panggil JourneySharingSession.stop() saat perjalanan tidak lagi diperlukan, misalnya di onDestroy() atau saat perjalanan adalah COMPLETE. Lihat /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey.
  • Masalah: ConsumerApi.initialize() menampilkan pengecualian jika instance API sudah ada (2.0.0 dan yang lebih baru). Perbaikan: Panggil ConsumerApi.getInstance() terlebih dahulu dan periksa Task yang ditampilkan untuk menentukan apakah instance sudah ada. Lihat /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android.
  • Masalah: Consumer SDK v3 dan yang lebih lama tidak mendukung mode Full R8; aplikasi yang menargetkan AGP 8.0+ dapat mengalami masalah build atau runtime. Perbaikan: Tetapkan android.enableR8.fullMode=false saat menargetkan AGP 8.0+, dan gunakan AGP 7.3+ dengan Kotlin 2.0 untuk Consumer SDK 3.0+. Lihat /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3.

Consumer SDK untuk Android: fitur lama dan tidak digunakan lagi

  • ConsumerTrip, ConsumerTripCallback, ConsumerTripManager, ConsumerTripOptions: Dinonaktifkan sejak 15-09-2023. Penggantian: TripModel, TripModelCallback, TripModelManager, TripModelOptions. Lihat panduan migrasi.
  • Class Trip dan anotasi Trip.TripStatus / Trip.TripType (dan TripInfo#getTripStatus(), TripInfo#getTripType(), TripModelCallback#onTripStatusUpdated): Tidak digunakan lagi sejak 15-09-2023. Penggantian: TripInfo.TripStatus / TripInfo.TripType, TripInfo#getCurrentTripStatus(), TripInfo#getCurrentTripType(), TripModelCallback#onTripStatusUpdate. Lihat panduan migrasi.
  • MarkerStyleOptions dan PolylineStyleOptions: Dinonaktifkan sejak 30-11-2021. Pengganti: MarkerOptions dan PolylineOptions (digunakan bersama Maps SDK). Gejala: Consumer SDK menerapkan gaya defaultnya sendiri per jenis penanda atau polyline, bukan default MarkerOptions. Lihat panduan migrasi.
  • Saluran distribusi repositori pribadi: Tidak digunakan lagi. Pengganti: Repositori Maven Google (versi 2.1.0 dan yang lebih baru). Lihat panduan migrasi.

Yang dapat Anda lakukan dengan Consumer SDK untuk Android

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