Che cos'è un'attività pianificata?
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
La documentazione in questa sezione mostra come creare e utilizzare le attività pianificate utilizzando il servizio Attività pianificate di Google Maps Mobility. Si presume familiarità con quanto segue:
La risorsa Task che utilizzerai è disponibile sia in gRPC sia in
REST.
In Fleet Engine per le attività pianificate, un'attività rappresenta un'attività del conducente che adempie a una spedizione o a un servizio pianificato per i tuoi consumatori. Assegni le attività alle fermate del veicolo in cui devono essere completate e il veicolo si reca a queste fermate.
Un'attività ha due possibili stati, OPEN o CLOSED. Questi stati indicano se l'attività è attiva o meno nel sistema. Man mano che il viaggio di un'attività attiva si evolve, lo segnali a Fleet Engine aggiornando la fermata del veicolo associata all'attività, che può essere IN VIAGGIO o ARRIVATO. Una volta che il conducente completa le attività e lascia la fermata, rimuovi la fermata dall'elenco delle fermate sul veicolo. Per saperne di più sulle attività e sulla loro relazione con fermate e veicoli, consulta Attività pianificate in Elementi essenziali di Fleet Engine .
Ciclo di vita di un'attività
Per monitorare ogni attività in Fleet Engine, devi prima creare un'entità Task. Per riferimento, consulta gRCP o REST.
La tabella seguente descrive un esempio di flusso end-to-end di un'attività creata nel tuo sistema e le relative fasi del ciclo di vita in Fleet Engine. Si presume che tu abbia configurato Fleet Engine e che tu abbia un veicolo per l'attività, con gli aggiornamenti della posizione attivati nell'app del conducente. Consulta SDK Driver: attività pianificate.
| 1 |
Crea attività. |
All'inizio del ciclo di lavoro, l'amministratore del servizio o del gestore degli ordini in primo luogo crea un manifest per i servizi o le attività di importazione. Da qui, il sistema crea le entità di attività utilizzando
CreateTrip con i campi obbligatori, come il tipo di attività e
la posizione. A questo punto può anche fornire altre configurazioni, come la finestra temporale di destinazione, l'avanzamento della condivisione delle attività e gli attributi personalizzati. Consulta
Creare attività di spedizione
e le guide correlate. |
| 2 |
Pianificare le attività. |
Quando pianifichi un'attività per la consegna, emetti una richiesta di aggiornamento del veicolo di consegna, che aggiorna l'entità del veicolo con un elenco di fermate da percorrere. Assegni a ogni fermata un elenco di attività da completare in quella fermata.
Vedi Aggiornare le attività dei veicoli di consegna.
|
| 3 |
Aggiornare l'avanzamento dell'attività. |
Una volta assegnata l'attività a una fermata di consegna e attivata in Fleet Engine, il sistema informa Fleet Engine sull'avanzamento del veicolo mentre si avvicina, arriva e completa la fermata. Con queste informazioni, Fleet
Engine può eseguire al meglio gli aggiornamenti di percorso e stato durante il viaggio nonché
nel corso della giornata per il veicolo. Vedi
Aggiornare lo stato della fermata del veicolo.
|
| 4 |
Condividere i percorsi. |
Contemporaneamente all'avvio della navigazione attiva del veicolo per il giorno della consegna, puoi condividere le informazioni sul viaggio con gli stakeholder interessati. Fleet Engine rende disponibili sia i dettagli della richiesta sia la posizione del veicolo
per gli stakeholder interessati nei seguenti modi:
- Informazioni sulla spedizione per i consumatori . Con questa
soluzione, i consumatori possono vedere lo stato del loro pacco insieme alle
informazioni sulla posizione del veicolo che consenti loro di visualizzare.
Vedi
Condivisione con i consumatori per le attività pianificate.
- Informazioni sullo stato del parco risorse per gli amministratori. Con
questa soluzione, gli amministratori del parco veicoli possono visualizzare le posizioni
dei veicoli di consegna e le relative fermate nei tuoi parchi veicoli quasi in tempo reale.
Se il percorso di un veicolo è noto, il componente della visualizzazione mappa anima il veicolo mentre si muove lungo il percorso previsto.
Consulta la libreria JavaScript Fleet Tracking.
|
| 5 |
Finalizza l'attività. |
Puoi finalizzare le attività di spedizione in Fleet Engine nei seguenti modi:
- Chiudi l'attività: la chiusura di un'attività di spedizione indica che l'attività
non è più attiva.
- Impostare l'esito dell'attività: una volta chiusa un'attività, indica se l'attività è riuscita o meno per indicare se l'invio
è avvenuto o meno. Si tratta di un aspetto importante per finalizzare un'attività al fine di mostrare il risultato della pubblicazione nell'esperienza del consumatore e garantire la fatturazione corretta del servizio Fleet Engine.
Tieni presente che, come i veicoli di consegna, le entità delle attività rimangono attive in Fleet Engine per 7 giorni, indipendentemente dallo stato, dopodiché vengono rimosse.
Vedi Finalizzare le attività.
|
Flusso della sequenza di attività
Il seguente diagramma mostra un flusso dettagliato del ciclo di vita di un'attività.
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-31 UTC.
[null,null,["Ultimo aggiornamento 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)"]]
