Guide de référence rapide du SDK Driver pour Android

Le SDK Driver pour Android est un kit d'outils mobile pour les applications de conducteur qui envoie la position du véhicule, l'itinéraire, la distance restante et les mises à jour de l'heure d'arrivée prévue du SDK Navigation à Fleet Engine. Il est compatible avec les trajets à la demande et les tâches planifiées.

SDK Driver pour Android : informations clés

  • Produit : SDK Driver pour Android
  • Également appelé : SDK Driver, SDK Driver pour les trajets à la demande, SDK Driver pour les tâches planifiées
  • Catégorie : Routes
  • Plate-forme : Android
  • Exécution sur : client (code de l'application ou du navigateur)
  • Étape de lancement : GA
  • Cycle de vie : Actif
  • Présentation : Présentation du SDK Driver pour Android

SDK Driver pour Android : quand l'utiliser

Utilisez le SDK Driver pour Android dans les cas suivants :

  • Vous avez besoin de votre application de chauffeur Android pour envoyer à Fleet Engine des informations en temps réel sur la position du véhicule et l'itinéraire.
  • Vous avez besoin de Fleet Engine pour recevoir la distance restante et l'heure d'arrivée prévue au prochain point de cheminement à partir du SDK Navigation.
  • Vous avez besoin d'une application de chauffeur qui gère à la fois les trajets à la demande ou les tâches planifiées attribués, et qui fournit des instructions de navigation.

N'utilisez pas le SDK Driver pour Android dans les cas suivants :

  • Vous n'avez besoin que de la navigation détaillée dans votre application et vous n'utilisez pas Fleet Engine. Utilisez plutôt le SDK Navigation pour Android.
  • Vous devez envoyer des mises à jour des données du véhicule autres que la position, l'itinéraire, la distance et l'heure d'arrivée prévue (qui passent par votre backend). Utilisez plutôt le service Fleet Engine.
  • Vous créez l'application de chauffeur pour iOS. Utilisez plutôt le SDK Driver pour iOS.

SDK Driver pour Android : configuration

Packages officiels du SDK Driver pour Android :

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

SDK Driver pour Android : erreurs courantes

  • Problème : si les dépendances de compilation ne spécifient pas de version du SDK Driver, l'IDE charge la version la plus récente. À partir de la version 7.0.0, les nouvelles compilations ne sont plus compatibles avec Android 6 et 7 (API 23-25). Correction : Spécifiez une version explicite du SDK Driver pour Android dans vos dépendances de compilation pour contrôler le moment où l'OS minimal compatible change. Consultez /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android.
  • Problème : le SDK Driver dépend du SDK Navigation. Sans version épinglée du SDK Navigation, le projet télécharge toujours la dernière version majeure du SDK Navigation. Correction : Ajoutez les dépendances du SDK Driver et du SDK Navigation. Si vous épinglez le SDK Navigation, choisissez une version dans la plage indiquée dans les notes de version pour votre version du SDK Driver (par exemple, [7.0, 8.0) pour le SDK Driver 7.1). Consultez /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project.
  • Problème : le SDK demande des jetons d'autorisation via AuthTokenFactory au moment de la notification de position. Si votre serveur ne peut pas émettre de jetons JWT, les mises à jour de Fleet Engine ne peuvent pas être autorisées. Solution : Assurez-vous que votre implémentation côté serveur peut émettre des jetons avant d'initialiser le SDK, et réutilisez les jetons jusqu'à leur expiration. Consultez /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate.
  • Problème : Les builds ProGuard peuvent générer des avertissements pour les classes com.google, io.grpc et okio. Correction : Ajoutez -dontwarn com.google.**, -dontwarn io.grpc.** et -dontwarn okio.** à votre configuration ProGuard. Consultez /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies.

SDK Driver pour Android : fonctionnalités anciennes et obsolètes

  • Interface StatusListener : obsolète depuis le 25/11/2024. Remplacement : DriverStatusListener. Symptôme : supprimé dans le SDK Driver pour Android v6.0.0. Consultez le guide de migration.
  • SDK Navigation/Pilote pour Android v1.x (binaire combiné) : mis hors service depuis le 21/06/2022. Remplacement : binaires distincts pour le SDK Driver v3+ et le SDK Navigation. Symptôme : Obsolète depuis le 21/06/2021 et non géré après le 21/06/2022 ; méthodes telles que Waypoint#fromLatLng et Navigator#startGuidance(resumeIntent) supprimées dans la v3.0. Consultez le guide de migration.
  • AuthTokenContext ServiceType : Obsolète depuis le 29/11/2021. Remplacement : revendications pour l'ID de véhicule et l'ID de tâche inclus. Symptôme : Suppression dans la v4.0.0 : ServiceType et getServiceType() de AuthTokenContext, et setServiceType de AuthTokenContext.Builder. Consultez le guide de migration.
  • Propriété Task parentId : obsolète depuis le 28/04/2022. Remplacement : trackingId. Symptôme : renommé dans la version 4.1.0 ; l'ancienne propriété existe toujours, mais elle est obsolète.

Ce que vous pouvez faire avec le SDK Driver pour Android

Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.