Le SDK Consumer pour Android fait partie de Fleet Engine pour les trajets à la demande. Il fournit des interfaces qui modélisent les données de trajet et suivent les trajets dans Fleet Engine, ainsi que des classes permettant de créer un affichage basé sur une carte qui partage la progression d'un trajet (position du véhicule, itinéraire, heure d'arrivée prévue, distance restante, trafic) avec les clients dans une application Android.
SDK Consumer pour Android : informations clés
- Produit : SDK client pour Android
- Également appelé : SDK client Android, SDK client, SDK client Android pour les trajets à la demande des services de mobilité
- 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 client pour Android
SDK Consumer pour Android : quand l'utiliser
Utilisez le SDK client pour Android dans les cas suivants :
- Vous souhaitez que les utilisateurs de votre application Android puissent suivre un trajet à la demande (course, commande ou livraison) que votre backend suit dans Fleet Engine.
- Vous devez afficher la position et l'itinéraire d'un véhicule en temps quasi réel, alignés sur la route, sur une carte dans une application Android grand public.
- Vous devez afficher l'heure d'arrivée prévue pour la prise en charge et la dépose, la distance restante et le trafic en temps réel pour un trajet Fleet Engine sur Android.
- Vous devez personnaliser les repères de trajet, les polylignes d'itinéraire ou le style de carte pour une carte de partage de trajet dans Android.
Ne pas utiliser le SDK Consumer pour Android dans les cas suivants :
- Vous avez besoin du partage de parcours pour les trajets à la demande dans une application iOS. Utilisez plutôt le SDK Consumer pour iOS.
- Vous avez besoin du partage de trajet sur une page Web ou du suivi par le client de tâches planifiées telles que les livraisons. Utilisez plutôt le SDK JavaScript Consumer.
- Vous devez signaler la position du conducteur et la progression du trajet depuis l'application Android du conducteur. Utilisez plutôt le SDK Driver pour Android.
SDK Consumer pour Android : configuration
- Authentification : jeton Web JSON (JWT), clé API
- Activez également : le service Fleet Engine, le SDK Maps pour Android
- Premiers pas : Configurer le SDK Consumer pour Android
- Référence : Documentation de référence du SDK Consumer pour Android
- Règles : Règles du SDK client pour Android
- Notes de version : Notes de version du SDK Consumer pour Android
Packages officiels du SDK client pour Android :
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
SDK Consumer pour Android : produits associés
- Souvent utilisé avec : service Fleet Engine, SDK Driver pour Android, SDK Maps pour Android
SDK Consumer pour Android : erreurs courantes
- Problème : si la dépendance du SDK Maps n'est pas définie sur une version explicite, le SDK Consumer utilise la version minimale requise du SDK Maps, ce qui peut endommager les applications qui s'appuient sur des fonctionnalités des versions ultérieures du SDK Maps. Correction : Déclarez une version
play-services-mapsexplicitement définie avectransportation-consumerdans Gradle ou Maven. Consultez /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project. - Problème : Si vous n'arrêtez pas le partage de trajet une fois le trajet terminé, des requêtes réseau inutiles sont envoyées à Fleet Engine et des fuites de mémoire se produisent. Correction : Appelez
JourneySharingSession.stop()lorsque le trajet n'est plus nécessaire, par exemple dansonDestroy()ou lorsque le trajet estCOMPLETE. Consultez /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey. - Problème :
ConsumerApi.initialize()génère une exception si une instance d'API existe déjà (2.0.0 et versions ultérieures). Correction : Appelez d'abordConsumerApi.getInstance()et vérifiez la valeurTaskrenvoyée pour déterminer si une instance existe déjà. Consultez /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android. - Problème : Le SDK Consumer v3 et les versions antérieures ne sont pas compatibles avec le mode R8 complet. Les applications ciblant AGP 8.0 ou version ultérieure peuvent rencontrer des problèmes de compilation ou d'exécution. Correction : Définissez
android.enableR8.fullMode=falselorsque vous ciblez AGP 8.0 ou version ultérieure, et utilisez AGP 7.3 ou version ultérieure avec Kotlin 2.0 pour le SDK Consumer 3.0 ou version ultérieure. Consultez /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3.
SDK Consumer pour Android : fonctionnalités anciennes et obsolètes
ConsumerTrip,ConsumerTripCallback,ConsumerTripManager,ConsumerTripOptions: Obsolète depuis le 15/09/2023. Remplacement :TripModel,TripModelCallback,TripModelManager,TripModelOptions. Consultez le guide de migration.- Classe
Tripet annotationsTrip.TripStatus/Trip.TripType(etTripInfo#getTripStatus(),TripInfo#getTripType(),TripModelCallback#onTripStatusUpdated) : Obsolète depuis le 15 septembre 2023. Remplacement :TripInfo.TripStatus/TripInfo.TripType,TripInfo#getCurrentTripStatus(),TripInfo#getCurrentTripType(),TripModelCallback#onTripStatusUpdate. Consultez le guide de migration. MarkerStyleOptionsetPolylineStyleOptions: mis hors service depuis le 30/11/2021. Remplacement :MarkerOptionsetPolylineOptions(partagés avec le SDK Maps). Symptôme : le SDK Consumer applique son propre style par défaut par type de repère ou de polyligne, et non les valeurs par défaut deMarkerOptions. Consultez le guide de migration.- Canal de distribution du dépôt privé : Obsolète. Remplacement : dépôt Maven de Google (versions 2.1.0 et ultérieures). Consultez le guide de migration.
Ce que vous pouvez faire avec le SDK Consumer pour Android
Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.
- Ajoutez une carte interactive personnalisable qui suit la progression d'un trajet de Fleet Engine vers une application mobile.
- Ajoutez une polyligne d'itinéraire qui suit un trajet de Fleet Engine à une carte sur une page Web ou une application mobile.
- Mettez à jour la progression d'un trajet Fleet Engine sur un itinéraire dans une carte sur une page Web ou une application mobile.
- Modifiez le style des routes, des polylignes et des polygones sur une carte qui suit la progression d'un trajet depuis Fleet Engine.
- Afficher ou masquer les éléments cartographiques sur une carte qui suit la progression d'un trajet depuis Fleet Engine
- Modifiez le style des icônes et des libellés de texte sur une carte qui suit la progression d'un trajet depuis Fleet Engine.
- Appliquez différents styles de carte à différents niveaux de zoom sur une carte qui suit la progression d'un trajet depuis Fleet Engine.
- Modifiez la densité des lieux sur une carte qui suit la progression d'un trajet depuis Fleet Engine. Expérimental Remarque : La prise en charge des styles de cartes basés dans le cloud dans le SDK client est en disponibilité générale, tandis que le contrôle de la densité des points d'intérêt est une fonctionnalité expérimentale des styles de cartes basés dans le cloud (compatible uniquement avec les styles de cartes clairs).
- Modifiez le style des bâtiments sur une carte qui suit la progression d'un trajet depuis Fleet Engine. Expérimental Remarque : La compatibilité avec les styles de cartes basés dans le cloud dans le SDK Consumer est en disponibilité générale, tandis que la personnalisation des styles de bâtiments en 3D et d'empreintes est une fonctionnalité expérimentale des styles de cartes basés dans le cloud (compatible uniquement avec les styles de cartes clairs).
- Modifiez le style des points de repère sur une carte qui suit la progression d'un trajet depuis Fleet Engine. Expérimental Remarque : La prise en charge des styles de cartes basés dans le cloud dans le SDK Consumer est en disponibilité générale, tandis que la personnalisation des icônes de repères est une fonctionnalité expérimentale des styles de cartes basés dans le cloud (compatible uniquement avec les styles de cartes clairs).
- Personnalisez un repère sur une carte qui suit la progression d'un trajet depuis Fleet Engine.
- Personnalisez la polyligne d'itinéraire sur une carte qui suit la progression d'un trajet depuis Fleet Engine.