La documentation de cette section explique comment créer et utiliser des trajets à l'aide du service de trajets à la demande de Google Maps Mobility. Il suppose que vous connaissez les éléments suivants:
- Fleet Engine : vous devez connaître les détails de l'implémentation de Fleet Engine, les mécanismes de requête et la sécurité. Pour en savoir plus, consultez Qu'est-ce que le service Fleet Engine ? et les sujets de sécurité dans Configurer Fleet Engine.
- Principes de base des véhicules pour des services à la demande Consultez la section Présentation des véhicules.
- Principes de base des trajets pour les services à la demande Consultez la section Voyages à 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 la réalisation d'une demande de livraison de repas ou de trajet de la part de vos clients. Un trajet a un état que vous signalez à Fleet Engine au fur et à mesure de l'évolution du trajet, par exemple NEW
, ENROUTE_TO_PICKUP
, etc. L'état du trajet correspond aux points de cheminement géolocalisés attribués au véhicule, et Fleet Engine modifie ces points de cheminement à chaque mise à jour du trajet que vous effectuez. Pour en savoir plus sur les trajets et leur relation avec les véhicules, consultez la section Trajets à la demande dans Principes essentiels de Fleet Engine.
Cycle de vie d'un voyage
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 parcours 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 position activées dans l'application du conducteur. Consultez la section SDK Driver: trajets à la demande.
1 | Recevez la 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 trajet 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 le lieu de dépose, ou attendre qu'il attribue un véhicule. Consultez la section Créer un trajet à destination unique. |
2 | Attribuez 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 Search Vehicle (Rechercher un véhicule) 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 le rayon de recherche indique sa proximité via les mises à jour de position fournies par le SDK Driver. Une fois que |
3 | Mettre à jour le trajet | Une fois que le conducteur a accepté le trajet et commencé à se rendre au point de rendez-vous, votre système passe 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 d'informations sur la position du véhicule à partir du SDK Driver. Votre système signale ensuite chaque jalon du trajet à Fleet Engine, qui met à jour la liste des points de cheminement du véhicule en conséquence.
|
4 | Partagez le parcours avec le consommateur. | Fleet Engine met à la disposition du SDK client les informations sur le trajet et la position du véhicule. Le SDK client utilise un écouteur pour recevoir les informations sur le trajet et les afficher dans l'application grand public. Fleet Engine met automatiquement à jour l'heure d'arrivée estimée, la distance restante, les itinéraires et les points de cheminement restants du véhicule. Pour en savoir plus, consultez la section Partager des trajets pour les trajets à la demande. |
5 | Terminez le trajet. | Une fois que le véhicule a atteint le point de destination du trajet et que votre chauffeur indique que le trajet a bien été effectué, votre système définit 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 schéma suivant présente une vue plus détaillée de ce flux.