Lorsque vous utilisez le partage de parcours Fleet Engine pour les trajets à la demande, les clients peut suivre la progression d'une commande, d'un trajet ou de tout autre service que vous leur fournissez.
Qu'est-ce que le partage de parcours ?
Le partage de parcours est une fonctionnalité de Fleet Engine pour les trajets à la demande. Elle est utilisée pour Consumer SDK. Il fournit des interfaces qui modélisent les données de trajet et suivent et des sessions dans Fleet Engine. De plus, il fournit des classes qui vous permettent de créer un affichage basé sur une carte afin d'offrir aux utilisateurs des informations sur les trajets. Vous intégrez le SDK dans votre application et définissez les profils de rôle appropriés dans Fleet Engine pour permettent aux consommateurs d'utiliser le partage de parcours.
Le partage de parcours fournit des API spécifiques à la plate-forme, ce qui vous permet de créer des parcours le partage natif dans vos applications. Le SDK grand public est disponible pour plates-formes suivantes:
Pourquoi utiliser le partage de parcours ?
En intégrant le partage de parcours à vos applications de trajets à la demande, vous offrent une expérience complète de surveillance des véhicules, avec des informations en temps quasi réel des mises à jour de la position géographique et des positions fermées. Votre les consommateurs peuvent voir l'itinéraire du véhicule en superposition sur une carte, y compris des détails sur l'avancement qui les aident à comprendre où se trouve le trajet ou la livraison.
Que pouvez-vous faire avec le partage de parcours ?
Vous pouvez utiliser les informations du SDK Driver et de Fleet Engine pour créer Les vues du SDK pour mobile et les réponses de service Web qui fournissent les fonctionnalités suivantes:
Personnalisez l'interface utilisateur de la carte pour répondre aux besoins de votre branding.
la position actuelle du véhicule sur son trajet, ainsi que sa position est régulièrement mise à jour.
L'heure d'arrivée estimée (heure d'arrivée prévue) des lieux de prise en charge et de dépose.
Distance restante.
Circulation en temps réel sur l'itinéraire.
Fonctionnement du partage de parcours
De manière générale, le partage du parcours repose sur les mécanismes suivants:
- Les rôles utilisateur Fleet Engine appropriés permettent aux utilisateurs d'applications authentifiés pour récupérer le trajet associé à la commande.
- Association entre le client et le voyage, fournie par votre de votre système backend.
- Le SDK grand public
TripModeletJourneySharingSession, les classes du SDK qui modéliser les données de trajet et partager les sessions de trajet dans l'application grand public.
Le SDK grand public fournit également d'autres interfaces et classes pour que vous puissiez créer une interface utilisateur de cartographie pour votre application, afin que vos clients aient une expérience enrichie avec l'application, avec des informations telles que le trafic, les repères sur la carte, l'heure d'arrivée prévue et des données de routage.
Ce tableau illustre le déroulement d'un parcours partagé.
| 1 | L'application consommateur demande un trajet. | Votre serveur backend reçoit une demande de trajet à la demande et effectue
suivantes:
|
| 2 | Le conducteur accepte le trajet | L'application du chauffeur récupère l'ID et les informations du trajet, et le chauffeur accepte le trajet. |
| 3 | L'application consommateur demande l'accès au parcours | L'application grand public obtient l'identifiant du trajet auprès de votre backend des demandes de début de partage du parcours. |
| 4 | Le conducteur commence son trajet | Lorsque le chauffeur utilise l'application du chauffeur pour indiquer que le trajet a l'application en informe le serveur backend via le SDK Driver. Par exemple, lorsque le conducteur sur le point de quitter le restaurant ou de conduire jusqu’au lieu de prise en charge. |
| 5 | Fleet Engine commence à partager son parcours | Fleet Engine commence à suivre le trajet et à partager sa progression avec l'application grand public. |
| 6 | L'application consommateur affiche le parcours | L'application grand public avertit le client et commence à afficher le vers eux, en mettant à jour le parcours au fur et à mesure qu'il progresse. |
| 7 | Trajet terminé ou annulé | Lorsque le chauffeur annule ou termine le trajet, l'application du conducteur désactive le suivi de la position, mais votre serveur backend indique à Fleet Engine de marquer le trajet comme annulé ou terminé. |
| 8 | L'application grand public met fin au partage du parcours | Le parcours est indiqué comme annulé ou terminé. |
| 9 | Le processus se répète pour le prochain trajet | Un trajet est créé et le processus se répète. |
Utiliser le partage de parcours
Sélectionnez votre plate-forme pour découvrir comment commencer à partager des parcours.
Android
| 1 | Configurer le SDK grand public sous Android | Pour partager des trajets pour des trajets à la demande dans votre application, configurez le SDK grand public. Pour en savoir plus, consultez la page Obtenir le SDK grand public Android. |
| 2 | Configurer l'interface visuelle de partage de parcours | Définissez une carte et ajoutez la prise en charge des cartes vectorielles pour configurer l'interface de votre parcours. Pour en savoir plus, consultez Configurer une carte. |
| 3 | Partager un parcours | 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 parcours et gérer les erreurs de trajet | Mettez à jour les détails de votre trajet, tels que la distance à parcourir et l'heure d'arrivée estimée, et gérez les erreurs au cours de ce trajet. Pour en savoir plus, consultez Mettre à jour la progression du trajet et Gérer les erreurs de trajet |
| 5 | Lorsqu'un parcours est terminé, arrêter le partage | Arrêtez de suivre un trajet pour ne plus 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 grand public dans iOS | Pour partager des trajets pour des trajets à la demande dans votre application, configurez le SDK grand public. Pour en savoir plus, consultez la page Obtenir le SDK grand public iOS. |
| 2 | Configurer l'interface visuelle de partage de parcours | Initialisez la vue de la carte et gérez les événements de carte pour configurer l'interface de votre parcours. Pour en savoir plus, consultez Configurer une carte. |
| 3 | Partager un parcours | 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 parcours et gérer les erreurs de trajet | Mettez à jour les détails de votre trajet, tels que la distance à parcourir et l'heure d'arrivée estimée, et gérez les erreurs au cours de ce trajet. Pour en savoir plus, consultez Mettre à jour la progression du trajet et Gérer les erreurs de trajet |
| 5 | Lorsqu'un parcours est terminé, arrêter le partage | Arrêtez de suivre un trajet pour ne plus partager la position d'un véhicule avec votre client.Pour en savoir plus, consultez la section Arrêter de suivre un trajet. |
JavaScript
| 1 | Configurer le partage de parcours en JavaScript | Pour partager des trajets pour des 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 la carte de partage de parcours | Activez l'API Maps JavaScript et configurez les autorisations pour configurer l'interface de votre parcours. Pour en savoir plus, consultez Configurer une carte. |
| 3 | Partager un parcours | 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 parcours et gérer les erreurs de trajet | Mettez à jour les détails de votre trajet, tels que la distance à parcourir et l'heure d'arrivée estimée, et gérez les erreurs au cours de ce trajet. Pour en savoir plus, consultez mettre à jour et suivre la progression du trajet ; Gérer les erreurs de trajet |
| 5 | Lorsqu'un parcours est terminé, arrêter le partage | Arrêtez de suivre un trajet pour ne plus partager la position d'un véhicule avec votre client. Pour en savoir plus, consultez Arrêter le partage du trajet. |
Composants
Cette section résume deux éléments nécessaires au partage d'un parcours:
Vous pouvez également personnaliser votre expérience de partage de parcours avec ces composants:
Outil de récupération des jetons d'authentification
Pour contrôler l'accès aux données de localisation stockées dans Fleet Engine, vous devez effectuer la suivantes:
Implémenter un service de création de jetons Web JSON (JWT) pour Fleet Engine sur votre serveur.
Implémenter 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 plus d'informations, consultez le guide de configuration pour Android, iOS ou JavaScript.
Vue plan et outils de suivi des trajets
Le partage de parcours comprend des composants pour la visualisation de véhicules et de 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 |
|---|---|
| Affichage de la carte pour le partage de parcours | La vue plan gère le cycle de vie d'un parcours et indique les points de cheminement pour l'emplacement des véhicules au fur et à mesure du trajet. Si l'itinéraire d'un véhicule est connu, la vue plan met à jour l'itinéraire du véhicule pour indiquer la progression du véhicule tout au long de son trajet. |
| Fournisseur de lieu de trajet en JavaScript | Pour les applications Web JavaScript, le fournisseur de lieux de voyage fournit les données de localisation
des informations sur les objets suivis dans la carte de parcours partagée. Pour plus
pour en savoir plus, consultez
Instanciez un fournisseur de localisation de trajet.
Vous pouvez utiliser le fournisseur de localisation de trajets pour effectuer le suivi des informations suivantes pour une
voyage:
|
Objets de localisation suivis
Le fournisseur de localisation suit la position d'objets tels que des points de cheminement et les véhicules, décrits dans le tableau suivant.
| Position suivie | Description |
|---|---|
| Lieu de retrait | Le lieu de prise en charge est le point de départ du voyage. Elle marque le lieu de prise en charge. |
| Emplacement de la destination | La destination est le lieu où se termine le trajet. Elle indique le lieu de dépose. |
| Emplacement du point de cheminement | Un point de cheminement est un point intermédiaire sur la route du parcours suivi. Bien que, techniquement parlant, les points de cheminement puissent inclure les lieux de prise en charge et de dépose, les points de cheminement des arrêts sur la route. Par exemple, les arrêts situés entre la prise en charge et la destination d'un itinéraire de livraison sont des points de cheminement. Pour en savoir plus, consultez Points de cheminement du trajet dans la documentation Fleet Engine. |
| Emplacement du véhicule | La position du véhicule correspond à sa position indiquée. Pour plus consultez la section Localisation du véhicule dans la documentation Fleet Engine. |
Appliquer un style à vos cartes
Les styles de marqueur et de polyligne déterminent l'apparence des objets de type "Lieu suivi" sur la carte. Vous pouvez utiliser des options de style personnalisé pour modifier le style par défaut afin qu'il corresponde au style de votre application Web.
Contrôler la visibilité des lieux suivis
Les fournisseurs de zones géographiques prédéfinis dans Fleet Engine respectent ces règles de visibilité pour les objets de type "Lieu suivi" sur la carte. Si vous créez un attribut personnalisé ou dérivé de localisation, vous pouvez modifier les règles de visibilité.
Les véhicules ne sont visibles que lorsqu'un trajet est en cours: un trajet. le véhicule partagé est visible à partir du moment où il est attribué à un trajet, l'heure de dépôt. Si le trajet est annulé, le véhicule n'est plus visible.
Tous les autres repères de position restent 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. Pour Exemple : partage de parcours avec un lieu de dépôt ou livraison la position géographique est toujours affichée sur la carte, quel que soit l'état lors d'un voyage ou d'une livraison.
Étape suivante
Consultez la documentation de la plate-forme sur laquelle vous souhaitez partager des parcours: