Perbarui kolom kendaraan pengiriman

Dokumen ini mencakup kolom kendaraan penting yang dapat Anda saat membuat dan mengelola kendaraan.

  • type: Jenis kendaraan pengiriman ini. Hal ini memengaruhi rute yang dihasilkan untuk kendaraan ini.
  • attributes[]: Array opsi DeliveryVehicleAttribute. Gunakan parameter ini untuk menentukan kriteria kustom bagi kendaraan di layanan Anda guna meningkatkan perilaku pemfilteran saat menelusuri atau mencantumkan kendaraan.
 

Untuk mengetahui daftar lengkap kolom kendaraan, lihat:

Kolom atribut kendaraan

Gunakan kolom attributes kendaraan untuk membuat kriteria yang disesuaikan agar konsumen atau operator armada Anda dapat menemukan kendaraan di armada Anda di berbagai kriteria penelusuran yang lebih luas. Hal ini meningkatkan kemampuan aplikasi Anda untuk memberikan pencocokan kendaraan yang lebih baik daripada yang Anda lakukan dengan menggunakan kriteria penelusuran yang hanya didasarkan pada kolom kendaraan lainnya. Setiap kendaraan dapat memiliki maksimal 100 dan masing-masing harus memiliki kunci yang unik. Nilai-nilai bisa berupa {i>string<i}, boolean, atau angka.

Misalnya, Anda dapat mendeklarasikan atribut khusus yang disebut zona untuk membedakan zona kota tempat kendaraan pengiriman Anda beroperasi. Anda akan gunakan nilai string seperti berikut untuk merepresentasikan zona yang berbeda: 1B, 2C, dan 3A. Kemudian, Anda dapat menggunakan filter di Pelacakan Fasilitas untuk hanya menampilkan kendaraan yang beroperasi di zona tertentu kepada operator yang bertanggung jawab atas zona tersebut.

Namun, nilai atribut khusus tidak harus saling eksklusif. Anda mungkin gunakan kriteria seperti available-at-night dan has-refrigeration. Tiap-tiap dapat berupa atribut khusus terpisah yang menggunakan nilai boolean. Kendaraan tertentu dapat diberi ketiga atribut kustom ini beserta atribut kustom zona yang ditetapkan ke nilai string yang sesuai.

Memperbarui atribut kendaraan

Setiap kunci attributes hanya dapat memiliki satu nilai per kendaraan. Anda menyatakan atribut kendaraan khusus menggunakan attributes dalam mask kolom, lalu memberikan nilai berdasarkan metode di bawah ini.

API UpdateDeliveryVehicle ini tidak mengizinkan pembaruan hanya satu atribut. Saat menggunakan metode ini, penggunaan kolom attributes dalam mask kolom akan menyebabkan seluruh kumpulan atribut kendaraan dideklarasikan ulang untuk kendaraan. Hal ini akan mengakibatkan menimpa atribut yang sudah ada dan tidak disertakan secara eksplisit dalam mask kolom. Jika menggunakan metode ini untuk mendeklarasikan atribut kustom baru, Anda juga harus mendeklarasikan ulang setiap atribut kustom yang ingin dipertahankan kendaraan. Jika Anda mengecualikan attributes dalam mask kolom, meninggalkan atribut khusus yang ada seperti yang ditentukan sebelumnya untuk kendaraan. Jika Anda menggunakan attributes dalam mask kolom, tetapi tanpa menetapkan nilai, itu adalah setara dengan menghapus semua atribut khusus dari kendaraan.

Contoh pembaruan kolom kendaraan

Bagian ini menunjukkan cara memperbarui kolom kendaraan menggunakan UpdateDeliveryVehicleRequest, yang menyertakan update_mask untuk menunjukkan {i>field<i} mana yang akan diperbarui. Lihat dokumentasi Buffering Protokol tentang mask kolom untuk mengetahui detailnya.

Pembaruan pada kolom selain last_location memerlukan hak istimewa Admin Pengiriman Mesin Flotte.

Contoh: menetapkan atribut kustom

Contoh ini menentukan atribut baru: zone. Seperti yang disebutkan dalam Memperbarui atribut kendaraan sebelumnya, memperbarui kolom attributes menggunakan pendekatan ini mengharuskan Anda menunjukkan semua atribut kustom yang ingin dipertahankan. Oleh karena itu, contoh ini menunjukkan nilai available-at-night yang ditulis untuk mencegahnya ditimpa selama operasi pembaruan yang menentukan kolom attributes.

Lihat referensi providers.deliveryVehicles.patch.

gRPC

  static final String PROJECT_ID = "my-delivery-co-gcp-project";
  static final String VEHICLE_ID = "vehicle-8241890";

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Vehicle settings
  String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
  DeliveryVehicle myDeliveryVehicle = DeliveryVehicle.newBuilder()
      .addAllAttributes(ImmutableList.of(
          DeliveryVehicleAttribute.newBuilder().setKey("zone").setValue("1B").build(),
          DeliveryVehicleAttribute.newBuilder().setKey("available-at-night").setValue("true").build()))
      .build();

  // DeliveryVehicle request
  UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
    UpdateDeliveryVehicleRequest.newBuilder()  // No need for the header
        .setName(vehicleName)
        .setDeliveryVehicle(myDeliveryVehicle)
        .setUpdateMask(FieldMask.newBuilder()
            .addPaths("attributes"))
        .build();

  try {
    DeliveryVehicle updatedDeliveryVehicle =
        deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case NOT_FOUND:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

REST

  # Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
  # environment
  curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=attributes" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}" \
    --data-binary @- << EOM
  {
      "attributes": [
        {"key": "zone", "value": "1B"},
        {"key": "available-at-night", "value": "true"}
      ]
  }
  EOM

Langkah berikutnya