Qu'est-ce qu'une tâche planifiée ?
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La documentation de cette section explique comment créer et utiliser des tâches planifiées à l'aide du service de tâches planifiées Google Maps Mobility. Il suppose que vous connaissez les éléments suivants:
La ressource Task que vous utiliserez est disponible à la fois en gRPC et en REST.
Dans Fleet Engine pour les tâches planifiées, une tâche représente une activité de conducteur qui effectue une livraison ou un service planifié pour vos clients. Vous attribuez des tâches aux arrêts du véhicule où elles doivent être effectuées, et le véhicule se rend à ces arrêts.
Une tâche peut avoir deux états : OPEN ou CLOSED. Ces états indiquent si la tâche est active ou non dans le système. À mesure que le trajet évolue pour une tâche active, vous en informez Fleet Engine en mettant à jour l'arrêt du véhicule associé à la tâche, qui est soit ENROUTE, soit ARRIVÉ. Une fois que le conducteur a terminé ses tâches et quitté l'arrêt, vous supprimez l'arrêt de la liste des arrêts du véhicule. Pour en savoir plus sur les tâches et leur relation avec les arrêts et les véhicules, consultez la section Tâches planifiées dans Principes essentiels de Fleet Engine .
Cycle de vie d'une tâche
Pour suivre chaque tâche dans Fleet Engine, vous devez d'abord créer une entité Task. Pour en savoir plus, consultez gRCP ou REST.
Le tableau suivant décrit un exemple de flux de bout en bout d'une tâche créée dans votre système et les étapes de son cycle de vie dans Fleet Engine. Il suppose que vous avez configuré Fleet Engine et que vous disposez d'un véhicule pour la tâche, avec les mises à jour de position activées dans l'application du conducteur. Consultez SDK Driver: tâches planifiées.
| 1 |
Créez des tâches. |
Au début du cycle de travail, le répartiteur ou l'administrateur du service crée d'abord un fichier manifeste pour les tâches ou services de diffusion. À partir de là, votre système crée ensuite les entités de tâche à l'aide de CreateTrip avec des champs obligatoires, tels que le type de tâche et l'emplacement. Il peut également fournir d'autres configurations à ce stade, telles que la période cible, le partage de la progression de la tâche et les attributs personnalisés. Consultez Créer des tâches d'expédition et les guides associés. |
| 2 |
Planifier des tâches |
Lorsque vous planifiez une tâche de livraison, vous envoyez une requête de mise à jour du véhicule de livraison, qui met ensuite à jour l'entité du véhicule avec une liste des arrêts à effectuer. Vous attribuez à chaque arrêt une liste de tâches à effectuer.
Consultez Mettre à jour les tâches du véhicule de livraison.
|
| 3 |
Mettez à jour la progression de la tâche. |
Une fois la tâche attribuée à un arrêt de livraison et active dans Fleet Engine, votre système informe Fleet Engine de la progression du véhicule à mesure qu'il s'approche, arrive et termine l'arrêt. Grâce à ces informations, Fleet Engine peut mieux calculer les itinéraires et mettre à jour l'état du véhicule tout au long du trajet et tout au long de la journée. Consultez la section Mettre à jour l'état d'arrêt du véhicule.
|
| 4 |
Partager des trajets |
Lorsque le véhicule commence la navigation active pour le jour de la livraison, vous pouvez partager des informations sur le trajet avec les personnes concernées. Fleet Engine met à la disposition des personnes concernées les informations sur les tâches et la position des véhicules de différentes manières :
- Informations de livraison pour les consommateurs Grâce à cette solution, les consommateurs peuvent voir l'état de leur colis, ainsi que les informations de localisation du véhicule que vous leur autorisez à consulter.
Consultez la section Partage avec les consommateurs pour les tâches planifiées.
- Informations sur l'état de la flotte pour les administrateurs Grâce à cette solution, les administrateurs de flotte peuvent visualiser la position des véhicules de livraison et leurs arrêts dans vos flottes en quasi temps réel.
Si l'itinéraire d'un véhicule est connu, le composant de vue de la carte anime ce véhicule à mesure qu'il se déplace sur son chemin prévu.
Consultez la bibliothèque JavaScript de suivi de flotte.
|
| 5 |
Finalisez la tâche. |
Vous pouvez finaliser les tâches d'expédition dans le moteur de flotte de différentes manières :
- Fermer la tâche: fermer une tâche d'expédition indique qu'elle n'est plus active.
- Définir le résultat de la tâche: une fois une tâche fermée, indiquez si elle a réussi ou échoué pour indiquer si la diffusion a eu lieu ou non. Il s'agit d'une étape importante pour finaliser une tâche afin d'afficher le résultat de la diffusion dans l'expérience client et de garantir une facturation correcte pour le service Fleet Engine.
N'oubliez pas que, comme les véhicules de livraison, les entités de tâche restent actives dans Fleet Engine pendant sept jours, quel que soit leur état, après quoi elles sont supprimées.
Consultez Finaliser les tâches.
|
Flux de séquence de tâches
Le diagramme suivant présente le flux détaillé du cycle de vie d'une tâche.
Étape suivante
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 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)"]]
