Personnalisez l'expérience des consommateurs pour les trajets à la demande en leur permettant de suivre le trajet pour une commande, un trajet ou un autre service que vous leur fournissez.
Qu'est-ce que le SDK Consumer ?
Le SDK client 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, et des classes que vous utilisez pour créer un affichage riche basé sur une carte afin de partager des trajets avec vos utilisateurs finaux. Vous devez intégrer le SDK client à votre application et définir les profils de rôle appropriés dans Fleet Engine pour créer cette expérience client.
Les API spécifiques à la plate-forme du SDK Consumer vous permettent de partager des parcours en mode natif dans vos applications. Le SDK Consumer est disponible pour les plates-formes suivantes:
Pourquoi utiliser le SDK Consumer ?
Intégrer le SDK Consumer à vos applications de trajets à la demande vous permet de proposer une expérience client complète, avec des mises à jour de position en quasi-temps réel et des positions géocodées. Vos clients peuvent voir l'itinéraire du véhicule superposé à une carte, y compris des informations 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'interface utilisateur de la carte en fonction de vos besoins en branding.
Suivez la position actuelle du véhicule tout au long de son itinéraire, sa position étant mise à jour régulièrement.
Afficher l'heure d'arrivée prévue (ETA) pour les lieux de prise en charge et de dépose
Afficher la distance restante
Afficher le trafic en temps réel sur l'itinéraire.
Fonctionnement du SDK Consumer
De manière générale, le SDK client s'appuie sur les mécanismes suivants:
- Avoir les 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 consommateur et le trajet, fournie par votre système 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 pour que vous puissiez créer une expérience d'application riche, avec des informations telles que le trafic, les repères sur la carte, l'heure d'arrivée estimée et les données d'itinéraire.
Ce tableau présente le parcours 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 reçoit 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 cliente obtient l'ID de trajet à partir de votre backend et demande à commencer à suivre le trajet. |
| 4 | Le conducteur commence le trajet | Lorsque le conducteur utilise l'application conducteur pour indiquer que le trajet a commencé, l'application informe votre serveur backend via le SDK Driver. Par exemple, lorsque le livreur est sur le point de quitter le restaurant ou de se rendre au point de retrait. |
| 5 | Fleet Engine commence à envoyer des informations sur les trajets | 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 du client l'informe et commence à lui afficher les informations sur le trajet, en les mettant à jour au fur et à mesure. |
| 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 cesse de suivre le trajet | Le trajet s'affiche comme annulé ou terminé. |
| 9 | Le processus se répète pour le prochain trajet. | 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 les 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 Android Consumer. |
| 2 | Configurer l'interface visuelle | Définissez une carte et ajoutez la prise en charge des cartes vectorielles pour configurer votre expérience client. Pour en savoir plus, consultez Configurer une carte. |
| 3 | Suivre un trajet | Suivez un trajet pour indiquer à votre client l'emplacement du véhicule approprié. 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 informations sur vos trajets, comme la distance parcourue et l'heure d'arrivée estimée, et gérez les erreurs pendant un trajet. Pour en savoir plus, consultez les pages Mettre à jour la progression du trajet et Gérer les erreurs de trajet. |
| 5 | Arrêter de suivre un trajet lorsqu'il est 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 sur iOS | Pour suivre les trajets à la demande dans votre application, configurez le SDK Consumer. Pour en savoir plus, consultez Obtenir le SDK pour les utilisateurs iOS. |
| 2 | Configurer l'interface visuelle | Initialisez la vue de la carte et gérez les événements de la carte pour configurer votre expérience client. Pour en savoir plus, consultez Configurer une carte. |
| 3 | Suivre un trajet | Suivez un trajet pour indiquer à votre client l'emplacement du véhicule approprié. 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 informations sur vos trajets, comme la distance parcourue et l'heure d'arrivée estimée, et gérez les erreurs pendant un trajet. Pour en savoir plus, consultez les pages Mettre à jour la progression du trajet et Gérer les erreurs de trajet. |
| 5 | Arrêter de suivre un trajet lorsqu'il est 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 client JavaScript. |
| 2 | Charger et personnaliser une carte | Activez l'API Maps JavaScript et configurez l'autorisation pour configurer votre expérience client. Pour en savoir plus, consultez Configurer une carte. |
| 3 | Suivre un trajet | Suivez un trajet pour indiquer à votre client l'emplacement du véhicule approprié. Pour en savoir plus, consultez Suivre un trajet. |
| 5 | Mettre à jour la progression du trajet et gérer les erreurs de trajet | modifier les informations sur vos trajets (distance et heure d'arrivée estimée, par exemple) et gérer les erreurs associées à un trajet ; Pour en savoir plus, consultez les pages Mettre à jour et suivre la progression du trajet et Gérer les erreurs de trajet. |
| 5 | Arrêter de suivre un trajet lorsqu'il est 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 les 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, procédez 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 JWT.
Implémentez un récupérateur de jeton 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 outils de suivi des trajets
Le suivi d'un trajet inclut des composants permettant de visualiser les véhicules et les points de repère, ainsi que des flux de données brutes pour l'heure d'arrivée estimée du conducteur ou la distance restante à parcourir.
Le tableau suivant décrit ces composants:
| Composant | Description |
|---|---|
| Vue carte pour les consommateurs | La vue Carte gère le cycle de vie d'un trajet, en affichant des points de cheminement pour la position des véhicules au fur et à mesure du trajet. Si l'itinéraire d'un véhicule est connu, la vue cartographique met à jour la polyligne de l'itinéraire du véhicule pour indiquer la progression du véhicule sur son itinéraire. |
| Fournisseur de localisation de trajet en JavaScript | Pour les applications Web JavaScript, le fournisseur de localisation du trajet fournit des informations de localisation pour les objets suivis dans la carte de trajet partagée. Pour en savoir plus, consultez la section Instancier un fournisseur d'emplacements 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 position suit la position d'objets tels que les points de cheminement et les véhicules, comme décrit dans le tableau suivant.
| Emplacement suivi | Description |
|---|---|
| Lieu de retrait | Le lieu de prise en charge est l'endroit où un trajet commence. |
| Emplacement de la destination | L'emplacement de destination est l'emplacement où se termine un trajet. Il indique l'emplacement de dépôt. |
| Emplacement du point de cheminement | Un point de cheminement est un emplacement intermédiaire sur le trajet d'un trajet suivi. Bien que, techniquement, les points de cheminement puissent inclure les lieux de prise en charge et de dépose, ils font généralement référence aux arrêts intermédiaires sur l'itinéraire. Par exemple, les arrêts entre le lieu de prise en charge et la destination d'un itinéraire de livraison sont des points de cheminement. Pour en savoir plus, consultez la section Points de repère de trajet dans la documentation de Fleet Engine. |
| Emplacement du véhicule | La position du véhicule correspond à la position indiquée pour un véhicule. Pour en savoir plus, consultez la section Position 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 d'emplacement suivis sur la carte. Vous pouvez utiliser des options de style personnalisées pour qu'elles correspondent au style de votre application Web.
Contrôler la visibilité des hôtels suivis
Les fournisseurs de position prédéfinis dans Fleet Engine suivent ces règles de visibilité pour les objets d'emplacement suivis sur la carte. Si vous créez un fournisseur de position 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 de trajet est visible 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 géographiques sont toujours visibles: tous les autres repères géographiques 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épôt 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: