Dokumen ini menjelaskan layanan tugas terjadwal di Fleet Engine. Bagian ini mengasumsikan bahwa Anda telah membaca Apa itu Fleet Engine? dan mengetahui kemampuan layanan Fleet Engine tertentu yang Anda perlukan.
Saat membaca dokumentasi ini, perhatikan hal-hal berikut:
- Anda membuat tugas dan mengaitkannya dengan perhentian kendaraan sebagai cara untuk membuat model pengaitan dunia nyata antara tugas dan lokasi tempat kendaraan diperkirakan akan berhenti sehingga pengemudi dapat menyelesaikan tugas. Baca Pengantar kendaraan untuk lebih memahami cara kerja kendaraan di Fleet Engine.
- Fleet Engine untuk tugas terjadwal menggunakan resource berikut:
TaskdanDeliveryVehicle. Fleet Engine menyediakan layanan gRPC dan antarmuka REST:
Apa yang dimaksud dengan tugas terjadwal?
Tugas terjadwal di Fleet Engine mewakili tindakan individual yang harus selesai oleh pengemudi menggunakan kendaraan dalam konteks yang lebih luas dari operasi transportasi. Ini menentukan tujuan spesifik untuk driver. Contoh:
- untuk mengirimkan barang ke tempat tinggal
- untuk mengambil paket yang akan dikembalikan ke depot pengiriman
- untuk berhenti di suatu lokasi guna memberikan layanan di tempat kepada pelanggan
- untuk melakukan perhentian terjadwal guna mengisi bahan bakar kendaraan
Elemen tugas
Gambar berikut mengilustrasikan elemen tugas ini dalam perjalanan terjadwal standar untuk kendaraan.
Kolom tugas dasar
| Kolom | Deskripsi |
|---|---|
| Jenis | Menentukan jenis tindakan yang terkait dengan tugas. |
| ID Tugas | String yang secara unik mengidentifikasi tugas dalam sistem. |
| Lokasi yang direncanakan | Menentukan lokasi yang diinginkan tempat tugas harus dilakukan. Lokasi ini tidak selalu sama dengan lokasi yang direncanakan untuk perhentian kendaraan. |
| Negara Bagian | Menunjukkan apakah tugas terbuka atau tertutup. |
| Hasil Tugas | Menunjukkan apakah tugas berhasil atau gagal. |
Model data untuk tugas
Diagram berikut mengilustrasikan model data resource Task
bersama diagram untuk resource DeliveryVehicle terkait. Anda dapat
meninjau kedua diagram untuk mempelajari hubungan antara kedua resource tersebut,
dengan mengingat hal berikut:
- Lokasi yang direncanakan: Perhentian kendaraan dan tugas memiliki lokasi yang direncanakan,
yang berbeda satu sama lain.
- Untuk tugas, lokasi yang direncanakan menunjukkan tempat tindakan driver harus terjadi. Misalnya, 15 pengiriman paket ke kompleks perumahan besar memerlukan pengiriman ke lokasi ruang surat yang berbeda dalam kompleks yang sama.
- Untuk perhentian kendaraan, lokasi yang direncanakan menunjukkan perhentian untuk kendaraan saat pengemudi menyelesaikan tugas. Misalnya, kendaraan berhenti di pintu masuk kompleks apartemen, dan pengemudi mengirimkan paket dengan tangan ke ruang surat terpisah dalam kompleks.
- Status: Tugas dan perhentian kendaraan memiliki kolom status, yang berbeda satu sama lain.
- Status untuk perhentian kendaraan mencerminkan progres kendaraan terkait perhentian, yang digunakan untuk tujuan pelacakan armada.
- Status untuk tugas menunjukkan apakah tugas aktif atau tidak. Hal ini memengaruhi operasi lain yang akan dilakukan pada tugas, seperti menetapkan hasilnya atau menetapkannya ke kendaraan.
Hasil tugas: Hasil tugas adalah kolom penting dalam model data, karena digunakan untuk menunjukkan keberhasilan atau kegagalan tugas, terlepas dari status tugas.
ID:
- Saat Anda menetapkan tugas ke kendaraan, mesin Fleet akan mengisi
kolom
deliveryVehicleId. Kolom hanya baca ini menunjukkan kendaraan yang ditetapkan untuk tugas. - ID tugas adalah ID unik di semua tugas dalam sistem Anda.
- ID pelacakan mengidentifikasi tugas untuk tujuan pelacakan pengiriman.
- Saat Anda menetapkan tugas ke kendaraan, mesin Fleet akan mengisi
kolom
Model data Tasks
Model data kendaraan
ID Tugas
Serupa dengan ID kendaraan di Fleet Engine, setiap tugas harus berisi ID untuk
membedakan tugas tersebut dari tugas lain dalam sistem. Anda mereferensikan dan mengelola semua tugas dalam alur kerja berdasarkan ID-nya. Anda membuat ID ini dengan menggunakan
layanan CreateTaskRequest dan dengan memberikan string ID yang sesuai dengan
persyaratan yang dijelaskan di bagian ini.
String ini kemudian terdiri dari bagian nama resource tugas itu sendiri, yaitu
kolom khusus output pada objek Task. Hal ini serupa dengan cara Fleet Engine
membuat resource nama kendaraan. Lihat bagian Penambahan nama resource di
Pengantar Fleet Engine.
| Properti | Deskripsi |
|---|---|
| Keunikan | Setiap ID tugas harus unik dalam penerapan Fleet Engine Anda untuk menghindari kebingungan dan memastikan identifikasi yang tepat. |
| Format |
|
| Contoh ID tugas yang baik |
|
|---|---|
| ID tugas yang tidak diizinkan |
|
Jenis tugas
Fleet Engine mendukung berbagai jenis tugas untuk mewakili berbagai tindakan dalam operasi transportasi. Akun tersebut dijelaskan di sini beserta visibilitas dan detail penagihannya.
| Jenis Tugas | Deskripsi | Visibilitas Pelacakan Pengiriman | Ditagih |
|---|---|---|---|
| Tugas Pengiriman | Gunakan untuk mengantarkan item atau menyelesaikan tugas untuk pelanggan. | Konsumen dapat melihat dan melacaknya. | Ya |
| Tugas Pengambilan | Gunakan untuk menunjukkan pengambilan barang dari pelanggan. Anda harus memiliki tugas pengiriman yang sesuai untuk setiap tugas pengambilan. | Konsumen dapat melihat dan melacaknya. | Tidak |
| Tugas Ketidaktersediaan | Mengidentifikasi kendaraan sebagai tidak tersedia untuk layanan, seperti saat pengemudi beristirahat atau mengisi bahan bakar kendaraan. | Tidak terlihat oleh konsumen. | Tidak |
| Tugas Perhentian Terjadwal | Tugas non-pengiriman yang memerlukan perhentian di lokasi tertentu. Gunakan tugas perhentian terjadwal untuk perhentian pengambilan terjadwal harian di lokasi tertentu, terlepas dari pengiriman atau pengambilan lainnya di lokasi yang sama. Anda juga dapat membuat tugas perhentian terjadwal untuk pengumpulan dari kotak penitipan atau untuk membuat model transfer atau perhentian kendaraan feeder di pusat layanan dan titik layanan. | Konsumen tidak dapat melacak tugas spesifik ini, tetapi dapat melihatnya sebagai bagian dari pelacakan tugas lain. | Tidak |
Siklus proses tugas dan perjalanan
Bagian ini memberikan detail tentang siklus proses tugas pengiriman dalam Fleet Engine. Siklus proses tugas terhubung ke perjalanan kendaraan karena kendaraan harus melakukan perjalanan ke perhentian agar pengemudi dapat menyelesaikan tugas di lokasi yang direncanakan.
1. Pembuatan tugas
Saat pertama kali membuat tugas di Fleet Engine, Anda menetapkan berbagai kolom untuk tugas secara terpisah dari mengaitkannya dengan perhentian.
| Properti | Deskripsi |
|---|---|
| Negara Bagian | Setel ke BUKA |
| Tanda Pengenal | Tetapkan ID tugas dan pelacakan jika Anda menggunakan pelacakan pengiriman untuk konsumen. |
| Waktu | Durasi yang direncanakan untuk tugas dan periode waktu targetnya. Lihat Pengaturan waktu tugas untuk mengetahui detailnya. |
| Lokasi yang direncanakan | Tetapkan koordinat geografis yang tepat tempat tugas akan diselesaikan. |
2. Penetapan tugas
Saat menetapkan tugas ke kendaraan, Anda melakukannya bersama dengan perhentian kendaraan. Perhentian adalah koordinat lintang/bujur yang menunjukkan lokasi tempat kendaraan parkir saat pengemudi menyelesaikan tugas yang terkait dengan perhentian. Perhentian biasanya merupakan titik akses seperti dok pemuatan, atau lokasi yang diambil dari jalan.
3. Dalam proses
Status tugas adalah TERBUKA atau TUTUP. Namun, setelah tugas ditetapkan ke kendaraan, Anda dapat melacak progresnya melalui pengaitannya ke kendaraan dan lokasi kendaraan terkait perhentian tempat tugas akan selesai.
Setelah kendaraan berangkat dari perhentian atau memulai navigasi, status perhentian akan berubah menjadi ENROUTE. Dengan cara ini, pelacakan pengiriman konsumen dapat
memperbarui penerima untuk tugas dengan jumlah perhentian yang tersisa dan estimasi
waktu kedatangan. Hal ini juga mendukung visualisasi real-time untuk pelacakan pengiriman konsumen atau untuk pelacakan armada.
4. Hasil kedatangan dan tugas
Saat kendaraan tiba di perhentian, status perhentian harus ditetapkan ke
ARRIVED. Seperti status berhenti ENROUTE, hal ini tidak memengaruhi status
tugas itu sendiri, tetapi mendukung notifikasi konsumen dan pelaporan real-time
untuk pelacakan armada yang digunakan oleh operator armada Anda. Hal ini juga memungkinkan analisis dan pelaporan
kemudian tentang operasi yang akan Anda gunakan untuk pengoptimalan
pengiriman.
Setelah kendaraan tiba di perhentian, sistem Anda dapat menangani perjalanan tugas selanjutnya menggunakan salah satu pendekatan berikut:
Tutup tugas setelah selesai.
Saat pengemudi menandai tugas selesai, sistem Anda dapat menghapusnya dari perhentian, tetapi tetapkan perhentian dengan tugas lain yang ditetapkan.
Hapus seluruh perhentian dari kendaraan.
Setelah pengemudi menandai semua tugas selesai dan kendaraan sedang dalam perjalanan ke perhentian berikutnya, Anda dapat menghapus seluruh perhentian dari kendaraan. Fleet Engine akan otomatis menutup semua tugas yang terkait dengan perhentian yang dihapus.
Menutup tugas tidak menunjukkan keberhasilan atau kegagalan
Menutup tugas hanya menunjukkan bahwa tugas tidak lagi dianggap sedang berlangsung.
Untuk tugas dalam status CLOSED, Anda menetapkan hasilnya ke SUCCEEDED atau
FAILED. Hal ini diperlukan untuk menunjukkan hasil sebenarnya untuk pelacakan
pengiriman dan untuk penagihan yang tepat. Fleet Engine hanya menagih tugas pengiriman dengan
status BERHASIL.
Setelah menetapkan hasil tugas, Anda tidak dapat mengubahnya
Saat menandai hasil tugas, Fleet Engine akan otomatis mengisi lokasi hasil tugas dengan lokasi kendaraan terakhir yang diketahui. Namun, Anda dapat mengubah waktu hasil tugas dan lokasi hasil tugas setelah ditetapkan dan Fleet Engine tidak akan mengganti kolom ini.
5. Skenario tugas lainnya
Tidak semua tugas yang Anda buat modelnya di Fleet Engine sesuai dengan alur perjalanan standar. Contoh:
- Tugas pengambilan. Jika Anda memiliki tugas pengambilan untuk paket yang akan dikembalikan ke depot untuk diproses nanti, Anda harus membuat tugas pengiriman yang sesuai untuk paket tersebut, dengan lokasi yang direncanakan ditetapkan ke depot. Jika tidak, tugas pengambilan biasanya mengikuti alur yang sama seperti untuk tugas pengiriman.
- Penetapan ulang tugas. Anda tidak dapat langsung menetapkan ulang tugas ke kendaraan lain. Sebagai gantinya, untuk memindahkan tugas dari satu kendaraan ke kendaraan lain, tutup tugas asli, lalu buat ulang sebelum menetapkannya ke kendaraan baru. Jika Anda memperbarui urutan tugas untuk tugas yang sudah ditetapkan ke kendaraan lain, Fleet Engine akan menampilkan error.
- Menghapus tugas. Seperti kendaraan, Fleet Engine akan menghapus tugas yang belum diperbarui setelah tujuh hari. Jika Anda mencoba menggunakan kembali ID tugas untuk tugas yang sebelumnya telah ditutup, Fleet Engine akan menampilkan error jika ID tersebut telah digunakan dalam tujuh hari terakhir. Sebaliknya, jika ingin mempertahankan data tugas lebih lama dari tujuh hari, Anda harus menerapkan kemampuan tersebut sendiri, seperti melalui tugas terjadwal untuk mereset jam 7 hari.
Membagikan progres tugas
Di Fleet Engine, Anda dapat memantau progres tugas secara real-time dan membagikan perjalanan pengemudi dengan dua cara utama:
- Pengalaman konsumen bagi konsumen untuk mengetahui status pesanan pengiriman atau pesanan layanan yang diminta.
- Pelacakan armada bagi operator armada Anda untuk melacak dan menganalisis status kendaraan dalam armada.
Pengalaman konsumen
Untuk membagikan progres tugas, Anda menyiapkan pengalaman konsumen menggunakan JavaScript Consumer SDK. Dengan SDK ini, Anda dapat meningkatkan pengalaman web visual atau aplikasi seluler sehingga konsumen dapat memantau status pengiriman mereka beserta perkiraan waktu tiba dan pembaruan lokasi real-time untuk kendaraan pengiriman. Lihat Ringkasan tugas terjadwal Consumer SDK.
Consumer SDK berisi peta JavaScript dan komponen data untuk terhubung dengan Fleet Engine. Peta adalah pengganti langsung untuk
objek google.maps.Map standar. Klien Anda harus mengautentikasi pengguna akhir dan menggunakan peran konsumen Pengiriman dari project Google Cloud Anda untuk hanya menampilkan informasi khusus pelanggan. Fleet Engine memfilter dan menyamarkan semua
informasi lainnya dalam respons. Misalnya, selama tugas ketidaktersediaan,
tidak ada informasi lokasi yang dibagikan kepada pengguna akhir.
Di Fleet Engine, Anda mengaktifkan setelan berikut untuk membagikan progres tugas kepada konsumen:
- Tugas menggunakan properti
TaskTrackingViewConfig. Opsional. - Tugas menggunakan ID pelacakan, yang diperlukan library untuk mengidentifikasi tugas yang relevan bagi konsumen.
Pelacakan Armada
Library Pelacakan Armada JavaScript memungkinkan Anda memvisualisasikan lokasi
kendaraan dalam armadanya secara mendekati real time. Library ini menggunakan
Fleet Engine API untuk memberikan visualisasi kendaraan pengiriman serta
tugas yang ditetapkan. Seperti SDK konsumen JavaScript, SDK ini berisi komponen peta JavaScript yang merupakan pengganti langsung untuk entitas google.maps.Map standar dengan komponen data yang Anda gunakan untuk terhubung dengan Fleet Engine.
Library ini menampilkan visibilitas kendaraan pengiriman segera setelah dibuat di Fleet Engine. Untuk penerapan ini, Anda menggunakan peran Cloud IAM Super User Layanan Mesin Armada dan memberikan klaim Java Web Token untuk akses ke kendaraan pengiriman dan tugas terkaitnya.
Skenario tugas terjadwal
Bagian ini menunjukkan berbagai skenario tugas yang merangkum informasi yang diberikan pada tahap ini dalam panduan. Panduan ini dimaksudkan untuk membantu Anda memahami berbagai cara untuk membuat model operasi transportasi di Fleet Engine, bergantung pada bisnis Anda.
Pengiriman dengan pelacakan
Skenario pengiriman ini menunjukkan tugas perhentian terjadwal
yang ditetapkan ke depot baik saat keberangkatan dari depot di awal
perjalanan maupun saat tiba di depot di akhir perjalanan. Laporan ini juga
menampilkan dua tugas pengiriman untuk perhentian, salah satunya gagal. Gunakan tugas
ini untuk mengaktifkan pelacakan dari dan ke depot serta sebagai cara untuk membuat model
waktu mulai dan berhenti untuk hari tersebut. Tidak ada penagihan
yang terjadi dengan tugas penghentian terjadwal.
Pengambilan dengan pengiriman depot
Skenario ini menunjukkan cara membuat model pengambilan dengan tugas pengiriman yang sesuai. Anda menetapkan pengembalian ke depot sebagai pengiriman untuk tujuan penagihan.
Kendaraan feeder
Skenario ini menunjukkan dua pengiriman dengan perhentian terjadwal di tengah untuk kendaraan feeder, yang tujuannya adalah memungkinkan kendaraan pengiriman kembali ke depot dengan sejumlah paket yang akan dikirim. Anda juga dapat membuat model kendaraan feeder dengan perhentian terjadwal.
Waktu Tugas
Membuat model waktu tugas akan membantu perencanaan rute yang efektif, perkiraan waktu tiba, dan mengelola ekspektasi pengiriman. Fleet Engine menawarkan dua fungsi utama untuk membuat model dan memperkirakan waktu tugas, seperti yang dijelaskan di bagian ini.
Durasi tugas
Durasi tugas ditetapkan dengan kolom task_duration, kolom wajib yang
membuat model waktu yang diperkirakan yang dihabiskan pengemudi untuk menyelesaikan tugas di perhentian
atau untuk beristirahat. Untuk perhentian, ini mencakup semua aktivitas yang diperlukan
setelah tiba di perhentian, seperti menurunkan paket dan berinteraksi dengan
penerima. Makin spesifik informasi ini, makin baik kemampuan Fleet Engine untuk
memberikan waktu tiba dan perkiraan waktu tiba yang realistis untuk perhentian berikutnya dalam perjalanan.
Untuk mengetahui detail kolom, lihat Durasi di Dokumentasi Buffering Protokol.
Jendela waktu target
Waktu target menentukan rentang waktu yang diusulkan untuk suatu tugas, biasanya digunakan untuk
berkomunikasi dengan pelanggan atau untuk tujuan perencanaan internal. Anda menetapkannya dengan
kolom target_time_window, yang terdiri dari waktu mulai dan waktu berakhir.
Hal ini tidak secara langsung memengaruhi penghitungan rute, tetapi dapat digunakan untuk situasi seperti memberi tahu konsumen tentang jangka waktu pengiriman paket, atau kapan pekerja layanan terjadwal akan tiba.
Atribut Tugas
Atribut tugas di Fleet Engine memberikan cara yang mudah untuk memfilter tugas berdasarkan karakteristik tertentu saat menggunakan permintaan ListTasks. Anda juga dapat menggunakan atribut tugas kustom untuk analisis dengan Cloud Logging, beserta menyampaikan informasi kepada konsumen atau untuk pelacakan fleet. Tujuannya
mirip dengan atribut kendaraan: gunakan atribut ini untuk membuat perspektif yang lebih
terfokus pada operasi pengiriman Anda.
Batasan dan Pembatasan
- Pembuatan atribut kustom: Fleet Engine membatasi jumlah atribut kustom yang dapat Anda tentukan per tugas. Hubungi Sales Rep Anda untuk meminta peningkatan batas tersebut.
- Kemampuan pemfilteran: Meskipun menawarkan fleksibilitas pemfilteran, atribut tugas tidak menggantikan kolom data tugas inti. Gunakan filter tersebut untuk pemfilteran tambahan berdasarkan kebutuhan spesifik Anda.
- Setiap atribut harus memiliki kunci unik.
- Jangan sertakan informasi identitas pribadi atau informasi sensitif lainnya dalam nilai atribut, karena informasi tersebut mungkin terlihat oleh pengguna.
- Validasi data: Pastikan jenis dan format data atribut kustom Anda kompatibel dengan persyaratan Fleet Engine.