Crear viajes seguidos

En este documento, se describe cómo crear un viaje consecutivo, configurar los campos correctos y asignarlo a un vehículo para que se lleve a cabo. Se supone que configuraste Fleet Engine, creaste vehículos, tienes una app para conductores en funcionamiento y, de forma opcional, una app para consumidores. También debes estar familiarizado con las diversas situaciones de viajes disponibles para los viajes a pedido. Consulta las siguientes guías relacionadas para lo siguiente:

Conceptos básicos sobre la creación de viajes

En esta sección, se describen los detalles de la solicitud necesarios para crear un viaje en Flet Engine. Emites una solicitud de creación con gRPC o REST.

  • Método CreateTrip(): gRPC o REST
  • Mensaje CreateTripRequest: Solo gRPC

Campos de viaje

Usa los siguientes campos para crear un viaje en Fleet Engine. Puedes usar diferentes campos para los diferentes tipos de viajes: con un destino o varios, consecutivos o compartidos. Puedes proporcionar los campos opcionales cuando creas el viaje o puedes configurarlos más adelante cuando actualices el viaje.

Campos de viaje
Nombre ¿Obligatorio? Descripción
parent Sí Es una cadena que incluye el ID del proyecto. Este ID debe ser el mismo que se usa en toda la integración de Fleet Engine, con los mismos roles de cuenta de servicio.
trip_id Sí Es una cadena que creas para identificar este viaje de forma exclusiva. Los IDs de viaje tienen ciertas restricciones, como se indica en la referencia.
trip_type Sí Establece TripType en los siguientes valores para el tipo de viaje que estás creando:
  • Destino único: Establece SHARED o EXCLUSIVE.
  • Varios destinos: Configúralo en EXCLUSIVE.
  • Back-to-back: Configurado como EXCLUSIVE.
  • Agrupación compartida: Se establece en SHARED.
pickup_point Sí Es el punto de origen del viaje.
Destinos intermedios Sí

Solo viajes con varios destinos: Es la lista de destinos intermedios que visita el conductor entre el punto de partida y el destino. Al igual que con dropoff_point, este campo también se puede establecer más tarde llamando a UpdateTrip, pero, por definición, un viaje con varios destinos contiene destinos intermedios.
vehicle_waypoints Sí

Solo viajes de reducción compartida: Este campo admite la intercalación de los puntos de referencia desde varios viajes. Contiene todos los puntos de referencia restantes del vehículo asignado, así como los puntos de partida y destino de este viaje. Puedes establecer este campo llamando a CreateTrip o UpdateTrip. También puedes actualizar los puntos de referencia del vehículo a través del campo waypoints con una llamada a UpdateVehicle. El servicio no muestra esta información en las llamadas a GetTrip por motivos de privacidad.
number_of_passengers No La cantidad de pasajeros en el viaje.
dropoff_point No El destino del viaje.
vehicle_id No Es el ID del vehículo asignado al viaje.

Ejemplo: Crea un viaje consecutivo.

A continuación, se muestra cómo crear un viaje consecutivo y asignarlo a un vehículo. En este caso, la creación de un viaje es igual que para un viaje con un solo destino. Solo más tarde puedes crear otro viaje y asignarlo a un vehículo con un viaje que ya está activo.

// 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;
}

Actualiza los viajes consecutivos

Cuando asignas un vehículo para un viaje consecutivo, asignas un viaje a un vehículo incluso si ya se le asignó uno.

Cualquier viaje creado en Fleet Engine se debe asignar a un vehículo para que Fleet Engine calcule la hora de llegada estimada del viaje y realice un seguimiento de ella. Puedes hacerlo durante la creación del viaje o más adelante cuando lo actualices.

Después de asignar el viaje a un vehículo, Fleet Engine agrega automáticamente los puntos de referencia asociados con los viajes consecutivos al campo de puntos de referencia del vehículo. El campo remainingWaypoints de un viaje contiene una lista de todos los puntos de referencia, incluidos los de otros viajes que se visitarán antes de la bajada del viaje.

Por ejemplo, considera dos viajes consecutivos: Viaje A y Viaje B. El vehículo recogió al consumidor para el viaje A y, mientras se dirige al lugar de entrega, el conductor recibe una solicitud de recogida de otro consumidor para el viaje B que sigue.

  • Si llamas a getVehicle(), se muestra remainingWaypoints que contiene lo siguiente:
    A Destino → B Recogida → B Destino.
  • getTrip() o la devolución de llamada onTripRemainingWaypointsUpdated para Viaje A muestra remainingWaypoints que contiene lo siguiente:
    Una entrega.
  • getTrip() o la devolución de llamada onTripRemainingWaypointsUpdated para viaje B muestra un remainingWaypoints que contiene lo siguiente:
    A Destino → B Origen → y B Destino.

¿Qué sigue?