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:
- Fleet Engine: você precisa conhecer a implementação do Fleet Engine. detalhes, mecanismos de solicitação e segurança. Para isso, confira O que é a frota Engine? e os tópicos de segurança em Configurar o Fleet Engine.
- Conceitos básicos sobre veículos para serviços sob demanda. Consulte Introdução a veículos.
- Noções básicas de viagem para serviços sob demanda. Consulte a seção Viagens sob demanda.
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 na 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 a 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 pessoa 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 |
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 alcançar o 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.