O que é uma tarefa agendada?

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:

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

No Fleet Engine para tarefas programadas, uma tarefa representa uma atividade do motorista que cumpre um envio ou serviço programado para os consumidores. Você atribui tarefas aos locais de parada do veículo em que elas precisam ser concluídas, e o veículo viaja 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 é ENROUTE ou ARRIVED. Depois que 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 acompanhar cada tarefa no Fleet Engine, primeiro é necessário 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 Fleet Engine e tenha um veículo para a tarefa, com atualizações de local ativadas no app do motorista. Consulte SDK do Driver: tarefas programadas.

1 Criar tarefas. No início do ciclo de trabalho, o administrador do serviço ou despachante cria 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 atributos personalizados. Consulte Criar tarefas de envio 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 ativada 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 todo 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 da seguinte maneira:
  • Informações sobre o 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 de status da frota para administradores. Com essa solução, os administradores de frota podem visualizar os locais dos veículos de entrega e as paradas deles quase em tempo real. Se a rota de um veículo for conhecida, o componente de visualização do mapa vai animar esse veículo conforme ele se move ao longo do caminho previsto.
    Consulte a biblioteca JavaScript Fleet Tracking.
5 Finalize a tarefa. É possível finalizar as tarefas de envio no Fleet Engine das seguintes maneiras:
  • Fechar a tarefa: fechar uma tarefa de envio indica que ela não está mais ativa.
  • Definir o resultado da tarefa: quando uma tarefa é fechada, você indica se ela foi concluída ou não para indicar se a entrega foi realizada ou não. Essa é uma parte importante da finalização de uma tarefa para mostrar o resultado da entrega na experiência do consumidor e garantir o faturamento correto do serviço do Fleet Engine.
Assim como os veículos de entrega, as entidades de tarefas permanecem ativas no Fleet Engine por sete dias, independentemente do estado, e depois são removidas. 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