Ce document explique comment créer un trajet en aller-retour, définir les champs appropriés et l'attribuer à un véhicule pour qu'il soit effectué. Nous partons du principe que vous avez configuré Fleet Engine, que vous avez créé des véhicules, que vous disposez d'une application conducteur fonctionnelle et, éventuellement, d'une application client. Vous devez également connaître les différents scénarios de trajets disponibles pour les trajets à la demande. Pour en savoir plus, consultez les guides associés suivants:
- Configurer Fleet Engine
- Créer un véhicule
- Scénarios de trajets dans la présentation des trajets à la demande
Principes de base de la création de voyages
Cette section décrit les détails de la requête nécessaires pour créer un trajet dans Fleet Engine. Vous envoyez une requête de création à l'aide de gRPC ou de REST.
Champs de trajet
Utilisez les champs suivants pour créer un trajet dans Fleet Engine. Vous pouvez utiliser différents champs pour les différents types de trajets: à destination unique ou multiple, en série ou en pool partagé. Vous pouvez fournir les champs facultatifs lorsque vous créez le trajet ou les définir plus tard lorsque vous le mettez à jour.
| Nom | Obligatoire ? | Description |
|---|---|---|
| parent | Oui | Chaîne incluant l'ID de projet. Cet ID doit être identique à celui utilisé pour l'ensemble de l'intégration de Fleet Engine, avec les mêmes rôles de compte de service. |
| trip_id | Oui | Chaîne que vous créez pour identifier de manière unique ce trajet. Les ID de trajet sont soumis à certaines restrictions, comme indiqué dans la documentation. |
| trip_type | Oui | Définissez TripType sur les valeurs suivantes pour le type de trajet que vous créez :
|
| pickup_point | Oui | Point de départ du trajet. |
| Destinations intermédiaires | Oui | Trajets multidestinations uniquement: liste des destinations intermédiaires que le conducteur visite entre le ramassage et le dépôt. Comme pour |
| vehicle_waypoints | Oui | Trajets en covoiturage uniquement: ce champ permet d'intercaler les points de cheminement de plusieurs trajets.
Il contient tous les points de repère restants pour le véhicule attribué, ainsi que les points de ramassage et de dépôt pour ce trajet. Vous pouvez définir ce champ en appelant |
| number_of_passengers | Non | Nombre de passagers du trajet. |
| dropoff_point | Non | Destination du trajet. |
| vehicle_id | Non | Identifiant du véhicule attribué au trajet. |
Exemple: créer un trajet en aller-retour
L'exemple suivant montre comment créer un trajet en aller-retour et l'attribuer à un véhicule. Dans ce scénario, la création de trajet est identique à celle d'un trajet à destination unique. Vous ne créerez un autre trajet et ne l'attribuerez à un véhicule qu'ultérieurement, si celui-ci est déjà actif.
// A vehicle with ID 'my-vehicle' is already created and it is assigned to a trip with ID 'current-trip'.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String VEHICLE_ID =" my-vehicle";
static final String TRIP_ID = "back-to-back-trip");
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
Trip trip = Trip.newBuilder()
.setTripType(TripType.EXCLUSIVE)
.setPickupPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)))
.setDropoffPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.1275).setLongitude(106.6537)))
.setVehicleId(VEHICLE_ID)
.build();
// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
.setParent(parent)
.setTripId(TRIP_ID)
.setTrip(trip)
.build();
// Error handling.
try {
// Fleet Engine automatically assigns a 'waypoints' list to the trip containing
// the vehicle's current trip waypoints.
Trip createdTrip =
tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
Mettre à jour les trajets consécutifs
Lorsque vous attribuez un véhicule pour un trajet consécutif, vous attribuez un trajet à un véhicule même s'il en a déjà été attribué un.
Tout trajet créé dans Fleet Engine doit être attribué à un véhicule pour que Fleet Engine puisse calculer l'heure d'arrivée estimée et suivre le trajet. Vous pouvez le faire lors de la création du trajet ou plus tard lorsque vous le mettez à jour.
Une fois que vous avez attribué le trajet à un véhicule, Fleet Engine ajoute automatiquement les points de cheminement associés aux trajets consécutifs dans le champ des points de cheminement du véhicule. Le champ remainingWaypoints d'un trajet contient la liste de tous les points de cheminement, y compris ceux d'autres trajets qui seront visités avant la dépose du trajet.
Prenons l'exemple de deux trajets consécutifs: le trajet A et le trajet B. Le véhicule a pris en charge le client pour le trajet A. Alors qu'il se dirige vers le lieu de dépose, le conducteur reçoit une demande de prise en charge d'un autre client pour le prochain trajet, le trajet B.
- L'appel de
getVehicle()renvoie desremainingWaypointscontenant les éléments suivants:
A Récupération → B Récupération → B Récupération. getTrip()ou le rappelonTripRemainingWaypointsUpdatedpour Trip A renvoie desremainingWaypointscontenant:
Un dépose.getTrip()ou le rappelonTripRemainingWaypointsUpdatedpour le trajet B renvoie desremainingWaypointscontenant:
A Dépose → B Retrait → et B Dépose.