REST Resource: providers.tasks

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 (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, jeda 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 format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. 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 jenis UNAVAILABLE dan SCHEDULED_STOP. ID ini tunduk pada pembatasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi hingga panjang maksimum 64 karakter.
  • Dinormalkan sesuai dengan Unicode Normalization Form 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 sesuai dengan Unicode Normalization Form C.
  • Tidak boleh berisi karakter ASCII berikut: '/', ':', '?', ',', atau '#'.
plannedLocation

object (LocationInfo)

Tidak dapat diubah. Lokasi tempat Tugas akan diselesaikan. Opsional untuk Tasks UNAVAILABLE, tetapi wajib 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, 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 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 (VehicleJourneySegment)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "lastLocationSnappable": boolean
}
Kolom
remainingVehicleJourneySegments[]

object (VehicleJourneySegment)

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, 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 lainnya di Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) atau Task.journeySharingInfo.remainingVehicleJourneySegments (REST) diisi oleh Fleet Engine. Keduanya 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 diikat 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 tingkat project untuk data ini akan digunakan.

estimatedArrivalTimeVisibility

object (VisibilityOption)

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

object (VisibilityOption)

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

object (VisibilityOption)

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

object (VisibilityOption)

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

object (VisibilityOption)

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 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 tertentu telah dipilih. visibility_option hanya ada berupa salah satu diantara berikut:
remainingStopCountThreshold

integer

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

durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

Elemen data ini terlihat oleh pengguna akhir jika PWT ke perhentian <= durationuntilEstimatedArrivalTimeThreshold.

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

remainingDrivingDistanceMetersThreshold

integer

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

always

boolean

Jika ditetapkan ke true, elemen data ini akan selalu terlihat oleh pengguna akhir tanpa nilai minimum. Kolom ini tidak boleh ditetapkan ke false.

never

boolean

Jika ditetapkan ke true, elemen data ini akan selalu disembunyikan dari pengguna akhir tanpa nilai minimum. Kolom ini tidak boleh ditetapkan ke false.

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.

search
(deprecated)

Tidak digunakan lagi: Sebagai gantinya, gunakan GetTaskTrackingInfo.