O que é uma viagem sob demanda?

A documentação nesta seção mostra como criar e trabalhar com viagens usando o serviço de viagens sob demanda do Google Maps Mobility. Ele pressupõe familiaridade com o seguinte:

O TripService que você vai usar está disponível para gRPC e REST (links em inglês). Para simplificar, as referências de campo seguem a convenção gRPC.

No Fleet Engine para serviços sob demanda, uma viagem é um tipo de jornada que modela o atendimento de um pedido de entrega de comida ou viagem dos consumidores. Uma viagem tem um status que você informa ao Fleet Engine à medida que a jornada evolui, como NEW, ENROUTE_TO_PICKUP, entre outros. O status da viagem corresponde ao waypoints atribuídos ao veículo, e o Fleet Engine modifica esses veículos waypoints a cada atualização de viagem. Consulte Viagens sob demanda em Frota Engine Essentials para saber mais sobre viagens e a relação delas com os veículos.

Vida útil de uma viagem

Para rastrear cada viagem no Fleet Engine, primeiro você precisa criar um Trip. com uma entidade conhecida. Consulte gRPC ou REST para referência.

A tabela a seguir descreve um exemplo de fluxo completo de uma viagem criada em o sistema e os estágios do ciclo de vida no Fleet Engine. Ele pressupõe que você configurou Fleet Engine e ter um veículo para atribuir à viagem, com atualizações de localização no app do motorista. Consulte SDK do Driver: viagens sob demanda.

1 Receber solicitação de agendamento. Antes do início de uma viagem do Fleet Engine, seu sistema de reservas recebe um solicitação de uma viagem ou entrega de um consumidor pelo app ou por outro de reserva. Em seguida, o sistema cria a entidade da viagem usando CreateTrip com campos obrigatórios, como o local de retirada. Ele também pode definir outros campos neste ponto, como passageiros e local de desembarque ou aguardar até que ele atribua um veículo. Consulte Criar uma viagem com um só destino.
2 Atribua o veículo.

Você pode atribuir veículos a viagens diretamente no sistema e relatar a atribuição para o Fleet Engine. Também é possível usar Pesquisar veículo serviço para pesquisar veículos, filtrando por viagem e veículo atributos para encontrar o melhor veículo para completar a jornada. Qualquer loja on-line veículo dentro do raio de pesquisa informa a proximidade dele por meio de atualizações de localização fornecidas pelo SDK do Driver.

Depois que SearchVehicle retornar um veículo que você corresponde a uma viagem, seu o sistema chama o endpoint UpdateTrip para informar o ID do veículo que você atribuiu à viagem NEW.

3 Atualizar viagem. Depois que o motorista aceita a viagem e começa a navegar até a local de retirada, o sistema atualizará o status da viagem a partir de NEW para ENROUTE_TO_PICKUP. Você continua a pesquisar o veículo local ao longo da jornada, seja por uma conexão direta do o app ao back-end ou sondando o Fleet Engine, que recebe uma fluxo contínuo de atualizações de localização de veículos do SDK do motorista. Seu sistema informa cada marco da jornada ao Fleet Engine, que atualiza a lista de waypoints do veículo.
4 Compartilhe a jornada com o consumidor. O Fleet Engine disponibiliza os detalhes da viagem e a localização do veículo para o SDK do consumidor, que usa um listener para receber atualizações de viagem e exibi-las no aplicativo para o consumidor. O Fleet Engine atualiza automaticamente o HEC restante distância, trajetos e waypoints restantes do veículo. Consulte Compartilhar jornadas de viagens sob demanda para mais informações.
5 Concluir a viagem. Quando o veículo chegar ao waypoint de destino da viagem e seu motorista indica uma viagem bem-sucedida, o sistema define TripStatus para COMPLETE no Fleet Engine. Manter em É importante lembrar que, assim como veículos, as entidades de viagem permanecem ativas no Fleet Engine. por 7 dias, independentemente do status, depois de serem removidos.

Fluxo da sequência da viagem

O diagrama a seguir mostra uma visualização mais detalhada desse fluxo.

TripSequenceDiagram

A seguir