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

Personnalisez l'expérience des consommateurs pour les voyages à la demande en leur permettant de suivre le trajet pour une commande, une course ou tout autre service que vous leur proposez.

Application grand public après un trajet

Qu'est-ce que le SDK grand public ?

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, ainsi que les classes que vous utilisez pour créer un affichage détaillé et basé sur une carte afin de partager les trajets avec vos utilisateurs grand public. 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 grand public 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 le trajet ou la livraison.

Que pouvez-vous faire avec le SDK grand public ?

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 l'itinéraire, et sa position est 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 grand public

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 TripModel et JourneySharingSession qui modélisent les données de trajet et partagent des sessions de trajet dans l'application grand public.

Le SDK grand public fournit également d'autres interfaces et classes pour vous permettre de créer une expérience d'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.

Fonctionnement du SDK client

Ce tableau présente le parcours d'un trajet suivi par une application grand public.

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 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 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 du client envoie une notification au client 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 son trajet, l'application du conducteur désactive le suivi de la position, et votre serveur backend demande à Fleet Engine de marquer le trajet comme annulé ou terminé.
8 L'application grand public s'arrête après le trajet Le trajet apparaît 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 grand public. 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 grand public. 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 partager la position du véhicule approprié 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 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 votre 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:

  1. Implémentez un service de création de jetons Web JSON (JWT) pour Fleet Engine sur votre serveur. Pour en savoir plus, consultez la section Émettre des jetons JWT.

  2. Implémentez un outil de récupération 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 outils de suivi des trajets

La suite 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 du conducteur ou la distance restante à parcourir.

Le tableau suivant décrit ces composants:

Composant Description
Vue carte grand public La vue plan gère le cycle de vie d'un trajet en affichant des points de cheminement pour l'emplacement des véhicules à mesure que le trajet avance. 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 Instancier un fournisseur d'emplacements de trajet. Vous pouvez utiliser le fournisseur de localisation de trajet pour suivre les informations suivantes pour un trajet :
  • Lieu de prise en charge ou de dépose d'un trajet.
  • Emplacement et itinéraire du véhicule attribué au 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 le lieu de départ du trajet.
Emplacement de la destination La destination correspond au lieu où se termine un trajet. Elle marque le lieu de dépose.
Emplacement du point de cheminement Un point de cheminement est un emplacement intermédiaire sur le trajet d'un trajet suivi. D'un point de vue technique, 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 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 à sa position indiquée. 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 de position 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 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 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épôt d'un trajet ou le lieu de livraison d'un colis 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: