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

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

Packages officiels du SDK client pour Android :

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

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-maps explicitement définie avec transportation-consumer dans 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 dans onDestroy() ou lorsque le trajet est COMPLETE. 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'abord ConsumerApi.getInstance() et vérifiez la valeur Task renvoyé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=false lorsque 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 Trip et annotations Trip.TripStatus / Trip.TripType (et TripInfo#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.
  • MarkerStyleOptions et PolylineStyleOptions : mis hors service depuis le 30/11/2021. Remplacement : MarkerOptions et PolylineOptions (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 de MarkerOptions. 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.