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
- Kimlik doğrulama: JSON Web Token (JWT), API anahtarı
- Şunları da etkinleştirin: Fleet Engine hizmeti, Android için Haritalar SDK'sı
- Başlayın: Android için Tüketici SDK'sını ayarlama
- Referans: Android için Tüketici SDK'sı referansı
- Politikalar: Android için Tüketici SDK'sı politikaları
- Sürüm notları: Android için Tüketici SDK'sı sürüm notları
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ı: İlgili ürünler
- Genellikle birlikte kullanıldığı ürünler: Fleet Engine hizmeti, Android için Sürücü SDK'sı, Android için Haritalar SDK'sı
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-consumerile birlikte açıkça tanımlanmış birplay-services-mapssü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 geziCOMPLETEolduğ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: ÖnceConsumerApi.getInstance()yöntemini çağırın ve bir örneğin zaten mevcut olup olmadığını belirlemek için döndürülenTaskdeğ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=falsedeğ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.Tripsınıfı veTrip.TripStatus/Trip.TripTypeek açıklamaları (veTripInfo#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.MarkerStyleOptionsvePolylineStyleOptions: 30.11.2021 tarihinden itibaren kullanımdan kaldırıldı. Değişiklik:MarkerOptionsvePolylineOptions(Haritalar SDK'sı ile paylaşılır). Belirti: Tüketici SDK'sı,MarkerOptionsvarsayı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.
- Fleet Engine'den mobil uygulamaya bir seyahatin ilerleme durumunu izleyen özelleştirilebilir, etkileşimli bir harita ekleyin.
- Fleet Engine'den bir web sayfasındaki veya mobil uygulamadaki haritaya bir geziyi izleyen rota çoklu çizgisi ekleyin.
- Fleet Engine gezisi için bir web sayfasındaki veya mobil uygulamadaki haritada rota boyunca gezi ilerleme durumunu güncelleme
- Fleet Engine'den bir gezinin ilerleme durumunu izleyen bir haritadaki yolların, çoklu çizgilerin ve poligonların stilini değiştirme
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen bir haritada harita özelliklerini gösterme veya gizleme
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen haritadaki simgelerin ve metin etiketlerinin stilini değiştirme
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen bir haritada farklı yakınlaştırma seviyelerine farklı harita stilleri uygulayın.
- Fleet Engine'den bir gezinin ilerleme durumunu izleyen haritadaki yerlerin yoğunluğunu değiştirme Deneysel Not: Tüketici SDK'sındaki bulut tabanlı harita stilleri desteği GA'dır. ÖY yoğunluk kontrolü ise deneysel bir bulut tabanlı harita stilleri özelliğidir (yalnızca açık renkli harita stillerinde desteklenir).
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen haritadaki binaların stilini değiştirme Deneysel Not: Tüketici SDK'sındaki bulut tabanlı harita stilleri desteği genel kullanıma sunulmuştur. 3D ve bina taban alanı stil özelleştirmesi ise deneysel bir bulut tabanlı harita stilleri özelliğidir (yalnızca açık renkli harita stillerinde desteklenir).
- Fleet Engine'den bir gezinin ilerleme durumunu izleyen bir haritadaki önemli noktaların stilini değiştirme Deneysel Not: Tüketici SDK'sındaki bulut tabanlı harita stilleri desteği genel kullanıma sunulmuştur. Önemli nokta simgesi özelleştirme ise deneysel bir bulut tabanlı harita stilleri özelliğidir (yalnızca açık renkli harita stillerinde desteklenir).
- Fleet Engine'den bir seyahatin ilerleme durumunu izleyen bir haritadaki işaretçiyi özelleştirme
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen bir haritada rota çoklu çizgisini özelleştirme