La documentation de cette section explique comment créer et utiliser des trajets à l'aide de le service de trajets à la demande de Google Maps Mobility. Il part du principe que vous connaissez les éléments suivants:
- Fleet Engine: vous devez être familiarisé avec la mise en œuvre de Fleet Engine. les détails, les mécanismes de demande et la sécurité. Pour en savoir plus, consultez la page What is the Fleet service Engine ? et les sujets liés à la sécurité décrits dans la section Configurer Fleet Engine.
- Principes de base des véhicules pour des services à la demande Voir 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 allez utiliser 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 trajet
le traitement d'une demande de livraison
de repas ou de course de vos clients. Un voyage
dont l'état est que vous signalez à Fleet Engine au fur et à mesure de l'évolution du parcours ;
NEW, ENROUTE_TO_PICKUP, etc. L'état du trajet correspond à la géolocalisation.
des points de cheminement attribués au véhicule, et que Fleet Engine modifie le véhicule en question
des points de cheminement à chaque mise à jour de trajet. Consultez les trajets à la demande dans le parc du parc
Engine Essentials pour en savoir plus sur les trajets et leur rapport aux véhicules.
Cycle de vie d'un voyage
Pour suivre chaque trajet dans Fleet Engine, vous devez d'abord créer un Trip
entité. Consultez la documentation sur gRPC ou sur REST pour en savoir plus.
Le tableau suivant décrit un exemple de flux de bout en bout d'un trajet créé dans et leurs étapes de cycle de vie dans Fleet Engine. Il suppose que vous avez configuré Fleet Engine et avoir un véhicule à attribuer au trajet, avec des mises à jour de la position activé dans l'application pilote. Consultez Driver SDK: On-demand trips (SDK pour conducteur : 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
une demande de course ou de livraison auprès d'un consommateur via votre application ou une autre
système de réservation. Votre système crée ensuite l'entité de trajet à l'aide de
CreateTrip avec des champs obligatoires, tels que le lieu de retrait.
À ce stade, il peut également définir d'autres champs, tels que "passagers" et
lieu de dépôt, ou attendre qu'il attribue un véhicule. Voir
Créez un voyage à destination unique. |
| 2 | Attribuez un véhicule. | Vous pouvez affecter des véhicules à des trajets directement dans votre système et signaler l'attribution à Fleet Engine, ou vous pouvez utiliser la Rechercher un véhicule service de recherche de véhicules, en filtrant par trajet et par véhicule pour trouver le meilleur véhicule pour effectuer le trajet. Tous en ligne véhicule dans votre rayon de recherche permet de connaître sa proximité 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 commence la navigation vers
lieu de prise en charge, votre système met à jour l'état du trajet à partir de NEW
à ENROUTE_TO_PICKUP. Vous continuez d'interroger le véhicule
tout au long du trajet, que ce soit via une connexion directe
l'application à votre backend, ou en interrogeant Fleet Engine, qui reçoit une
flux continu de mises à jour de la position des véhicules à partir du SDK Driver. Votre
signale chaque étape du parcours à Fleet Engine, qui met à jour
la liste des points de cheminement du véhicule.
|
| 4 | Partagez le parcours avec le consommateur. | Fleet Engine met à la disposition des utilisateurs les détails du trajet et la position des véhicules SDK grand public, qui utilise un écouteur pour recevoir les mises à jour des trajets et les afficher dans l'application grand public. Fleet Engine met automatiquement à jour l'heure d'arrivée prévue, le temps restant distance, itinéraires et points de cheminement restants du véhicule. Voir Pour en savoir plus, consultez Partager des trajets pour des trajets à la demande. |
| 5 | Terminez le trajet. | Une fois que le véhicule a atteint le point de cheminement de destination du trajet et
indique un trajet réussi, votre système définit le
De TripStatus à COMPLETE dans Fleet Engine. Conserver dans
à l'esprit que, comme pour les véhicules, les entités de trajet restent actives dans Fleet Engine.
pendant 7 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.
