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
- Authentification : clé API, jeton Web JSON (JWT)
- Activez également : SDK Maps pour Android
- Premiers pas : Configurer le SDK Driver pour Android
- Référence : Documentation de référence du SDK Driver pour Android
- Règles : Règles du SDK Driver pour Android
- Notes de version : Notes de version du SDK Driver pour Android
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 : produits associés
- Souvent utilisé avec : le SDK Navigation pour Android, le service Fleet Engine
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
AuthTokenFactoryau 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.grpcetokio. 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#fromLatLngetNavigator#startGuidance(resumeIntent)supprimées dans la v3.0. Consultez le guide de migration. AuthTokenContextServiceType: 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 :ServiceTypeetgetServiceType()deAuthTokenContext, etsetServiceTypedeAuthTokenContext.Builder. Consultez le guide de migration.- Propriété
TaskparentId: 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.
- Signalez la position en temps réel d'un véhicule au service Fleet Engine.
- Signalez les coordonnées de latitude/longitude des points de cheminement d'un véhicule au service Fleet Engine à partir du SDK Navigation.
- Signalez la distance restante d'un véhicule jusqu'à son prochain point de cheminement au service Fleet Engine.
- Signalez l'heure d'arrivée prévue d'un véhicule à son prochain point de cheminement au service Fleet Engine.
- Signalez l'itinéraire fourni pour un véhicule par le SDK Navigation au service Fleet Engine.