O que é uma tarefa agendada?
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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.
A seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-31 UTC.
[null,null,["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eThis documentation outlines how to create and manage scheduled tasks, representing driver activities, within the Google Maps Mobility scheduled tasks service.\u003c/p\u003e\n"],["\u003cp\u003eTasks, which can be either OPEN or CLOSED, are assigned to vehicle stops, and their progress is updated as the vehicle travels to and completes these stops.\u003c/p\u003e\n"],["\u003cp\u003eThe lifecycle of a task involves creation, scheduling by assigning to a vehicle stop, updating progress, sharing journey details with stakeholders, and finalization by closing and setting the outcome.\u003c/p\u003e\n"],["\u003cp\u003eFleet Engine provides tools for consumers to track shipment status and for administrators to monitor fleet locations and progress in near real-time.\u003c/p\u003e\n"],["\u003cp\u003eTo successfully use this service, prior familiarity with Fleet Engine, vehicle basics for on-demand services, and task basics for scheduled tasks is assumed.\u003c/p\u003e\n"]]],[],null,["# What is a scheduled task?\n\nThe documentation in this section shows how to create and work with scheduled\ntasks using the Google Maps Mobility scheduled tasks service. It assumes\nfamiliarity with the following:\n\n- **Fleet Engine** : You should be familiar with Fleet Engine implementation details, request mechanisms, and security. For that, see [What is the Fleet\n Engine service?](/maps/documentation/mobility/fleet-engine/essentials) and the security topics in [Set up Fleet Engine](/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet).\n- **Vehicles basics** for on-demand services. See [Introduction to vehicles](/maps/documentation/mobility/fleet-engine/essentials/vehicles-intro).\n- **Task basics** for scheduled task services. See [Scheduled tasks](/maps/documentation/mobility/fleet-engine/essentials/tasks-intro)\n\nThe `Task` resource that you'll use is available in both [gRPC](/maps/documentation/mobility/fleet-engine/reference/tasks/rpc/maps.fleetengine.delivery.v1#task) and\n[REST](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.tasks).\n\nIn Fleet Engine for scheduled tasks, a task represents a driver activity that\nfulfills a scheduled shipment or service for your consumers. You assign tasks to\nvehicle stop locations where they are to be completed, and the vehicle travels\nto those stops.\n\nA task has two possible states, `OPEN` or `CLOSED`. These states indicate\nwhether the task is active or not in the system. As the journey evolves for an\nactive task, you report this to Fleet Engine by updating the vehicle stop\nassociated with the task, which is either ENROUTE or ARRIVED. Once the driver\ncompletes tasks and leaves the stop, you remove the stop from the list of stops\non the vehicle. For more about\ntasks and their relationship to stops and vehicles, see\n[Scheduled tasks](/maps/documentation/mobility/fleet-engine/essentials/tasks-intro#basic_task_fields) in **Fleet Engine essentials** .\n\nLife of a task\n--------------\n\nIn order to track each task in Fleet Engine, you must first create a `Task`\nentity. See either [gRCP](/maps/documentation/mobility/fleet-engine/reference/tasks/rpc/maps.fleetengine.delivery.v1#task) or [REST](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.tasks) for reference.\n\nThe following table describes an example end-to-end flow of a task created in\nyour system and its lifecycle stages in Fleet Engine. It assumes you have set up\nFleet Engine and have a vehicle for the task, with location updates\nenabled in the driver app. See [Driver SDK: Scheduled tasks](/maps/documentation/mobility/driver-sdk/scheduled).\n\n|---|-------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Create tasks.** | At the beginning of the work cycle, the dispatcher or service administrator first creates a manifest for delivery tasks or services. From there, your system then creates the task entities using `CreateTrip` with required fields, such as the type of task and the location. It can also supply other configurations at this point, such as target time window, sharing task progress, and custom attributes. See [Create shipment tasks](/maps/documentation/mobility/fleet-engine/journeys/tasks/create-shipment-tasks) and the related guides. |\n| 2 | **Schedule tasks.** | When you schedule a task for delivery, you issue a delivery vehicle update request, which then updates the vehicle entity with a list of stops to travel. You assign each stop a list of tasks to be completed at the stop. See [Update delivery vehicle tasks](/maps/documentation/mobility/fleet-engine/journeys/tasks/update-tasks). |\n| 3 | **Update the task progress.** | Once the task is assigned to a delivery stop and active in Fleet Engine, your system notifies Fleet Engine about the vehicle progress as it approaches, arrives at, and completes the stop. With this information, Fleet Engine can best perform routing and status updates along the journey as well as throughout the day for the vehicle. See [Update vehicle stop status](/maps/documentation/mobility/fleet-engine/journeys/tasks/update-stops). |\n| 4 | **Share journeys.** | At the same time that the vehicle begins active navigation for the delivery day, you can share journey information with interested stakeholders. Fleet Engine makes both task details and vehicle location available to interested stakeholders in the following ways: - **Shipment information for consumers** . With this solution, consumers can see the status of their package along with the vehicle location information you permit them to view. See [Consumer sharing for scheduled tasks](/maps/documentation/mobility/journey-sharing/scheduled). - **Fleet status information for administrators** . With this solution, fleet administrators can visualize the locations of delivery vehicles and their stops in your fleets in near real time. If the route for a vehicle is known, the map view component animates that vehicle as it moves along its predicted path. See the [JavaScript Fleet Tracking library](/maps/documentation/mobility/operations/fleet-tracking). |\n| 5 | **Finalize the task.** | You finalize shipment tasks in Fleet engine in the following ways: - **Close the task**: Closing a shipment task indicates that that task is no longer active. - **Set the task outcome**: Once a task is closed, you indicate either a successful or failed task to indicate if the delivery took place or not. This is an important part of finalizing a task to show the delivery outcome in your consumer experience and to ensure correct billing for the Fleet Engine service. Keep in mind that, like delivery vehicles, task entities remain active within Fleet Engine for 7 days regardless of state, at which point they are removed. See [Finalize tasks](/maps/documentation/mobility/fleet-engine/journeys/tasks/finalize-tasks). |\n\nTask sequence flow\n------------------\n\nThe following diagram shows a detailed flow of a task lifecycle.\n\nWhat's next\n-----------\n\n- [Create shipment tasks](/maps/documentation/mobility/fleet-engine/journeys/tasks/create-shipment-tasks)"]]
