Cómo crear un viaje de un solo destino

En este documento, se describe cómo crear un viaje de un solo destino, establecer los campos correctos y asignarlo a un vehículo para que lo realice. Se supone que configuraste Fleet Engine, creaste vehículos, tienes una app para el conductor que funciona y, de manera opcional, una app para el consumidor. Consulta las siguientes guías relacionadas para obtener más información:

Conceptos básicos de la creación de viajes

En esta sección, se describen los detalles de la solicitud necesarios para crear un viaje en Fleet Engine. Puedes emitir una solicitud de creación con gRPC y REST.

  • CreateTrip() método: gRPC o REST
  • Mensaje CreateTripRequest: gRPC solamente

Campos de viaje

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

Campos de viaje
Nombre ¿Obligatorio? Descripción
parent Sí 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í Una cadena que creas y que identifica de forma única este viaje. Los IDs de viaje tienen ciertas restricciones, como se indica en la referencia.
trip_type Sí Establece el TripType en los siguientes valores para el tipo de viaje que estás creando:
  • Un solo destino: Establece en SHARED o EXCLUSIVE.
  • Varios destinos: Establece en EXCLUSIVE.
  • Consecutivo: Establece en EXCLUSIVE.
  • Viaje compartido: Establece en SHARED.
pickup_point Sí El punto de origen del viaje.
Destinos intermedios Sí

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

Solo viajes compartidos: Este campo admite intercalar los puntos de ruta de varios viajes. Contiene todos los puntos de ruta restantes para el vehículo asignado, así como los puntos de ruta de partida y destino para este viaje. Puedes configurar este campo llamando a CreateTrip o UpdateTrip. También puedes actualizar los puntos de ruta del vehículo a través del campo waypoints con una llamada a UpdateVehicle. El servicio no muestra esta información en las llamadas 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 El ID del vehículo asignado al viaje.

Ejemplo: Viaje de un solo destino

En el siguiente ejemplo, se muestra cómo crear un viaje al centro comercial Grand Indonesia East. El viaje incluye dos pasajeros, es exclusivo y su estado es NEW. El provider_id del viaje debe ser el mismo que el ID del proyecto de Google Cloud. En el ejemplo, se muestra un proyecto de Google Cloud con el ID del proyecto my-rideshare-co-gcp-project. Este proyecto también debe incluir una cuenta de servicio para llamar a Fleet Engine. Consulta Roles de cuenta de servicio para obtener más detalles.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

// Trip initial settings.
String parent = "providers/" + PROJECT_ID;

Trip trip = Trip.newBuilder()
    .setTripType(TripType.EXCLUSIVE) // Use TripType.SHARED for carpooling.
    .setPickupPoint(                 // Grand Indonesia East Mall.
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.195139).setLongitude(106.820826)))
    .setNumberOfPassengers(2)
    // Provide the drop-off point if available.
    .setDropoffPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.1275).setLongitude(106.6537)))
    .build();

// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
    .setParent(parent)
    .setTripId("trip-8241890")  // Trip ID assigned by the provider.
    .setTrip(trip)              // The initial state is NEW.
    .build();

// Error handling.
try {
  Trip createdTrip = tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

¿Qué sigue?