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
- Kimlik doğrulama: API anahtarı, JSON Web Jetonu (JWT)
- Ayrıca şunu da etkinleştirin: Android için Haritalar SDK'sı
- Başlayın: Android için Sürücü SDK'sını ayarlama
- Referans: Android için Sürücü SDK'sı referansı
- Politikalar: Android için Sürücü SDK'sı politikaları
- Sürüm notları: Android için Sürücü SDK'sı sürüm notları
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ı: İlgili ürünler
- Genellikle birlikte kullanıldığı ürünler: Android için Navigasyon SDK'sı, Fleet Engine hizmeti
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.grpcveokiosı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
StatusListenerarayü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#fromLatLngveNavigator#startGuidance(resumeIntent)gibi yöntemler 3.0 sürümünde kaldırıldı. Geçiş rehberini inceleyin. AuthTokenContextServiceType: 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ı:AuthTokenContextiçindenServiceTypevegetServiceType(),AuthTokenContext.BuilderiçindensetServiceType. Geçiş rehberini inceleyin.TaskparentIdö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.
- Bir aracın anlık konumunu Fleet Engine hizmetine bildirme
- Navigation SDK'dan Fleet Engine hizmetine bir aracın gezi noktalarının enlem/boylam koordinatlarını bildirin.
- Bir aracın bir sonraki ara noktaya kalan mesafesini Fleet Engine hizmetine bildirin.
- Bir aracın bir sonraki ara noktaya tahmini varış zamanını Fleet Engine hizmetine bildirin.
- Navigation SDK tarafından bir araç için sağlanan rotayı Fleet Engine hizmetine bildirme