REST Resource: providers.tasks

Resource: Tugas

Tugas di Delivery API mewakili satu tindakan yang akan dilacak. Secara umum, ada perbedaan antara Tasks yang terkait dengan pengiriman dan memecah Tasks. Sebuah pengiriman dapat memiliki beberapa Tugas yang terkait dengannya. Misalnya, mungkin ada satu Tugas untuk penjemputan, 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 lokasi, sementara kendaraan lain mendorong 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 (Type),
  "state": enum (State),
  "taskOutcome": enum (TaskOutcome),
  "taskOutcomeTime": string,
  "taskOutcomeLocation": {
    object (LocationInfo)
  },
  "taskOutcomeLocationSource": enum (TaskOutcomeLocationSource),
  "trackingId": string,
  "deliveryVehicleId": string,
  "plannedLocation": {
    object (LocationInfo)
  },
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  },
  "journeySharingInfo": {
    object (JourneySharingInfo)
  },
  "taskTrackingViewConfig": {
    object (TaskTrackingViewConfig)
  },
  "attributes": [
    {
      object (TaskAttribute)
    }
  ]
}
Kolom
name

string

Harus dalam format providers/{provider}/tasks/{task}.

type

enum (Type)

Wajib. Tidak dapat diubah. Mendefinisikan jenis Tugas. Misalnya, kerusakan atau pengiriman.

state

enum (State)

Wajib. Status eksekusi Tugas saat ini.

taskOutcome

enum (TaskOutcome)

Hasil dari Tugas.

taskOutcomeTime

string (Timestamp format)

Stempel waktu yang menunjukkan kapan hasil Task ditetapkan oleh penyedia.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

taskOutcomeLocation

object (LocationInfo)

Lokasi tempat hasil Task ditetapkan. Nilai ini diperbarui sebagai bagian dari tasks.patch. Jika nilai ini tidak diperbarui secara eksplisit oleh penyedia, Fleet Engine akan mengisinya secara default dengan lokasi kendaraan terakhir yang diketahui (lokasi raw).

taskOutcomeLocationSource

enum (TaskOutcomeLocationSource)

Menunjukkan asal nilai taskOutcomeLocation.

trackingId

string

Tidak dapat diubah. Kolom ini memfasilitasi penyimpanan ID sehingga Anda dapat menghindari penggunaan pemetaan yang rumit. Anda tidak dapat menetapkan trackingId untuk Tasks dengan jenis UNAVAILABLE dan SCHEDULED_STOP. ID ini tunduk kepada batasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi hingga panjang maksimum 64 karakter.
  • Dinormalkan menurut Formulir Normalisasi Unicode C.
  • Tidak boleh berisi karakter ASCII berikut: '/', ':', '?', ',', atau '#'.
deliveryVehicleId

string

Hanya output. ID kendaraan yang menjalankan Tugas ini. ID Kendaraan Pengiriman tunduk pada batasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi hingga panjang maksimum 64 karakter.
  • Dinormalkan menurut Formulir Normalisasi Unicode C.
  • Tidak boleh berisi karakter ASCII berikut: '/', ':', '?', ',', atau '#'.
plannedLocation

object (LocationInfo)

Tidak dapat diubah. Lokasi tempat Tugas akan diselesaikan. Opsional untuk UNAVAILABLE Tasks, tetapi diperlukan untuk semua Tasks lainnya.

taskDuration

string (Duration format)

Wajib. Tidak dapat diubah. Waktu yang diperlukan untuk menjalankan Tugas di lokasi ini.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

targetTimeWindow

object (TimeWindow)

Periode waktu saat tugas harus diselesaikan.

journeySharingInfo

object (JourneySharingInfo)

Hanya output. Kolom khusus berbagi perjalanan. Tidak diisi saat status adalah CLOSED.

taskTrackingViewConfig

object (TaskTrackingViewConfig)

Konfigurasi untuk pelacakan tugas yang menentukan elemen data mana yang terlihat oleh pengguna akhir dalam keadaan apa.

attributes[]

object (TaskAttribute)

Daftar atribut Tugas kustom. Setiap atribut harus memiliki kunci unik.

Jenis

Jenis Task.

Enum
TYPE_UNSPECIFIED Default, Jenis tugas tidak diketahui.
PICKUP Tugas pengambilan adalah tindakan yang diambil untuk mengambil kiriman dari pelanggan. Pengambilan kendaraan pengangkut di depot atau pengumpan harus menggunakan jenis SCHEDULED_STOP.
DELIVERY Tugas pengiriman adalah tindakan yang diambil untuk mengirimkan kiriman ke pelanggan akhir. Penerimaan dari kendaraan pengangkut atau depot harus menggunakan jenis SCHEDULED_STOP.
SCHEDULED_STOP Tugas perhentian terjadwal digunakan untuk tujuan perencanaan. Contohnya, data dapat mewakili mengambil atau menurunkan barang kiriman dari kendaraan pengumpan atau depot. Metode ini tidak boleh digunakan untuk pengiriman yang diambil atau diantarkan dari pelanggan akhir.
UNAVAILABLE Tugas yang berarti Kendaraan tidak dapat diservis. Misalnya, hal ini dapat terjadi saat pengemudi beristirahat, 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, jadi Fleet Engine menggunakan lokasi kendaraan terakhir yang diketahui.

JourneySharingInfo

Perjalanan membagikan kolom tertentu.

Representasi JSON
{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "lastLocationSnappable": boolean
}
Kolom
remainingVehicleJourneySegments[]

object (VehicleJourneySegment)

Informasi pelacakan untuk perhentian yang akan dibuat oleh kendaraan yang ditetapkan sebelum menyelesaikan Tugas ini. Perhatikan bahwa daftar ini dapat berisi perhentian dari tugas lain.

Segmen pertama, Task.journey_sharing_info.remaining_vehicle_journey_segments[0] (gRPC) atau Task.journeySharingInfo.remainingVehicleJourneySegments[0] (REST), berisi informasi rute dari lokasi terakhir pengemudi yang diketahui ke VehicleStop mendatang. Informasi rute saat ini biasanya berasal dari aplikasi pengemudi, kecuali untuk beberapa kasus yang tercantum dalam dokumentasi untuk DeliveryVehicle.current_route_segment. Segmen lain di Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) atau Task.journeySharingInfo.remainingVehicleJourneySegments (REST) diisi oleh Fleet Engine. Properti tersebut memberikan informasi rute di antara VehicleStops yang tersisa.

lastLocation

object (DeliveryVehicleLocation)

Menunjukkan lokasi terakhir kendaraan yang dilaporkan untuk kendaraan yang ditetapkan.

lastLocationSnappable

boolean

Menunjukkan apakah lastLocation kendaraan dapat dipaskan ke currentRouteSegment. Nilai ini Salah jika lastLocation atau currentRouteSegment tidak ada. Nilai ini dihitung oleh Fleet Engine. Pembaruan dari klien akan diabaikan.

TaskTrackingViewConfig

Pesan konfigurasi yang menentukan kapan elemen data Tugas harus terlihat oleh pengguna akhir.

Representasi JSON
{
  "routePolylinePointsVisibility": {
    object (VisibilityOption)
  },
  "estimatedArrivalTimeVisibility": {
    object (VisibilityOption)
  },
  "estimatedTaskCompletionTimeVisibility": {
    object (VisibilityOption)
  },
  "remainingDrivingDistanceVisibility": {
    object (VisibilityOption)
  },
  "remainingStopCountVisibility": {
    object (VisibilityOption)
  },
  "vehicleLocationVisibility": {
    object (VisibilityOption)
  }
}
Kolom
routePolylinePointsVisibility

object (VisibilityOption)

Kolom yang menentukan kapan titik polyline rute dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default level project untuk data ini akan digunakan.

estimatedArrivalTimeVisibility

object (VisibilityOption)

Kolom yang menentukan kapan perkiraan waktu kedatangan dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default level project untuk data ini akan digunakan.

estimatedTaskCompletionTimeVisibility

object (VisibilityOption)

Kolom yang menentukan kapan perkiraan waktu penyelesaian tugas dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default level project untuk data ini akan digunakan.

remainingDrivingDistanceVisibility

object (VisibilityOption)

Kolom yang menentukan kapan jarak mengemudi yang tersisa dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default level project untuk data ini akan digunakan.

remainingStopCountVisibility

object (VisibilityOption)

Kolom yang menentukan kapan jumlah perhentian yang tersisa dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default level project untuk data ini akan digunakan.

vehicleLocationVisibility

object (VisibilityOption)

Kolom yang menentukan kapan lokasi kendaraan dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default level project untuk data ini akan digunakan.

VisibilityOption

Pesan opsi yang menentukan kapan elemen data harus terlihat oleh pengguna akhir.

Representasi JSON
{

  // Union field visibility_option can be only one of the following:
  "remainingStopCountThreshold": integer,
  "durationUntilEstimatedArrivalTimeThreshold": string,
  "remainingDrivingDistanceMetersThreshold": integer,
  "always": boolean,
  "never": boolean
  // End of list of possible types for union field visibility_option.
}
Kolom
Kolom union visibility_option. Opsi visibilitas spesifik dipilih. visibility_option hanya dapat berupa salah satu dari berikut:
remainingStopCountThreshold

integer

Elemen data ini terlihat oleh pengguna akhir jika jumlah perhentian yang tersisa <= remainingStopCountThreshold.

durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

Elemen data ini terlihat oleh pengguna akhir jika PWT sampai perhentian <= durationEstimatedArrivalTimeThreshold.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

remainingDrivingDistanceMetersThreshold

integer

Elemen data ini terlihat oleh pengguna akhir jika jarak mengemudi yang tersisa dalam meter <= remainingDrivingDistanceMetersThreshold.

always

boolean

Jika disetel ke benar (true), elemen data ini selalu terlihat oleh pengguna akhir tanpa nilai minimum. Kolom ini tidak boleh disetel ke salah (false).

never

boolean

Jika disetel ke benar (true), elemen data ini akan selalu disembunyikan dari pengguna akhir tanpa nilai minimum. Kolom ini tidak boleh disetel ke salah.

Metode

batchCreate

Membuat dan menampilkan batch objek Task baru.

create

Membuat dan menampilkan objek Task baru.

get

Mendapatkan informasi tentang Task.

list

Mendapatkan semua Task yang memenuhi kriteria pemfilteran yang ditentukan.

patch

Memperbarui data Task.