Mengonfigurasi tugas

Dokumen ini mengasumsikan bahwa Anda memahami cara membuat dan menggunakan tugas. Panduan ini memberikan contoh spesifik tentang cara mengonfigurasi tugas pengiriman dengan cara berikut:

• Menetapkan periode waktu target untuk tugas pengiriman: Menetapkan periode waktu untuk menyelesaikan tugas.

• Menyesuaikan visibilitas tugas: Menyesuaikan visibilitas aktivitas tugas untuk ditampilkan kepada pelanggan atau operator armada.

Lihat Membuat tugas pengiriman untuk mengetahui detail tentang kolom untuk tugas pengiriman. Saat memperbarui informasi tambahan tentang tugas yang ada, Anda juga harus menyertakan ID yang relevan untuk tugas tersebut, selain kolom yang Anda perbarui untuk tugas tersebut.

Menetapkan periode waktu target

Periode waktu target adalah TimeWindow selama tugas harus selesai. Misalnya, jika Anda menyampaikan periode waktu pengiriman kepada penerima pengiriman, Anda dapat menggunakan periode waktu target tugas untuk menangkap periode waktu ini dan membuat pemberitahuan, atau Anda dapat menggunakannya untuk menganalisis performa perjalanan sebelumnya.

Periode waktu target terdiri dari waktu mulai dan waktu berakhir, serta dapat ditetapkan pada jenis tugas apa pun. Periode waktu target tidak memengaruhi perilaku perutean.

Contoh berikut menunjukkan cara menetapkan periode waktu menggunakan library gRPC Java atau cara membuat permintaan REST HTTP ke UpdateTask. Anda juga dapat menetapkan kolom ini pada saat pembuatan tugas.

  static final String PROJECT_ID = "my-delivery-co-gcp-project";
  static final String TASK_ID = "task-8241890";

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Task settings
  String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
  Task task = Task.newBuilder()
    .setName(taskName)
    .setTargetTimeWindow(
      TimeWindow.newBuilder()
        .setStartTime(Timestamp.newBuilder().setSeconds(1680123600))
        .setEndTime(Timestamp.newBuilder().setSeconds(1680130800)))
    .build();

  // Task request
  UpdateTaskRequest updateTaskRequest =
    UpdateTaskRequest.newBuilder()  // No need for the header
        .setTask(task)
        .setUpdateMask(FieldMask.newBuilder().addPaths("targetTimeWindow"))
        .build();

  try {
    Task updatedTask = deliveryService.updateTask(updateTaskRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case NOT_FOUND:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

# Set JWT, PROJECT_ID, and TASK_ID in the local environment
  curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=targetTimeWindow" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}" \
    --data-binary @- << EOM
  {
    "targetTimeWindow": {
      "startTime": "2023-03-29T21:00:00Z",
      "endTime": "2023-03-29T23:00:00Z"
    }
  }
  EOM

Menyesuaikan visibilitas tugas

Secara default, Fleet Engine memberikan visibilitas ke aktivitas tugas yang kemudian dapat ditampilkan kepada pelanggan yang menerima pengiriman dan operator armada yang melacak pengiriman. Hal ini mencakup informasi seperti menunjukkan jumlah perhentian sebelum mengirim notifikasi kepada pelanggan tentang status pengiriman paket mereka. Anda dapat menyesuaikan informasi ini berdasarkan tugas untuk lebih sesuai dengan model bisnis Anda.

Bagian ini menjelaskan aturan visibilitas untuk objek yang dilacak di peta. Aturan ini berlaku untuk dua kategori objek:

• Visibilitas penanda lokasi
• Visibilitas data tugas untuk tugas kendaraan aktif, seperti polyline dan perkiraan waktu tiba

Aturan visibilitas penanda lokasi

Fleet Engine menampilkan penanda lokasi untuk lokasi pengiriman kiriman yang ditampilkan di peta, terlepas dari status pengiriman.

Aturan visibilitas data tugas

Bagian ini menjelaskan aturan visibilitas default yang berlaku untuk data tugas. Anda hanya dapat menyesuaikan tugas kendaraan aktif, yang berarti hanya tugas pengambilan dan pengantaran yang dapat menerapkan aturan visibilitas yang disesuaikan.

Tugas berikut tidak dapat disesuaikan:

• Perhentian terjadwal
• Tugas ketidaktersediaan
• Tugas kendaraan tidak aktif

Aturan visibilitas tugas ketidaktersediaan

Secara default, kendaraan tidak muncul di peta jika setidaknya satu tugas ketidaktersediaan ditetapkan ke tugas yang dilacak. Misalnya, jika pengemudi sedang beristirahat atau kendaraan sedang mengisi bahan bakar di rute ke pengiriman yang dilacak. Perkiraan waktu tiba dan perkiraan waktu penyelesaian tugas masih tersedia. Sekali lagi, Anda tidak dapat menyesuaikan aturan ini.

Visibilitas tugas kendaraan aktif

Objek TaskTrackingInfo menyediakan sejumlah elemen data yang dapat Anda tampilkan menggunakan Library Pelacakan Pengiriman. Secara default, kolom ini terlihat saat tugas ditetapkan ke kendaraan dan saat kendaraan berada dalam jarak 5 perhentian dari tugas. Visibilitas berakhir saat tugas selesai atau dibatalkan.

Anda dapat menyesuaikan konfigurasi visibilitas per tugas dengan menetapkan TaskTrackingViewConfig pada tugas saat membuat atau memperbarui tugas dalam Fleet Engine. Tindakan ini akan membuat aturan agar setiap elemen data tersedia.

Tabel berikut menunjukkan kolom tempat Anda dapat menerapkan aturan visibilitas.

Tabel ini menunjukkan opsi visibilitas yang tersedia untuk kolom yang tercantum di atas.

Aturan visibilitas polyline rute dan lokasi kendaraan

Untuk rute yang dilacak, visibilitas polyline rute bergantung pada visibilitas kendaraan. Jika polyline rute terlihat di rute aktif tempat kendaraan tidak terlihat, lokasi kendaraan masih dapat disimpulkan oleh akhir polyline yang terlihat. Oleh karena itu, visibilitas polyline rute harus sama ketatnya atau lebih ketat daripada visibilitas kendaraan.

Ikuti aturan ini untuk memberikan kombinasi visibilitas polyline rute / lokasi kendaraan yang valid.

Polyline rute dan lokasi kendaraan menentukan opsi visibilitas yang sama

Dalam skenario ini, polyline dan lokasi kendaraan menetapkan opsi yang sama, yang mencakup:

• jumlah perhentian yang tersisa
• durasi hingga PWT
• jarak mengemudi yang tersisa

Untuk mematuhi aturan, nilai visibilitas polyline rute harus kurang dari atau sama dengan nilai yang ditetapkan untuk visibilitas kendaraan. Dalam contoh ini, batas perhentian yang tersisa untuk polyline ditetapkan ke 3, yang kurang dari nilai 5 yang ditentukan untuk kendaraan. Artinya, saat perjalanan yang dilacak mencapai 5 perhentian dari lokasi tugas, kendaraan akan muncul, tetapi rute untuk kendaraan tersebut tidak akan muncul hingga perjalanan mencapai 3 perhentian.

```js
"taskTrackingViewConfig": {
  "routePolylinePointsVisibility": {
    "remainingStopCountThreshold": 3
  },
  "vehicleLocationVisibility": {
    "remainingStopCountThreshold": 5
  },
}
```

Polyline rute dan lokasi kendaraan menentukan opsi visibilitas yang berbeda

Jika polyline rute dan lokasi kendaraan memiliki opsi visibilitas yang berbeda, lokasi kendaraan hanya terlihat jika kedua opsi visibilitasnya terpenuhi. Sekali lagi, visibilitas polyline tunduk pada aturan visibilitas kendaraan:

• Selalu terlihat: Polyline rute harus menggunakan opsi visibilitas selalu terlihat jika lokasi kendaraan juga menyediakan opsi visibilitas selalu terlihat yang sama.
• Tidak pernah terlihat: Polyline rute harus menggunakan opsi visibilitas tidak pernah terlihat saat lokasi kendaraan menggunakan opsi visibilitas tidak pernah terlihat.

Berikut adalah contohnya:

  "taskTrackingViewConfig": {
    "routePolylinePointsVisibility": {
      "remainingStopCountThreshold": 3
    },
    "vehicleLocationVisibility": {
      "remainingDrivingDistanceMetersThreshold": 3000
    },
  }

Dalam contoh ini, lokasi kendaraan hanya terlihat jika jumlah perhentian yang tersisa minimal 3 DAN jarak mengemudi yang tersisa minimal 3.000 meter.

Contoh penyesuaian visibilitas tugas

Contoh berikut menunjukkan cara menetapkan tugas dengan aturan visibilitas berikut:

• Menampilkan polyline rute jika kendaraan berada dalam jarak 3 perhentian.
• Menampilkan perkiraan waktu tiba jika jarak mengemudi yang tersisa lebih pendek dari 5.000 meter.
• Jangan pernah menampilkan jumlah perhentian yang tersisa.
• Setiap kolom lainnya mempertahankan visibilitas default yang ditampilkan saat kendaraan berada dalam jarak 5 perhentian dari tugas.

Lihat TaskTrackingViewConfig untuk gRPC atau REST.

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TASK_ID = "task-8241890";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Task settings
String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
Task task = Task.newBuilder()
  .setName(taskName)
  .setTaskTrackingViewConfig(
    TaskTrackingViewConfig.newBuilder()
      .setRoutePolylinePointsVisibility(
        VisibilityOption.newBuilder().setRemainingStopCountThreshold(3))
      .setEstimatedArrivalTimeVisibility(
        VisibilityOption.newBuilder().remainingDrivingDistanceMetersThreshold(5000))
      .setRemainingStopCountVisibility(
        VisibilityOption.newBuilder().setNever(true)))
  .build();

// Task request
UpdateTaskRequest updateTaskRequest =
  UpdateTaskRequest.newBuilder()  // No need for the header
      .setTask(task)
      .setUpdateMask(FieldMask.newBuilder().addPaths("taskTrackingViewConfig"))
      .build();

try {
  Task updatedTask = deliveryService.updateTask(updateTaskRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
      case NOT_FOUND:
        break;
      case PERMISSION_DENIED:
        break;
  }
  return;
}

# Set JWT, PROJECT_ID, and TASK_ID in the local environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=taskTrackingViewConfig" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
{
  "taskTrackingViewConfig": {
    "routePolylinePointsVisibility": {
      "remainingStopCountThreshold": 3
    },
    "estimatedArrivalTimeVisibility": {
      "remainingDrivingDistanceMetersThreshold": 5000
    },
    "remainingStopCountVisibility": {
      "never": true
    }
  }
}
EOM

Langkah berikutnya

• Memperbarui tugas
• Memfinalisasi tugas