- Referensi: Tugas
- Type
- TaskOutcomeLocationSource
- JourneySharingInfo
- TaskTrackingViewConfig
- VisibilityOption
- Metode
Resource: Tugas
Tugas di Delivery API mewakili satu tindakan untuk dilacak. Secara umum, ada perbedaan antara Tasks terkait pengiriman dan Tasks. Sebuah pengiriman dapat memiliki beberapa Tugas yang terkait dengannya. Misalnya, mungkin ada satu Tugas untuk pengambilan, dan satu untuk pengantaran atau transfer. Selain itu, Tugas yang berbeda untuk pengiriman tertentu dapat ditangani oleh kendaraan yang berbeda. Misalnya, satu kendaraan dapat menangani pengambilan, mengarahkan pengiriman ke hub, sementara kendaraan lain menjalankan pengiriman yang sama dari hub ke lokasi pengantaran.
Catatan: gRPC dan REST API menggunakan konvensi penamaan kolom yang berbeda. Misalnya, kolom Task.journey_sharing_info
di gRPC API dan kolom Task.journeySharingInfo
di REST API merujuk ke kolom yang sama.
Representasi JSON |
---|
{ "name": string, "type": enum ( |
Kolom | |
---|---|
name |
Harus dalam format |
type |
Wajib. Tidak dapat diubah. Mendefinisikan jenis Tugas. Misalnya, jeda atau pengiriman. |
state |
Wajib. Status eksekusi Tugas saat ini. |
taskOutcome |
Hasil dari Tugas. |
taskOutcomeTime |
Stempel waktu yang menunjukkan kapan hasil Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: |
taskOutcomeLocation |
Lokasi tempat hasil |
taskOutcomeLocationSource |
Menunjukkan asal nilai |
trackingId |
Tidak dapat diubah. Kolom ini memfasilitasi penyimpanan ID sehingga Anda dapat menghindari penggunaan pemetaan yang rumit. Anda tidak dapat menetapkan
|
deliveryVehicleId |
Hanya output. ID kendaraan yang menjalankan Tugas ini. ID Kendaraan Pengiriman tunduk pada batasan berikut:
|
plannedLocation |
Tidak dapat diubah. Lokasi tempat Tugas akan diselesaikan. Opsional untuk Tasks |
taskDuration |
Wajib. Tidak dapat diubah. Waktu yang diperlukan untuk menjalankan Tugas di lokasi ini. Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
targetTimeWindow |
Periode waktu saat tugas harus diselesaikan. |
journeySharingInfo |
Hanya output. Kolom khusus berbagi perjalanan. Tidak diisi saat status adalah |
taskTrackingViewConfig |
Konfigurasi untuk pelacakan tugas yang menentukan elemen data mana yang terlihat oleh pengguna akhir dalam keadaan apa. |
attributes[] |
Daftar atribut Task kustom. Setiap atribut harus memiliki kunci unik. |
Jenis
Jenis Tugas.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Defaultnya, Jenis tugas tidak diketahui. |
PICKUP |
Tugas pengambilan adalah tindakan yang diambil untuk mengambil kiriman dari pelanggan. Pengambilan kendaraan di depot atau pengumpan harus menggunakan jenis SCHEDULED_STOP . |
DELIVERY |
Tugas pengiriman adalah tindakan yang diambil untuk mengirimkan pesanan ke pelanggan akhir. Penurunan kendaraan di depot atau pengumpan harus menggunakan jenis SCHEDULED_STOP . |
SCHEDULED_STOP |
Tugas perhentian terjadwal digunakan untuk tujuan perencanaan. Misalnya, hal ini bisa berupa pengambilan atau pengantaran kiriman dari kendaraan atau depot pemasok. Nomor ini tidak boleh digunakan untuk pengiriman apa pun yang diambil atau diantarkan dari pelanggan akhir. |
UNAVAILABLE |
Tugas yang berarti Kendaraan tidak tersedia untuk diperbaiki. Misalnya, hal ini dapat terjadi saat pengemudi istirahat, atau saat kendaraan sedang mengisi bahan bakar. |
TaskOutcomeLocationSource
Identitas sumber yang mengisi taskOutcomeLocation
.
Enum | |
---|---|
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED |
Hasil tugas sebelum ditetapkan. |
PROVIDER |
Penyedia menentukan taskOutcomeLocation . |
LAST_VEHICLE_LOCATION |
Penyedia tidak menentukan taskOutcomeLocation , sehingga Fleet Engine menggunakan lokasi kendaraan yang terakhir diketahui. |
JourneySharingInfo
Berbagi perjalanan dengan kolom khusus.
Representasi JSON |
---|
{ "remainingVehicleJourneySegments": [ { object ( |
Kolom | |
---|---|
remainingVehicleJourneySegments[] |
Informasi pelacakan perhentian yang akan dibuat oleh kendaraan yang ditugaskan sebelum menyelesaikan Tugas ini. Perhatikan bahwa daftar ini dapat berisi perhentian dari tugas lain. Segmen pertama, |
lastLocation |
Menunjukkan lokasi terakhir kendaraan yang dilaporkan untuk kendaraan yang ditetapkan. |
lastLocationSnappable |
Menunjukkan apakah lastLocation kendaraan dapat diikat ke |
TaskTrackingViewConfig
Pesan konfigurasi yang menentukan kapan elemen data Tugas harus terlihat oleh pengguna akhir.
Representasi JSON |
---|
{ "routePolylinePointsVisibility": { object ( |
Kolom | |
---|---|
routePolylinePointsVisibility |
Kolom yang menentukan kapan titik polyline rute dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan. |
estimatedArrivalTimeVisibility |
Kolom yang menentukan kapan perkiraan waktu kedatangan dapat dilihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan. |
estimatedTaskCompletionTimeVisibility |
Kolom yang menentukan kapan perkiraan waktu penyelesaian tugas dapat dilihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan. |
remainingDrivingDistanceVisibility |
Kolom yang menentukan kapan jarak mengemudi yang tersisa dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan. |
remainingStopCountVisibility |
Kolom yang menentukan kapan jumlah perhentian tersisa dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan. |
vehicleLocationVisibility |
Kolom yang menentukan kapan lokasi kendaraan dapat dilihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan. |
VisibilityOption
Pesan opsi yang menentukan kapan elemen data harus terlihat oleh pengguna akhir.
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union visibility_option . Opsi visibilitas tertentu telah dipilih. visibility_option hanya ada berupa salah satu diantara berikut: |
|
remainingStopCountThreshold |
Elemen data ini terlihat oleh pengguna akhir jika jumlah perhentian yang tersisa <= RestStopCountThreshold. |
durationUntilEstimatedArrivalTimeThreshold |
Elemen data ini terlihat oleh pengguna akhir jika PWT ke perhentian <= durationuntilEstimatedArrivalTimeThreshold. Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
remainingDrivingDistanceMetersThreshold |
Elemen data ini terlihat oleh pengguna akhir jika jarak mengemudi yang tersisa dalam meter <= RestDrivingDistanceMetersThreshold. |
always |
Jika ditetapkan ke true, elemen data ini akan selalu terlihat oleh pengguna akhir tanpa nilai minimum. Kolom ini tidak boleh ditetapkan ke false. |
never |
Jika ditetapkan ke true, elemen data ini akan selalu disembunyikan dari pengguna akhir tanpa nilai minimum. Kolom ini tidak boleh ditetapkan ke false. |
Metode |
|
---|---|
|
Membuat dan menampilkan batch objek Task baru. |
|
Membuat dan menampilkan objek Task baru. |
|
Mendapatkan informasi tentang Task . |
|
Mendapatkan semua Task yang memenuhi kriteria pemfilteran yang ditentukan. |
|
Memperbarui data Task . |