Présentation des trajets à la demande utilisant le SDK grand public

Personnalisez l'expérience des consommateurs pour les trajets à la demande en leur permettant 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 des trajets avec vos utilisateurs consommateurs. Vous intégrez le SDK Consumer à votre application et définissez les profils de rôle appropriés dans Fleet Engine pour créer cette expérience consommateur.

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 :

• Android
• iOS
• JavaScript

Pourquoi utiliser le SDK Consumer ?

L'intégration du SDK Consumer à vos applications de trajets à la demande vous permet d'offrir une expérience complète aux consommateurs, avec des mises à jour de la position en temps quasi réel et des positions ajustées à la route. Vos consommateurs peuvent voir l'itinéraire du véhicule superposé à une carte, y compris des informations sur l'avancement qui les aident à comprendre où se trouve leur course 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 consommateur personnalisées, y compris les fonctionnalités suivantes :

• Personnalisez l'interface utilisateur de la carte pour l'adapter à vos besoins en matière de branding.

• Suivez la position actuelle du véhicule sur son itinéraire, sa position étant mise à jour régulièrement.

• Affichez l'heure d'arrivée prévue pour les lieux de prise en charge et de dépose.

• Affichez la distance restante.

• Affichez la circulation en temps réel sur l'itinéraire.

Fonctionnement du SDK Consumer

En règle 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 consommateur.
• Une association entre le consommateur et le trajet, fournie par votre système backend.
• Les classes SDK TripModel et JourneySharingSession qui modélisent les données de trajet et partagent les sessions de trajet dans l'application consommateur.

Le SDK Consumer fournit également d'autres interfaces et classes afin que vous puissiez créer une expérience d'application riche 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 présente le flux d'un trajet suivi par une application consommateur.

1	L'application consommateur demande un trajet	Votre serveur backend reçoit une demande de trajet à la demande et effectue les opérations suivantes : Crée un trajet dans Fleet Engine. Attribue le trajet à un véhicule.
2	Le chauffeur accepte le trajet	L'application chauffeur reçoit l'ID et les informations du trajet, et le chauffeur accepte le trajet.
3	L'application consommateur demande l'accès pour suivre le trajet	L'application consommateur reçoit l'ID de trajet de votre backend et demande à commencer à suivre le trajet.
4	Le chauffeur commence le trajet	Lorsque le chauffeur utilise l'application chauffeur pour indiquer que le trajet a commencé, l'application envoie une notification à votre serveur backend via le SDK Driver. Par exemple, lorsque le chauffeur 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 consommateur.
6	L'application consommateur affiche les informations sur le trajet	L'application consommateur envoie une notification au consommateur et commence à lui afficher les informations sur le trajet, en le mettant à jour au fur et à mesure de sa progression.
7	Le trajet est annulé ou terminé	Lorsque le chauffeur annule ou termine le trajet, l'application chauffeur 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 consommateur cesse de suivre le trajet	Le trajet s'affiche 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 commencer à suivre des trajets dans vos applications consommateur.

Composants

Cette section récapitule deux composants nécessaires pour suivre un trajet :

• Récupérateur de jetons d'authentification
• Vue cartographique et trackers de trajet.

Vous pouvez également personnaliser votre expérience consommateur avec ces composants :

• Appliquez un style à vos cartes.
• Contrôlez la visibilité des lieux suivis.

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 :

1. 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.

2. 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 trackers de trajet

Le suivi d'un trajet inclut des composants pour la visualisation des véhicules et des waypoints, ainsi que des flux de données brutes pour l'heure d'arrivée prévue d'un chauffeur ou la distance restante à parcourir.

Le tableau suivant décrit ces composants :

Composant	Description
Vue cartographique du consommateur	La vue cartographique gère le cycle de vie d'un trajet, en affichant les waypoints pour la position des véhicules au fur et à mesure de la progression 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 sa progression.
Fournisseur de localisation de trajet en JavaScript	Pour les applications Web JavaScript, le fournisseur de localisation de trajet fournit des informations de localisation pour les objets suivis dans la carte de trajet partagée. Pour en savoir plus, consultez Instancier un fournisseur de localisation de trajet. Vous pouvez utiliser le fournisseur de localisation de trajet pour suivre les informations suivantes pour un trajet : Le lieu de prise en charge ou de dépose d'un trajet. La position et l'itinéraire du véhicule attribué au trajet.

Objets de localisation suivis

Le fournisseur de localisation suit la position d'objets tels que les waypoints et les véhicules, comme décrit dans le tableau suivant.

Localisation suivie	Description
Lieu de prise en charge	Le lieu de prise en charge est le lieu où commence un trajet.
Emplacement de la destination	L'emplacement de la destination est le lieu où se termine un trajet. Il marque le lieu de dépose.
Waypoint	Un waypoint est un lieu intermédiaire sur l'itinéraire d'un trajet suivi. Techniquement parlant, les waypoints 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 sur l'itinéraire. Par exemple, les arrêts entre les lieux de prise en charge et de destination sur un itinéraire de livraison sont des waypoints. Pour en savoir plus, consultez Waypoints de trajet dans la documentation Fleet Engine.
Position du véhicule	La position du véhicule est la position signalée d'un véhicule. Pour en savoir plus, consultez 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 de localisation suivis sur la carte. Vous pouvez utiliser des options de style personnalisées pour correspondre au style de votre application Web.

Contrôler la visibilité des lieux 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 de trajet 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 localisation sont toujours visibles : tous les autres repères de localisation pour l'origine, la destination et les waypoints sont toujours affichés sur la carte. Par exemple, un lieu de dépose ou un 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 :

• Android
• iOS
• JavaScript