Personnalisez l'expérience client pour les trajets à la demande en permettant aux clients de suivre le trajet d'une commande, d'une course ou d'un autre service que vous leur fournissez.
Qu'est-ce que le SDK Consumer ?
Le SDK Consumer 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 que vous utilisez pour créer un affichage riche basé sur une carte afin de partager les trajets avec vos utilisateurs. Pour créer cette expérience client, vous devez intégrer le SDK Consumer à votre application et définir les profils de rôle appropriés dans Fleet Engine.
Les API spécifiques à la plate-forme du SDK Consumer vous permettent d'intégrer la possibilité de partager des trajets de manière native dans vos applications. Le SDK Consumer est disponible pour les plates-formes suivantes :
Pourquoi utiliser le SDK Consumer ?
L'intégration du SDK Consumer à vos applications de trajets à la demande vous permet de proposer une expérience client complète, avec des notifications de position en temps quasi réel et des positions alignées sur la route. Vos clients peuvent voir l'itinéraire du véhicule superposé sur une carte, y compris des détails sur la progression qui les aident à comprendre où se trouve leur trajet ou leur livraison.
Que pouvez-vous faire avec le SDK Consumer ?
Vous pouvez utiliser les informations du SDK Driver et de Fleet Engine pour créer des expériences client personnalisées, y compris les fonctionnalités suivantes :
Personnalisez l'UI de la carte en fonction de vos besoins de branding.
Suivez la position actuelle du véhicule tout au long de son trajet, avec des mises à jour régulières.
Affichez l'heure d'arrivée prévue pour les lieux de prise en charge et de dépose.
Affiche la distance restante.
Affichez les conditions de circulation en temps réel sur l'itinéraire.
Fonctionnement du SDK Consumer
De manière générale, le SDK Consumer repose sur les mécanismes suivants :
- Disposer des rôles Fleet Engine appropriés pour qu'une application authentifiée puisse suivre le trajet associé à la commande d'un client.
- Association entre le client et le trajet, fournie par votre système de backend.
- Les classes de SDK
TripModeletJourneySharingSessionqui modélisent les données de trajet et partagent les sessions de trajet dans l'application grand public.
Le SDK Consumer fournit également d'autres interfaces et classes qui vous permettent de créer une expérience dans l'application enrichie avec des détails tels que le trafic, les repères sur la carte, l'heure d'arrivée prévue et les données d'itinéraire.
Ce tableau montre le déroulement d'un trajet suivi par une application grand public.
| 1 | L'application grand public demande un trajet | Votre serveur backend reçoit une demande de trajet à la demande et effectue les opérations suivantes :
|
| 2 | Le conducteur accepte le trajet | L'application du conducteur obtient l'ID et les informations du trajet, et le conducteur accepte le trajet. |
| 3 | L'application grand public demande l'accès pour suivre le trajet | L'application grand public obtient l'ID du trajet à partir de votre backend et demande à commencer à suivre le trajet. |
| 4 | Le conducteur commence le trajet | Lorsque le conducteur utilise l'application du conducteur pour indiquer que le trajet a commencé, l'application en informe votre serveur backend via le SDK Driver. Par exemple, lorsque le conducteur est sur le point de quitter le restaurant ou de se rendre au lieu de prise en charge. |
| 5 | Fleet Engine commence à envoyer des informations sur le trajet | Fleet Engine commence à suivre le trajet et à partager sa progression avec l'application grand public. |
| 6 | L'application grand public affiche les informations sur le trajet | L'application grand public envoie une notification au client et commence à lui afficher les informations sur le trajet, en les mettant à jour au fur et à mesure de sa progression. |
| 7 | Le trajet est annulé ou terminé | Lorsque le conducteur annule ou termine le trajet, l'application du conducteur désactive le suivi de la position, et votre serveur backend indique à Fleet Engine de marquer le trajet comme annulé ou terminé. |
| 8 | L'application grand public arrête de suivre le trajet | Le trajet est indiqué comme annulé ou terminé. |
| 9 | Le processus se répète pour le trajet suivant | Un nouveau trajet est créé et le processus se répète. |
Utiliser le SDK Consumer
Sélectionnez votre plate-forme pour découvrir comment suivre des trajets dans vos applications grand public.
Android
| 1 | Configurer le SDK Consumer dans Android | Pour suivre les trajets à la demande dans votre application, configurez le SDK Consumer. Pour en savoir plus, consultez Obtenir le SDK Consumer pour Android. |
| 2 | Configurer l'interface visuelle | Définissez une carte et ajoutez la compatibilité avec les cartes vectorielles pour configurer l'expérience client. Pour en savoir plus, consultez Configurer une carte. |
| 3 | Suivre un trajet | Suivez un trajet pour partager la position du véhicule concerné avec votre client. Pour en savoir plus, consultez Suivre un trajet. |
| 5 | Mettre à jour la progression du trajet et gérer les erreurs de trajet | Mettez à jour les détails de vos trajets, comme la distance et l'heure d'arrivée prévue, et gérez les erreurs qui se produisent pendant un trajet. Pour en savoir plus, consultez Mettre à jour la progression du trajet et Gérer les erreurs de trajet. |
| 5 | Arrêter le suivi une fois le trajet terminé | Arrêtez de suivre un trajet pour arrêter de partager la position d'un véhicule avec votre client. Pour en savoir plus, consultez Arrêter de suivre un trajet. |
iOS
| 1 | Configurer le SDK Consumer dans iOS | Pour suivre les trajets à la demande dans votre application, configurez le SDK Consumer. Pour en savoir plus, consultez Obtenir le SDK Consumer pour iOS. |
| 2 | Configurer l'interface visuelle | Initialisez la vue cartographique et gérez les événements de carte pour configurer l'expérience client. Pour en savoir plus, consultez Configurer une carte. |
| 3 | Suivre un trajet | Suivez un trajet pour partager la position du véhicule concerné avec votre client. Pour en savoir plus, consultez Suivre un trajet. |
| 5 | Mettre à jour la progression du trajet et gérer les erreurs de trajet | Mettez à jour les détails de vos trajets, comme la distance et l'heure d'arrivée prévue, et gérez les erreurs qui se produisent pendant un trajet. Pour en savoir plus, consultez Mettre à jour la progression du trajet et Gérer les erreurs de trajet. |
| 5 | Arrêter le suivi une fois le trajet terminé | Arrêtez de suivre un trajet pour arrêter de partager la position d'un véhicule avec votre client. Pour en savoir plus, consultez Arrêter de suivre un trajet. |
JavaScript
| 1 | Configurer le SDK Consumer en JavaScript | Pour suivre les trajets à la demande dans votre application, configurez le SDK Consumer. Pour en savoir plus, consultez Configurer le SDK Consumer JavaScript. |
| 2 | Charger et personnaliser une carte | Activez l'API Maps JavaScript et configurez l'autorisation pour configurer l'expérience client. Pour en savoir plus, consultez Configurer une carte. |
| 3 | Suivre un trajet | Suivez un trajet pour partager la position du véhicule concerné avec votre client. Pour en savoir plus, consultez Suivre un trajet. |
| 5 | Mettre à jour la progression du trajet et gérer les erreurs de trajet | Mettez à jour les détails de vos trajets, comme la distance parcourue et l'heure d'arrivée prévue, et gérez les erreurs survenant lors d'un trajet. Pour en savoir plus, consultez Mettre à jour et suivre la progression d'un trajet et Gérer les erreurs de trajet. |
| 5 | Arrêter le suivi une fois le trajet terminé | Arrêtez de suivre un trajet pour arrêter de partager la position d'un véhicule avec votre client. Pour en savoir plus, consultez Arrêter de suivre un trajet. |
Composants
Cette section résume deux composants nécessaires pour suivre un trajet :
Vous pouvez également personnaliser l'expérience client avec les composants suivants :
Récupérateur de jetons d'authentification
Pour contrôler l'accès aux données de localisation stockées dans Fleet Engine, vous devez procéder comme suit :
Implémentez un service de création de jetons Web JSON (JWT) pour Fleet Engine sur votre serveur. Pour en savoir plus, consultez Émettre des jetons JWT.
Implémentez un récupérateur de jetons d'authentification dans vos applications Web ou mobiles pour authentifier l'accès aux données de localisation. Pour en savoir plus sur la configuration d'un récupérateur de jetons, consultez le guide de configuration pour Android, iOS ou JavaScript.
Vue cartographique et suivi des trajets
Le suivi d'un trajet inclut des composants pour la visualisation des véhicules et des points de cheminement, ainsi que des flux de données brutes pour l'heure d'arrivée prévue d'un conducteur ou la distance restante à parcourir.
Le tableau suivant décrit ces composants :
| Composant | Description |
|---|---|
| Vue de la carte grand public | La vue de la carte gère le cycle de vie d'un trajet, en affichant des points de cheminement pour l'emplacement des véhicules au fur et à mesure de la progression du trajet. Si l'itinéraire d'un véhicule est connu, la vue de la carte met à jour la polyligne de l'itinéraire du véhicule pour indiquer sa progression sur son itinéraire. |
| Fournisseur de localisation de trajet en JavaScript | Pour les applications Web JavaScript, le fournisseur de localisation de trajet transmet les informations de localisation des objets suivis à la carte du trajet partagé. Pour en savoir plus, consultez Instancier un fournisseur de localisation de trajet.
Vous pouvez utiliser le fournisseur de localisation de trajet pour suivre les détails suivants d'un trajet :
|
Objets de localisation suivis
Le fournisseur de localisation suit la position d'objets tels que les points de cheminement et les véhicules, décrits dans le tableau suivant.
| Emplacement suivi | Description |
|---|---|
| Lieu de récupération | Le lieu de prise en charge est le lieu de départ d'un trajet. |
| Emplacement de la destination | La destination est l'endroit où se termine un trajet. Il indique le lieu de dépose. |
| Emplacement du point de cheminement | Un point de cheminement est un emplacement intermédiaire le long de l'itinéraire d'un trajet suivi. Techniquement, les points de cheminement peuvent inclure des lieux de prise en charge et de dépose, mais ils font généralement référence à des arrêts intermédiaires le long de l'itinéraire. Par exemple, les arrêts entre le lieu de prise en charge et la destination sur un itinéraire de livraison sont des points de cheminement. Pour en savoir plus, consultez Points de cheminement d'un trajet dans la documentation Fleet Engine. |
| Emplacement du véhicule | La position du véhicule est la position signalée d'un véhicule. Pour en savoir plus, consultez Emplacement du véhicule dans la documentation Fleet Engine. |
Appliquer un style à vos cartes
Les styles de repère et de polyligne déterminent l'apparence des objets de localisation suivis sur la carte. Vous pouvez utiliser des options de style personnalisées pour l'adapter au style de votre application Web.
Contrôler la visibilité des hôtels suivis
Les fournisseurs de localisation prédéfinis dans Fleet Engine suivent ces règles de visibilité pour les objets de localisation suivis sur la carte. Si vous créez un fournisseur de localisation personnalisé ou dérivé, vous pouvez modifier les règles de visibilité.
Les véhicules ne sont visibles que lorsque le trajet est en cours : un véhicule est visible à partir du moment où il est attribué à un trajet jusqu'au moment de la dépose. Si le trajet est annulé, le véhicule n'est plus visible.
Tous les autres repères de position sont toujours visibles : tous les autres repères de position pour le point de départ, la destination et les points de cheminement sont toujours affichés sur la carte. Par exemple, le lieu de dépose d'un trajet ou le lieu de livraison d'un envoi est toujours affiché sur la carte, quel que soit l'état du trajet ou de la livraison.
Étape suivante
Consultez la documentation de la plate-forme sur laquelle vous souhaitez suivre les trajets :