Dokumentasi di bagian ini menunjukkan cara membuat dan menggunakan tugas terjadwal menggunakan layanan tugas terjadwal Google Maps Mobility. Tutorial ini mengasumsikan bahwa Anda sudah memahami hal-hal berikut:
- Fleet Engine: Anda harus sudah memahami detail implementasi, mekanisme permintaan, dan keamanan Fleet Engine. Untuk itu, lihat Apa itu layanan Fleet Engine? dan topik keamanan di Menyiapkan Fleet Engine.
- Dasar-dasar kendaraan untuk layanan on demand. Lihat Pengantar kendaraan.
- Dasar-dasar tugas untuk layanan tugas terjadwal. Lihat Tugas terjadwal
Resource Task
yang akan Anda gunakan tersedia di gRPC dan
REST.
Di Fleet Engine untuk tugas terjadwal, tugas mewakili aktivitas pengemudi yang memenuhi pengiriman atau layanan terjadwal untuk konsumen Anda. Anda menetapkan tugas ke lokasi perhentian kendaraan tempat perhentian tersebut akan diselesaikan, dan kendaraan akan melakukan perjalanan ke perhentian tersebut.
Tugas memiliki dua kemungkinan status, OPEN
atau CLOSED
. Status ini menunjukkan
apakah tugas aktif atau tidak dalam sistem. Seiring perjalanan berkembang untuk
tugas aktif, Anda melaporkannya ke Fleet Engine dengan memperbarui perhentian kendaraan
yang terkait dengan tugas, yaitu ENROUTE atau ARRIVED. Setelah pengemudi
menyelesaikan tugas dan meninggalkan perhentian, Anda menghapus perhentian dari daftar perhentian
di kendaraan. Untuk mengetahui informasi selengkapnya tentang
tugas dan hubungannya dengan perhentian dan kendaraan, lihat
Tugas terjadwal di Dasar-dasar Fleet Engine .
Siklus proses tugas
Untuk melacak setiap tugas di Fleet Engine, Anda harus membuat entity Task
terlebih dahulu. Lihat gRCP atau REST untuk referensi.
Tabel berikut menjelaskan contoh alur menyeluruh dari tugas yang dibuat di sistem Anda dan tahapan siklus prosesnya di Fleet Engine. Anda dianggap telah menyiapkan Fleet Engine dan memiliki kendaraan untuk tugas tersebut, dengan pembaruan lokasi yang diaktifkan di aplikasi pengemudi. Lihat Driver SDK: Tugas terjadwal.
1 | Membuat tugas. | Di awal siklus kerja, dispatcher atau administrator
layanan terlebih dahulu membuat manifes untuk tugas atau layanan pengiriman. Dari
sana, sistem Anda kemudian membuat entity tugas menggunakan
CreateTrip dengan kolom yang diperlukan, seperti jenis tugas dan
lokasi. Pada tahap ini, API ini juga dapat menyediakan konfigurasi lain,
seperti periode waktu target, membagikan progres tugas, dan atribut
kustom. Lihat
Membuat tugas pengiriman
dan panduan terkait. |
2 | Menjadwalkan tugas. | Saat menjadwalkan tugas untuk pengiriman, Anda mengeluarkan permintaan update kendaraan pengiriman, yang kemudian memperbarui entitas kendaraan dengan daftar perhentian yang akan ditempuh. Anda menetapkan daftar tugas yang harus diselesaikan di setiap perhentian untuk setiap perhentian. Lihat Memperbarui tugas kendaraan pengiriman. |
3 | Perbarui progres tugas. | Setelah tugas ditetapkan ke perhentian pengiriman dan aktif di Fleet Engine, sistem Anda akan memberi tahu Fleet Engine tentang progres kendaraan saat mendekati, tiba di, dan menyelesaikan perhentian. Dengan informasi ini, Fleet Engine dapat melakukan pemilihan rute dan pembaruan status secara optimal selama perjalanan serta sepanjang hari untuk kendaraan. Lihat Memperbarui status perhentian kendaraan. |
4 | Membagikan perjalanan. | Pada saat yang sama saat kendaraan memulai navigasi aktif untuk
hari pengiriman, Anda dapat berbagi informasi perjalanan dengan pemangku kepentingan
yang berminat. Fleet Engine menyediakan detail tugas dan lokasi kendaraan
bagi pemangku kepentingan yang berminat dengan cara berikut:
|
5 | Selesaikan tugas. | Anda menyelesaikan tugas pengiriman di mesin Fleet dengan cara berikut:
|
Alur urutan tugas
Diagram berikut menunjukkan alur mendetail dari siklus proses tugas.