Android için Sürücü SDK'sı hızlı referansı

Android için Driver SDK'sı, sürücü uygulamalarına yönelik bir mobil araç setidir. Bu araç seti, Navigasyon SDK'sından Fleet Engine'e araç konumu, rota, kalan mesafe ve TVS güncellemelerini gönderir. Hem seç-izle gezileri hem de planlanmış görevleri destekler.

Android için Sürücü SDK'sı: Önemli bilgiler

  • Ürün: Android için Sürücü SDK'sı
  • Diğer adları: Sürücü SDK'sı, seç-izle geziler için Sürücü SDK'sı, planlanmış görevler için Sürücü 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 Sürücü SDK'sına genel bakış

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

Android için Sürücü SDK'sını şu durumlarda kullanın:

  • Android sürücü uygulamanızın, Fleet Engine'e gerçek zamanlı araç konumu ve rota güncellemeleri göndermesi gerekir.
  • Navigation SDK'dan bir sonraki ara noktaya kalan mesafeyi ve TVS'yi almak için Fleet Engine'e ihtiyacınız vardır.
  • Hem atanan isteğe bağlı gezileri veya planlanmış görevleri yöneten hem de navigasyon sağlayan bir sürücü uygulamasına ihtiyacınız vardır.

Android için Sürücü SDK'sını şu durumlarda kullanmayın:

  • Uygulamanızda yalnızca adım adım rota özelliğine ihtiyacınız varsa ve Filo Motoru'nu kullanmıyorsanız. Bunun yerine Android için Navigasyon SDK'sını kullanın.
  • Konum, rota, mesafe ve TVS dışındaki araç verisi güncellemelerini göndermeniz gerekir (bunlar arka ucunuz üzerinden gönderilir). Bunun yerine Fleet Engine hizmetini kullanın.
  • iOS için sürücü uygulamasını oluşturursunuz. Bunun yerine iOS için Sürücü SDK'sı'nı kullanın.

Android için Sürücü SDK'sı: kurulum

Android paketleri için resmi Sürücü SDK'sı:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-driver
  • maven: com.google.android.libraries.navigation:navigation

Android için Sürücü SDK'sı: Sık yapılan hatalar

  • Sorun: Derleme bağımlılıkları bir Driver SDK sürümü belirtmiyorsa IDE en yeni sürümü yükler. 7.0.0 sürümünden itibaren yeni derlemeler artık Android 6 ve 7'yi (API 23-25) desteklemez. Düzeltme: Desteklenen minimum işletim sistemi değiştiğinde kontrol etmek için derleme bağımlılıklarınızda Android için Driver SDK sürümünü açıkça belirtin. /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android sayfasına bakın.
  • Sorun: Sürücü SDK'sı, Navigasyon SDK'sına bağlıdır. Sabitlenmiş bir Navigasyon SDK'sı sürümü yoksa proje her zaman ana sürümdeki en son Navigasyon SDK'sını indirir. Düzeltme: Hem Sürücü SDK'sı hem de Navigasyon SDK'sı bağımlılıklarını ekleyin. Navigasyon SDK'sını sabitlerseniz Driver SDK sürümünüz için sürüm notlarında listelenen aralıkta bir sürüm seçin (örneğin, Driver SDK 7.1 için [7.0, 8.0)). /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project adresini ziyaret edin.
  • Sorun: SDK, konum güncelleme sırasında AuthTokenFactory üzerinden yetkilendirme jetonları ister. Sunucunuz JWT yayınlayamazsa Fleet Engine güncellemeleri yetkilendirilemez. Düzeltme: Sunucu tarafı uygulamanızın, SDK'yı başlatmadan önce jeton yayınlayabildiğinden ve jetonları süreleri dolana kadar yeniden kullanabildiğinden emin olun. /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate sayfasına bakın.
  • Sorun: ProGuard derlemeleri com.google, io.grpc ve okio sınıfları için uyarılar oluşturabilir. Düzeltme: ProGuard yapılandırmanıza -dontwarn com.google.**, -dontwarn io.grpc.** ve -dontwarn okio.** ekleyin. /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies sayfasına bakın.

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

  • StatusListener arayüzü: 25.11.2024 tarihinden itibaren kullanımdan kaldırıldı. Değiştirme: DriverStatusListener. Belirti: Android için Sürücü SDK'sı 6.0.0 sürümünde kaldırıldı. Geçiş rehberini inceleyin.
  • Android için Nav/Driver SDK v1.x (birleştirilmiş ikili program): 21.06.2022'den beri kullanımdan kaldırıldı. Değişiklik: Sürücü SDK'sı 3 ve sonraki sürümler ile Navigasyon SDK'sı ikili programları ayrıdır. Belirti: 21.06.2021'de desteği sonlandırıldı ve 21.06.2022'den sonra bakımı yapılmadı; Waypoint#fromLatLng ve Navigator#startGuidance(resumeIntent) gibi yöntemler 3.0 sürümünde kaldırıldı. Geçiş rehberini inceleyin.
  • AuthTokenContext ServiceType: 29.11.2021 tarihinden itibaren kullanımdan kaldırıldı. Değiştirme: Dahil edilen araç kimliği ve görev kimliği için hak talepleri. Belirti: 4.0.0 sürümünde kaldırıldı: AuthTokenContext içinden ServiceType ve getServiceType(), AuthTokenContext.Builder içinden setServiceType. Geçiş rehberini inceleyin.
  • Task parentId özelliği: 28.04.2022 tarihinden itibaren desteği sonlandırıldı. Değiştirme: trackingId. Belirti: 4.1.0 sürümünde yeniden adlandırıldı. Eski özellik hâlâ mevcut ancak desteği sonlandırıldı.

Android için Sürücü 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.