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
- Autentikasi: Token Web JSON (JWT), kunci API
- Aktifkan juga: Fleet Engine Service, Maps SDK for Android
- Memulai: Menyiapkan Consumer SDK untuk Android
- Referensi: Referensi Consumer SDK untuk Android
- Kebijakan: Kebijakan Consumer SDK for Android
- Catatan rilis: Catatan rilis Consumer SDK untuk Android
Paket Consumer SDK untuk Android resmi:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
Consumer SDK untuk Android: produk terkait
- Sering digunakan dengan: Fleet Engine Service, Driver SDK for Android, Maps SDK for Android
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-mapsyang ditentukan secara eksplisit bersamatransportation-consumerdi 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 dionDestroy()atau saat perjalanan adalahCOMPLETE. 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: PanggilConsumerApi.getInstance()terlebih dahulu dan periksaTaskyang 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=falsesaat 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
Tripdan anotasiTrip.TripStatus/Trip.TripType(danTripInfo#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. MarkerStyleOptionsdanPolylineStyleOptions: Dinonaktifkan sejak 30-11-2021. Pengganti:MarkerOptionsdanPolylineOptions(digunakan bersama Maps SDK). Gejala: Consumer SDK menerapkan gaya defaultnya sendiri per jenis penanda atau polyline, bukan defaultMarkerOptions. 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.
- Tambahkan peta interaktif yang dapat disesuaikan yang melacak progres perjalanan dari Fleet Engine ke aplikasi seluler.
- Tambahkan polyline rute yang melacak perjalanan dari Fleet Engine ke peta di halaman web atau aplikasi seluler.
- Memperbarui progres perjalanan di sepanjang rute pada peta di halaman web atau aplikasi seluler untuk perjalanan Fleet Engine.
- Mengubah gaya jalan, polyline, dan poligon pada peta yang melacak progres perjalanan dari Fleet Engine.
- Menampilkan atau menyembunyikan fitur peta pada peta yang melacak progres perjalanan dari Fleet Engine.
- Mengubah gaya ikon dan label teks pada peta yang melacak progres perjalanan dari Fleet Engine.
- Terapkan gaya peta yang berbeda ke berbagai tingkat zoom pada peta yang melacak progres perjalanan dari Fleet Engine.
- Mengubah kepadatan tempat di peta yang melacak progres perjalanan dari Fleet Engine. Eksperimental Catatan: Dukungan Gaya Visual Peta Berbasis Cloud di Consumer SDK sudah berstatus GA, sedangkan kontrol kepadatan POI adalah fitur Gaya Visual Peta Berbasis Cloud Eksperimental (hanya didukung pada gaya peta terang).
- Mengubah gaya bangunan di peta yang melacak progres perjalanan dari Fleet Engine. Eksperimental Catatan: Dukungan Gaya Visual Peta Berbasis Cloud di Consumer SDK berstatus GA, sedangkan penyesuaian gaya bangunan 3D dan jejak adalah fitur Gaya Visual Peta Berbasis Cloud Eksperimental (hanya didukung pada gaya peta terang).
- Mengubah gaya tempat terkenal di peta yang melacak progres perjalanan dari Fleet Engine. Eksperimental Catatan: Dukungan gaya visual peta berbasis cloud di Consumer SDK tersedia secara GA, sedangkan penyesuaian ikon tempat terkenal adalah fitur gaya visual peta berbasis cloud eksperimental (hanya didukung pada gaya peta terang).
- Sesuaikan penanda di peta yang melacak progres perjalanan dari Fleet Engine.
- Sesuaikan polyline rute di peta yang melacak progres perjalanan dari Fleet Engine.