Planlanmış görev nedir?
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu bölümdeki belgelerde, Google Haritalar Mobilite planlı görevler hizmeti kullanılarak planlı görevlerin nasıl oluşturulacağı ve bu görevlerle nasıl çalışılacağı gösterilmektedir. Aşağıdaki konularda bilgi sahibi olduğunuz varsayılır:
- Fleet Engine: Fleet Engine uygulama ayrıntıları, istek mekanizmaları ve güvenlik hakkında bilgi sahibi olmanız gerekir. Bunun için Fleet Engine hizmeti nedir? başlıklı makaleyi ve Fleet Engine'i ayarlama bölümündeki güvenlik konularını inceleyin.
- İsteğe bağlı hizmetler için Araçlarla ilgili temel bilgiler. Araçlara giriş başlıklı makaleyi inceleyin.
- Planlanmış görev hizmetleri için Görevler'le ilgili temel bilgiler Planlanmış görevler başlıklı makaleyi inceleyin.
Kullanacağınız Task kaynağı hem gRPC hem de REST'te kullanılabilir.
Planlanmış görevler için Fleet Engine'da görev, tüketicileriniz için planlanmış bir gönderimi veya hizmeti yerine getiren sürücü etkinliğini temsil eder. Görevleri, tamamlanmaları gereken araç durak konumlarına atarsınız ve araç bu duraklara gider.
Görevlerin iki olası durumu vardır: OPEN veya CLOSED. Bu durumlar, görevin sistemde etkin olup olmadığını gösterir. Etkin bir görev için yolculuk geliştikçe, görevle ilişkili araç durağını (YOLA ÇIKTI veya ULAŞILDI) güncelleyerek bunu Fleet Engine'a bildirirsiniz. Sürücü görevleri tamamlayıp duraktan ayrıldıktan sonra durak, araçtaki durak listesinden kaldırılır. Görevler ve duraklarla ve araçlarla olan ilişkileri hakkında daha fazla bilgi için Fleet Engine'in temel özellikleri başlıklı makalenin Planlanmış görevler bölümüne bakın .
Görevlerin yaşam döngüsü
Fleet Engine'da her görevi izlemek için öncelikle bir Task
öğesi oluşturmanız gerekir. Referans için gRCP veya REST'e bakın.
Aşağıdaki tabloda, sisteminizde oluşturulan bir görevin örnek uçtan uca akışı ve Fleet Engine'daki yaşam döngüsü aşamaları açıklanmaktadır. Fleet Engine'ı kurduğunuz ve sürücü uygulamasında konum güncellemelerinin etkin olduğu bir aracınız olduğu varsayılır. Sürücü SDK'sı: Planlanmış görevler başlıklı makaleyi inceleyin.
| 1 |
Görev oluşturabilirsiniz. |
Çalışma döngüsünün başında, dağıtıcı veya hizmet yöneticisi öncelikle yayınlama görevleri veya hizmetleri için bir manifest oluşturur. Sisteminiz, bu noktada CreateTrip kullanarak görev varlıklarını oluşturur. Bu varlıklarda görev türü ve konum gibi zorunlu alanlar bulunur. Bu noktada hedef zaman aralığı, görev ilerleme durumunu paylaşma ve özel özellikler gibi başka yapılandırmalar da sağlayabilir. Gönderi görevleri oluşturma ve ilgili kılavuzlara bakın. |
| 2 |
Görev planlayabilirsiniz. |
Teslimat için bir görev planladığınızda bir teslimat aracı güncelleme isteği gönderirsiniz. Bu istek, araç öğesini gidilecek durakların listesiyle günceller. Her durakta tamamlanacak görevlerin listesini atarsınız.
Teslimat aracı görevlerini güncelleme başlıklı makaleyi inceleyin.
|
| 3 |
Görev ilerleme durumunu güncelleyin. |
Görev bir teslimat noktasına atandıktan ve Fleet Engine'da etkinleştirildikten sonra sisteminiz, araca yaklaşırken, vardığında ve durağı tamamladığında Fleet Engine'ı araçla ilgili ilerleme durumu hakkında bilgilendirir. Filo Motoru, bu bilgiler sayesinde hem yolculuk sırasında hem de gün boyunca araç için en iyi rota ve durum güncellemelerini yapabilir. Araç park durumunu güncelleme başlıklı makaleyi inceleyin.
|
| 4 |
Yolculukları paylaşma. |
Araç, teslimat günü için etkin navigasyona başladığı anda, ilgili paydaşlarla yolculuk bilgilerini paylaşabilirsiniz. Fleet Engine, hem görev ayrıntılarını hem de araç konumunu ilgili paydaşlara aşağıdaki şekillerde sunar:
- Tüketiciler için gönderim bilgileri Bu çözüm sayesinde tüketiciler, paketlerinin durumunu ve görüntülemelerine izin verdiğiniz araç konum bilgilerini görebilir.
Planlanmış görevler için tüketici paylaşımı başlıklı makaleyi inceleyin.
- Yöneticiler için filo durumu bilgileri. Bu çözüm sayesinde filo yöneticileri, teslimat araçlarının konumlarını ve filolarınızdaki duraklarını neredeyse gerçek zamanlı olarak görselleştirebilir.
Bir aracın rotası biliniyorsa harita görünümü bileşeni, aracın tahmini yolunda hareket ederken animasyonunu gösterir.
JavaScript Fleet Tracking kitaplığına bakın.
|
| 5 |
Görevi tamamlayın. |
Fleet motorunda kargo görevlerini aşağıdaki yöntemlerle tamamlayabilirsiniz:
- Görevi kapatma: Gönderi görevinin kapatılması, söz konusu görevin artık etkin olmadığını gösterir.
- Görev sonucunu ayarlama: Bir görev kapatıldığında, yayının gerçekleşip gerçekleşmediğini belirtmek için başarılı veya başarısız bir görev belirtirsiniz. Bu, yayın sonucunu tüketici deneyiminizde göstermek ve Fleet Engine hizmeti için doğru faturalandırmayı sağlamak amacıyla bir görevi tamamlamanın önemli bir parçasıdır.
Teslimat araçları gibi görev öğelerinin de durumdan bağımsız olarak 7 gün boyunca Fleet Engine'da etkin kalacağını ve bu sürenin sonunda kaldırılacağını unutmayın.
Görevleri tamamlama başlıklı makaleyi inceleyin.
|
Görev sırası akışı
Aşağıdaki şemada, görev yaşam döngüsünün ayrıntılı akışı gösterilmektedir.
Sırada ne var?
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-31 UTC.
[null,null,["Son güncelleme tarihi: 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)"]]
