La documentation de cette section explique comment créer des trajets et les utiliser avec le service de trajets à la demande Google Maps Mobility. Elle suppose que vous connaissez les éléments suivants :
- Fleet Engine : vous devez connaître les détails d'implémentation , les mécanismes de requête et la sécurité de Fleet Engine. Pour cela, consultez Qu'est-ce que le service Fleet Engine ? et les sujets liés à la sécurité dans Configurer Fleet Engine.
- Principes de base des véhicules pour les services à la demande. Consultez Présentation des véhicules.
- Principes de base des trajets pour les services à la demande. Consultez Trajets à la demande.
Le TripService que vous utiliserez est disponible pour gRPC et REST.
Par souci de simplicité, les références de champ suivent la convention gRPC.
Dans Fleet Engine pour les services à la demande, un trajet est un type de parcours qui modélise l'exécution d'une demande de livraison de nourriture ou de transport de vos clients. Un trajet a un état que vous signalez à Fleet Engine au fur et à mesure de son évolution, par exemple NEW, ENROUTE_TO_PICKUP, etc. L'état du trajet correspond aux points de repère géolocalisés attribués au véhicule, et Fleet Engine modifie ces points de repère du véhicule à chaque mise à jour de trajet que vous effectuez. Pour en savoir plus sur les trajets et leur relation avec les véhicules, consultez Trajets à la demande dans Principes de base de Fleet
Engine.
Cycle de vie d'un trajet
Pour suivre chaque trajet dans Fleet Engine, vous devez d'abord créer une entité Trip. Pour référence, consultez gRPC ou REST.
Le tableau suivant décrit un exemple de flux de bout en bout d'un trajet créé dans votre système et ses étapes de cycle de vie dans Fleet Engine. Il suppose que vous avez configuré Fleet Engine et que vous disposez d'un véhicule à attribuer au trajet, avec les mises à jour de la position activées dans l'application chauffeur. Consultez SDK chauffeur : trajets à la demande.
| 1 | Recevoir une demande de réservation | Avant le début d'un trajet Fleet Engine, votre système de réservation reçoit d'abord une
demande de transport ou de livraison d'un client via votre application ou un autre
système de réservation. Votre système crée ensuite l'entité de trajet à l'aide de
CreateTrip avec les champs obligatoires, tels que le lieu de prise en charge.
Il peut également définir d'autres champs à ce stade, tels que les passagers et
lieu de dépose, ou attendre d'attribuer un véhicule. Consultez
Créer un trajet à destination unique. |
| 2 | Attribuer un véhicule | Vous pouvez attribuer des véhicules à des trajets directement dans votre système et signaler l'attribution à Fleet Engine, ou utiliser le service de recherche de véhicules pour rechercher des véhicules, en filtrant à la fois par attributs de trajet et de véhicule afin de trouver le meilleur véhicule pour effectuer le trajet. Tout véhicule en ligne dans votre rayon de recherche indique sa proximité via les mises à jour de la position fournies par le SDK chauffeur. Une fois que |
| 3 | Mettre à jour le trajet | Une fois que le chauffeur accepte le trajet et commence à se rendre au
lieu de prise en charge, votre système met à jour l'état du trajet de NEW
à ENROUTE_TO_PICKUP. Vous continuez à interroger la position du véhicule
tout au long du trajet, soit via une connexion directe de
l'application à votre backend, soit en interrogeant Fleet Engine, qui reçoit un
flux continu de mises à jour de la position du véhicule à partir du SDK chauffeur. Votre
système signale ensuite chaque étape du trajet à Fleet Engine, qui met à jour
la liste des points de repère du véhicule en conséquence.
|
| 4 | Partager le trajet avec le client | Fleet Engine met les détails du trajet et la position du véhicule à la disposition du SDK client, qui utilise un écouteur pour recevoir les mises à jour du trajet et les afficher dans l'application grand public. Fleet Engine met automatiquement à jour l'heure d'arrivée prévue, la distance restante, les itinéraires et les points de repère restants du véhicule. Pour en savoir plus, consultez Partager des trajets pour les trajets à la demande. |
| 5 | Terminer le trajet | Une fois que le véhicule atteint le point de cheminement de destination du trajet et que votre
chauffeur indique que le trajet s'est bien déroulé, votre système définit le
TripStatus sur COMPLETE dans Fleet Engine. N'oubliez pas que, comme les véhicules, les entités de trajet restent actives dans Fleet Engine pendant sept jours, quel que soit leur état, après quoi elles sont supprimées. |
Flux de séquence de trajet
Le diagramme suivant présente une vue plus détaillée de ce flux.
