A documentação desta seção mostra como criar e trabalhar com tarefas programadas usando o serviço de tarefas programadas do Google Maps Mobility. Ele pressupõe familiaridade com o seguinte:
- Fleet Engine: você precisa conhecer os detalhes de implementação, os mecanismos de solicitação e a segurança do Fleet Engine. Para isso, consulte O que é o serviço do Fleet 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 sobre tarefas para serviços de tarefas programadas. Consulte Tarefas programadas.
O recurso Task que você usará está disponível em gRPC e REST (links em inglês).
No Fleet Engine para tarefas agendadas, uma tarefa representa uma atividade do motorista que atende a uma remessa ou serviço programado para seus consumidores. Você atribui tarefas aos locais de parada de veículos em que elas precisam ser concluídas e o veículo se desloca até essas paradas.
Uma tarefa tem dois estados possíveis, OPEN ou CLOSED. Esses estados indicam
se a tarefa está ativa ou não no sistema. À medida que a jornada evolui para uma
tarefa ativa, você informa isso ao Fleet Engine atualizando a parada de veículo
associada à tarefa, que é ENROUTE ou ARRIVED. Quando o motorista
conclui as tarefas e sai da parada, você remove a parada da lista de paradas
no veículo. Para saber mais sobre as tarefas e a relação delas com paradas e veículos, consulte Tarefas programadas em Noções básicas do Fleet Engine.
Vida útil de uma tarefa
Para rastrear cada tarefa no Fleet Engine, primeiro você precisa criar uma entidade
Task. Consulte gRCP ou REST para referência.
A tabela a seguir descreve um exemplo de fluxo completo de uma tarefa criada no seu sistema e os estágios do ciclo de vida dela no Fleet Engine. Ele pressupõe que você tenha configurado o Motor de frota e um veículo para a tarefa, com atualizações de localização ativadas no app do motorista. Consulte SDK do motorista: tarefas programadas.
| 1 | Criar tarefas. | No início do ciclo de trabalho, o agente
ou o administrador de serviços cria primeiro um manifesto para tarefas ou serviços de entrega. Em seguida, o sistema cria as entidades de tarefa usando
CreateTrip com campos obrigatórios, como o tipo de tarefa e
o local. Ele também pode fornecer outras configurações neste ponto,
como a janela de tempo de destino, o compartilhamento do progresso da tarefa e os atributos
personalizados. Consulte Criar tarefas de remessa e os guias relacionados. |
| 2 | Programar tarefas. | Ao programar uma tarefa para entrega, você emite uma solicitação de atualização do veículo de entrega, que atualiza a entidade do veículo com uma lista de paradas a serem percorridas. Você atribui a cada parada uma lista de tarefas a serem concluídas. Consulte Atualizar as tarefas do veículo de entrega. |
| 3 | Atualizar o progresso da tarefa. | Depois que a tarefa é atribuída a uma parada de entrega e ativa no Fleet Engine, o sistema notifica o Fleet Engine sobre o progresso do veículo à medida que ele se aproxima, chega e conclui a parada. Com essas informações, o Fleet Engine pode realizar melhor as atualizações de roteamento e status ao longo da jornada, bem como durante o dia para o veículo. Consulte Atualizar o status de parada do veículo. |
| 4 | Compartilhar viagens. | Ao mesmo tempo em que o veículo inicia a navegação ativa para o dia da entrega, você pode compartilhar informações da jornada com as partes interessadas. O Fleet Engine disponibiliza os detalhes da tarefa e a localização do veículo para as partes interessadas interessadas das seguintes maneiras:
|
| 5 | Finalize a tarefa. | É possível finalizar as tarefas de envio no Fleet Engine das seguintes maneiras:
|
Fluxo de sequência de tarefas
O diagrama a seguir mostra um fluxo detalhado do ciclo de vida de uma tarefa.
