Neste documento, descrevemos como criar uma viagem consecutiva, definir os campos corretos e atribuí-la a um veículo. Ele pressupõe que você configurou o Fleet Engine, criou veículos, tem um app de motorista em funcionamento e, opcionalmente, um aplicativo para o consumidor. Você também precisa conhecer os vários cenários de viagem disponíveis para viagens on demand. Consulte os seguintes guias relacionados para isso:
- Configurar o Fleet Engine
- Criar um veículo
- Cenários de viagem na visão geral de viagens on demand
Noções básicas sobre a criação de viagens
Nesta seção, descrevemos os detalhes da solicitação necessários para criar uma viagem no Fleet Engine. Você emite uma solicitação de criação usando gRPC e REST.
Campos de viagem
Use os campos a seguir para criar uma viagem no Fleet Engine. É possível usar campos diferentes para os diferentes tipos de viagens: com um ou vários destinos, consecutivas ou compartilhadas. É possível fornecer os campos opcionais ao criar a viagem ou defini-los mais tarde, ao atualizar a viagem.
| Nome | Obrigatório? | Descrição |
|---|---|---|
| parent | Sim | Uma string que inclui o ID do projeto. Esse ID precisa ser o mesmo usado em toda a integração do Fleet Engine, com os mesmos papéis de conta de serviço. |
| trip_id | Sim | Uma string criada por você que identifica essa viagem de forma exclusiva. Os IDs de viagem têm certas restrições, conforme indicado na referência. |
| trip_type | Sim | Defina o TripType com os seguintes valores para o tipo de viagem que você está criando:
|
| pickup_point | Sim | O ponto de origem da viagem. |
| Destinos intermediários | Sim | Somente viagens com vários destinos: a lista de destinos intermediários que o motorista visita entre
a retirada e a entrega. Assim como em |
| vehicle_waypoints | Sim | Somente viagens compartilhadas: esse campo permite intercalar os pontos de referência de várias viagens.
Ele contém todos os pontos de passagem restantes para o veículo atribuído, bem como os pontos de passagem de retirada e entrega para essa viagem. Para definir esse campo,
chame |
| number_of_passengers | Não | O número de passageiros na viagem. |
| dropoff_point | Não | O destino da viagem. |
| vehicle_id | Não | O ID do veículo atribuído à viagem. |
Exemplo: criar uma viagem consecutiva
Veja a seguir como criar uma viagem consecutiva e atribuí-la a um veículo. Nesse cenário, a criação de viagens é igual à de uma viagem com um único destino. Só mais tarde você cria outra viagem e a atribui a um veículo com uma viagem já ativa.
// 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;
}
Atualizar viagens consecutivas
Ao atribuir um veículo para uma viagem consecutiva, você atribui uma viagem a um veículo, mesmo que ele já tenha uma atribuída.
Qualquer viagem criada no Fleet Engine precisa ser atribuída a um veículo para que o Fleet Engine calcule os ETAs da viagem e a rastreie. Isso pode ser feito durante a criação da viagem ou depois, ao atualizá-la.
Depois que você atribui a viagem a um veículo, o Fleet Engine adiciona automaticamente os
waypoints associados às viagens consecutivas ao campo de waypoints
do veículo. O campo remainingWaypoints de uma viagem contém uma lista de todos os
waypoints, incluindo aqueles de outras viagens que serão visitados antes
do desembarque da viagem.
Por exemplo, considere duas viagens consecutivas: Viagem A e Viagem B. O veículo pegou o consumidor para a Viagem A e, enquanto está a caminho do local de entrega, o motorista recebe uma solicitação para pegar outro consumidor para a próxima viagem, a Viagem B.
- Chamar
getVehicle()retornaremainingWaypointsque contém:
A Desembarque → B Embarque → B Desembarque. - O callback
getTrip()ouonTripRemainingWaypointsUpdatedpara a Viagem A retornaremainingWaypoints, que contém:
Um desembarque. - O callback
getTrip()ouonTripRemainingWaypointsUpdatedda Viagem B retornaremainingWaypoints, que contém:
Desembarque de A → Embarque de B → e Desembarque de B.