O que é uma tarefa agendada?

Na documentação, mostramos como criar e trabalhar com tarefas agendadas usando o serviço de tarefas programadas do Google Maps Mobility. Para isso, é preciso ter familiaridade com os seguintes itens:

O recurso Task que você usará está disponível no gRPC e em REST.

No Fleet Engine para tarefas programadas, uma tarefa representa uma atividade do motorista que atende uma remessa ou serviço programado aos consumidores. Você atribui tarefas aos locais de parada do veículo em que elas devem 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 do veículo associada à tarefa, que é ENTRADO ou CHEGADO. Depois que o motorista conclui as tarefas e sai da parada, ela é removida da lista de paradas do veículo. Para saber mais sobre as tarefas e a relação delas com paradas e veículos, consulte Tarefas programadas em Conceitos básicos do Fleet Engine .

O ciclo 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 sistema e os estágios do ciclo de vida dela no Fleet Engine. Ele pressupõe que você configurou o Fleet Engine e tem um veículo para a tarefa, com as atualizações de localização ativadas no app do motorista. Consulte SDK do Driver: tarefas agendadas.

1 Criar tarefas. No início do ciclo de trabalho, o agente ou administrador de serviço cria primeiro um manifesto para tarefas ou serviços de entrega. Depois, o sistema vai criar as entidades "Task" usando CreateTrip com os campos obrigatórios, como o tipo de tarefa e o local. Ela também pode fornecer outras configurações nesse momento, como a janela de tempo de destino, a visibilidade do compartilhamento da viagem e 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 para viajar. Você atribui a cada parada uma lista de tarefas a serem concluídas nela. Consulte Atualizar 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 rotas e status ao longo da viagem e ao longo do dia no veículo. Consulte Atualizar status de parada do veículo.
4 Compartilhe jornadas. Ao mesmo tempo em que o veículo inicia a navegação ativa no dia da entrega, é possível compartilhar informações da viagem com as partes interessadas interessadas. O Fleet Engine disponibiliza os detalhes de tarefas e a localização do veículo para as partes interessadas interessadas das seguintes maneiras:
  • Informações de envio para consumidores . Com essa solução, os consumidores podem conferir o status do pacote e as informações de localização do veículo que você permite que eles acessem.
    Consulte Compartilhamento do consumidor para tarefas programadas.
  • Informações sobre o status da frota para administradores. Com essa solução, os administradores de frotas podem visualizar os locais dos veículos de entrega e as paradas deles nas suas frotas quase em tempo real. Se o trajeto para um veículo for conhecido, o componente de visualização de mapa vai animar o veículo à medida que ele se move ao longo do caminho previsto.
    Consulte a biblioteca JavaScript Fleet Tracking.
5 Finalize a tarefa. Você finaliza as tarefas de frete no motor da frota das seguintes maneiras:
  • Fechar a tarefa: o fechamento de uma tarefa de remessa indica que ela não está mais ativa.
  • Defina o resultado da tarefa: quando uma tarefa for encerrada, indique uma tarefa bem-sucedida ou com falha para indicar se a entrega ocorreu ou não. Essa é uma parte importante da finalização de uma tarefa para mostrar o resultado da entrega no compartilhamento da jornada e garantir o faturamento correto do serviço do Fleet Engine.
Consulte Finalizar tarefas.

Fluxo de sequência de tarefas

O diagrama a seguir mostra um fluxo detalhado do ciclo de vida de uma tarefa.

TaskSequenceDiagram

A seguir