¿Qué es una tarea programada?
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En la documentación de esta sección, se muestra cómo crear tareas programadas y trabajar con ellas con el servicio de tareas programadas de Google Maps Mobility. Se da por sentado que conoces lo siguiente:
El recurso Task que usarás está disponible en gRPC y REST.
En Fleet Engine para tareas programadas, una tarea representa una actividad del conductor que completa un envío o servicio programado para tus consumidores. Asignas tareas a las ubicaciones de parada del vehículo en las que se deben completar, y el vehículo viaja a esas paradas.
Una tarea tiene dos estados posibles, OPEN o CLOSED. Estos estados indican si la tarea está activa o no en el sistema. A medida que evoluciona el viaje de una tarea activa, debes informar esto a Fleet Engine actualizando la parada del vehículo asociada con la tarea, que puede ser ENROUTE o ARRIVED. Una vez que el conductor complete las tareas y salga de la parada, quita la parada de la lista de paradas del vehículo. Para obtener más información sobre las tareas y su relación con las paradas y los vehículos, consulta Tareas programadas en Nociones básicas de Fleet Engine .
Ciclo de vida de una tarea
Para hacer un seguimiento de cada tarea en Fleet Engine, primero debes crear una entidad Task. Consulta gRCP o REST como referencia.
En la siguiente tabla, se describe un ejemplo de flujo de extremo a extremo de una tarea creada en tu sistema y sus etapas del ciclo de vida en Fleet Engine. Se supone que configuraste
Fleet Engine y tienes un vehículo para la tarea, con las actualizaciones de ubicación
habilitadas en la app del conductor. Consulta SDK de Driver: Tareas programadas.
| 1 |
Crear tareas |
Al comienzo del ciclo de trabajo, el despachador o el administrador del servicio primero crean un manifiesto para las tareas o los servicios de entrega. A partir de ahí, el sistema crea las entidades de tareas con CreateTrip con campos obligatorios, como el tipo de tarea y la ubicación. También puede proporcionar otros parámetros de configuración en este punto, como el período objetivo, el progreso de la tarea compartida y los atributos personalizados. Consulta Cómo crear tareas de envío y las guías relacionadas. |
| 2 |
Programa tareas. |
Cuando programas una tarea para la entrega, emites una solicitud de actualización del vehículo de entrega, que luego actualiza la entidad del vehículo con una lista de paradas para recorrer. A cada parada, le asignas una lista de tareas que se deben completar en ella.
Consulta Cómo actualizar las tareas de los vehículos de reparto.
|
| 3 |
Actualiza el progreso de la tarea. |
Una vez que la tarea se asigna a una parada de entrega y está activa en Fleet Engine, el sistema notifica a Fleet Engine sobre el progreso del vehículo a medida que se acerca, llega y completa la parada. Con esta información, Fleet Engine puede realizar mejor las actualizaciones de rutas y estado durante el viaje, así como durante el día para el vehículo. Consulta Cómo actualizar el estado de detención del vehículo.
|
| 4 |
Comparte viajes. |
Al mismo tiempo que el vehículo comienza la navegación activa para el día de la entrega, puedes compartir la información del viaje con las partes interesadas. Fleet Engine pone a disposición de las partes interesadas los detalles de las tareas y la ubicación del vehículo de las siguientes maneras:
- Información de envío para consumidores . Con esta
solución, los consumidores pueden ver el estado de su paquete junto con la
información de la ubicación del vehículo que les permites ver.
Consulta
Cómo compartir con los consumidores para tareas programadas.
- Información de estado de la flota para administradores. Con esta solución, los administradores de flotas pueden visualizar las ubicaciones de los vehículos de entrega y sus paradas en sus flotas casi en tiempo real.
Si se conoce la ruta de un vehículo, el componente de vista de mapa anima ese vehículo a medida que se mueve a lo largo de su ruta prevista.
Consulta la biblioteca de seguimiento de flotas de JavaScript.
|
| 5 |
Finaliza la tarea. |
Puedes finalizar las tareas de envío en el motor de flota de las siguientes maneras:
- Cerrar la tarea: Cerrar una tarea de envío indica que esa tarea ya no está activa.
- Establece el resultado de la tarea: Una vez que se cierra una tarea, debes indicar si se realizó correctamente o no para indicar si se realizó la publicación. Esta es una parte importante para finalizar una tarea y mostrar el resultado de la publicación en la experiencia del consumidor y garantizar la facturación correcta del servicio de Fleet Engine.
Ten en cuenta que, al igual que los vehículos de entrega, las entidades de tareas permanecen
activas en Fleet Engine durante 7 días, independientemente del estado, momento en el
que se quitan.
Consulta Finaliza tareas.
|
Flujo de secuencia de tareas
En el siguiente diagrama, se muestra un flujo detallado del ciclo de vida de una tarea.
¿Qué sigue?
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-07-27 (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,["The 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\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\nThe following diagram shows a detailed flow of a task lifecycle.\n\nWhat's next\n\n- [Create shipment tasks](/maps/documentation/mobility/fleet-engine/journeys/tasks/create-shipment-tasks)"]]
