Android için Tüketici SDK'sı hızlı referansı

Android için Tüketici SDK'sı, isteğe bağlı geziler için Fleet Engine'ın bir parçasıdır. Fleet Engine'da gezi verilerini modelleyen ve gezileri takip eden arayüzler sağlar. Ayrıca, bir gezinin ilerleme durumunu (araç konumu, rota, TVS, kalan mesafe, trafik) bir Android uygulamasında tüketicilerle paylaşan harita tabanlı bir ekran oluşturmak için sınıflar sunar.

Android için Tüketici SDK'sı: Önemli bilgiler

  • Ürün: Android için Tüketici SDK'sı
  • Diğer adları: Android Tüketici SDK'sı, Tüketici SDK'sı, Mobilite Hizmetleri İstek Üzerine Geziler Android Tüketici SDK'sı
  • Kategori: Rotalar
  • Platform: Android
  • Çalıştığı yer: İstemci (uygulama veya tarayıcı kodu)
  • Lansman aşaması: GA
  • Yaşam döngüsü: Etkin
  • Genel bakış: Android için Tüketici SDK'sına genel bakış

Android için Tüketici SDK'sı: Ne zaman kullanılır?

Android için Tüketici SDK'sını şu durumlarda kullanın:

  • Android uygulamanızdaki tüketicilerin, arka ucunuzun Filo Altyapısı'nda takip ettiği isteğe bağlı bir geziyi (yolculuk, sipariş veya teslimat) takip etmesi gerekir.
  • Bir Android tüketici uygulamasında, aracın yola sabitlenmiş konumunu ve rotasını harita üzerinde neredeyse anlık olarak göstermeniz gerekiyor.
  • Android'de bir Fleet Engine gezisi için teslim alma ve bırakma TVS'sini, kalan mesafeyi ve canlı trafiği göstermeniz gerekir.
  • Android'de yolculuk paylaşımı haritası için gezi işaretçilerini, rota çoklu çizgilerini veya harita stilini özelleştirmeniz gerekiyor.

Android için Tüketici SDK'sını şu durumlarda kullanmayın:

  • iOS uygulamasında isteğe bağlı geziler için yolculuk paylaşımına ihtiyacınız vardır. Bunun yerine iOS için Tüketici SDK'sını kullanın.
  • Bir web sayfasında yolculuk paylaşımına veya gönderiler gibi planlanmış görevlerin tüketici tarafından izlenmesine ihtiyacınız varsa Bunun yerine JavaScript Tüketici SDK'sını kullanın.
  • Sürücü konumunu ve gezi ilerleme durumunu sürücünün Android uygulamasından bildirmeniz gerekir. Bunun yerine Android için Sürücü SDK'sı kullanın.

Android için Tüketici SDK'sı: kurulum

Android için resmi Tüketici SDK'sı paketleri:

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

Android için Tüketici SDK'sı: Sık yapılan hatalar

  • Sorun: Maps SDK bağımlılığı açık bir sürüme ayarlanmazsa Tüketici SDK'sı, gerekli minimum Maps SDK sürümünü kullanır. Bu durum, sonraki Maps SDK sürümlerindeki özelliklere dayalı uygulamaları bozabilir. Düzeltme: Gradle veya Maven'da transportation-consumer ile birlikte açıkça tanımlanmış bir play-services-maps sürümü bildirin. /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project adresini ziyaret edin.
  • Sorun: Yolculuk sona erdikten sonra yolculuk paylaşımının durdurulmaması, Fleet Engine'e gereksiz ağ istekleri gönderilmesine ve bellek sızıntılarına neden olur. Düzeltme: Geziye artık ihtiyaç duyulmadığında (ör. onDestroy() veya gezi COMPLETE olduğunda) JourneySharingSession.stop() yöntemini çağırın. /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey sayfasına bakın.
  • Sorun: ConsumerApi.initialize(), bir API örneği zaten mevcutsa istisna oluşturur (2.0.0 ve sonraki sürümler). Düzeltme: Önce ConsumerApi.getInstance() yöntemini çağırın ve bir örneğin zaten mevcut olup olmadığını belirlemek için döndürülen Task değerini kontrol edin. /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android adresini ziyaret edin.
  • Sorun: Tüketici SDK'sı 3 ve önceki sürümler tam R8 modunu desteklemez. AGP 8.0 ve sonraki sürümleri hedefleyen uygulamalarda derleme veya çalışma zamanı sorunları yaşanabilir. Düzeltme: AGP 8.0 ve sonraki sürümleri hedeflerken android.enableR8.fullMode=false değerini ayarlayın ve Seç-İzle Consumer SDK 3.0 ve sonraki sürümler için Kotlin 2.0 ile AGP 7.3 ve sonraki sürümleri kullanın. /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3 adresini inceleyin.

Android için Tüketici SDK'sı: eski ve desteği sonlandırılmış özellikler

  • ConsumerTrip, ConsumerTripCallback, ConsumerTripManager, ConsumerTripOptions: 15.09.2023 tarihinden itibaren kullanımdan kaldırıldı. Değiştirme: TripModel, TripModelCallback, TripModelManager, TripModelOptions. Geçiş rehberini inceleyin.
  • Trip sınıfı ve Trip.TripStatus / Trip.TripType ek açıklamaları (ve TripInfo#getTripStatus(), TripInfo#getTripType(), TripModelCallback#onTripStatusUpdated): 15.09.2023 tarihinden itibaren desteği sonlandırıldı. Değişim: TripInfo.TripStatus / TripInfo.TripType, TripInfo#getCurrentTripStatus(), TripInfo#getCurrentTripType(), TripModelCallback#onTripStatusUpdate. Geçiş rehberini inceleyin.
  • MarkerStyleOptions ve PolylineStyleOptions: 30.11.2021 tarihinden itibaren kullanımdan kaldırıldı. Değişiklik: MarkerOptions ve PolylineOptions (Haritalar SDK'sı ile paylaşılır). Belirti: Tüketici SDK'sı, MarkerOptions varsayılanlarını değil, her işaretçi veya çoklu çizgi türü için kendi varsayılan stilini uygular. Geçiş rehberini inceleyin.
  • Özel depo dağıtım kanalı: Desteği sonlandırıldı. Değişiklik: Google Maven deposu (2.1.0 ve sonraki sürümler). Geçiş rehberini inceleyin.

Android için Tüketici SDK'sı ile yapabilecekleriniz

Her görev için aşağıda bağlantısı verilen kılavuzlara bakın veya Özellikler Gezgini'nde ürünleri karşılaştırın.