อัปเดตช่องยานพาหนะที่นำส่ง

ฟิลด์แอตทริบิวต์ของยานพาหนะ

ใช้ฟิลด์ attributes ของยานพาหนะเพื่อสร้างเกณฑ์ที่กำหนดเองเพื่อให้ผู้บริโภคหรือผู้ให้บริการยานพาหนะสามารถค้นหายานพาหนะในกองยานพาหนะของคุณตามเกณฑ์การค้นหาที่หลากหลายมากขึ้น ซึ่งจะช่วยเพิ่มขีดความสามารถของแอปในการแสดงยานพาหนะที่ตรงกันมากขึ้นกว่าการใช้เกณฑ์การค้นหาตามฟิลด์ยานพาหนะอื่นๆ เพียงอย่างเดียว ยานพาหนะแต่ละคันมีแอตทริบิวต์ได้สูงสุด 100 รายการ และแต่ละรายการต้องมีคีย์ที่ไม่ซ้ำกัน ค่าสามารถเป็นสตริง บูลีน หรือตัวเลข

ตัวอย่างเช่น คุณสามารถประกาศแอตทริบิวต์ที่กำหนดเองชื่อ zone เพื่อแยกแยะโซนต่างๆ ในเมืองที่ยานพาหนะสำหรับจัดส่งของคุณให้บริการ คุณจะใช้ค่าสตริง เช่น 1B, 2C และ 3A เพื่อแสดงโซนต่างๆ จากนั้นคุณสามารถใช้ตัวกรองใน Fleet Tracking เพื่อแสดงเฉพาะยานพาหนะที่ให้บริการในโซนที่เฉพาะเจาะจงแก่ผู้ให้บริการที่รับผิดชอบโซนนั้น

อย่างไรก็ตาม ค่าแอตทริบิวต์ที่กำหนดเองไม่จำเป็นต้องแยกกันอย่างสิ้นเชิง คุณอาจใช้เกณฑ์ เช่น available-at-night และ has-refrigeration แต่ละเกณฑ์เหล่านี้อาจเป็นแอตทริบิวต์ที่กำหนดเองแยกกันซึ่งใช้ค่าบูลีน ระบบอาจกำหนดแอตทริบิวต์ที่กำหนดเองทั้ง 3 รายการนี้ให้กับยานพาหนะคันหนึ่งๆ พร้อมกับแอตทริบิวต์ที่กำหนดเอง zone ที่ตั้งค่าเป็นค่าสตริงที่เหมาะสม

อัปเดตแอตทริบิวต์ของยานพาหนะ

คีย์ attributes แต่ละรายการจะมีค่าได้เพียงค่าเดียวต่อยานพาหนะ คุณประกาศแอตทริบิวต์ของยานพาหนะที่กำหนดเองโดยใช้ attributes ในฟิลด์มาสก์ แล้วระบุค่าตามวิธีด้านล่าง

API UpdateDeliveryVehicle นี้ไม่อนุญาตให้อัปเดตแอตทริบิวต์เดียวเท่านั้น เมื่อใช้วิธีนี้ การใช้ฟิลด์ attributes ในฟิลด์มาสก์จะส่งผลให้ระบบประกาศแอตทริบิวต์ของยานพาหนะทั้งชุด อีกครั้งสำหรับยานพาหนะ ซึ่งจะเขียนทับแอตทริบิวต์ที่มีอยู่ก่อนหน้านี้ซึ่งไม่ได้รวมไว้อย่างชัดแจ้งในฟิลด์มาสก์ หากคุณใช้วิธีนี้เพื่อประกาศแอตทริบิวต์ที่กำหนดเองใหม่ คุณต้องประกาศแอตทริบิวต์ที่กำหนดเองทุกรายการที่ต้องการให้ยานพาหนะเก็บไว้ด้วย หากคุณไม่รวม attributes ในฟิลด์มาสก์ วิธีนี้จะคงแอตทริบิวต์ที่กำหนดเองที่มีอยู่ไว้ตามที่กำหนดไว้ก่อนหน้านี้สำหรับยานพาหนะ หากคุณใช้ attributes ในฟิลด์มาสก์ แต่ไม่ได้ตั้งค่า ระบบจะถือว่าเป็นการนำแอตทริบิวต์ที่กำหนดเองทั้งหมดออกจากยานพาหนะ

ตัวอย่างการอัปเดตฟิลด์ยานพาหนะ

ส่วนนี้แสดงวิธีอัปเดตฟิลด์ยานพาหนะโดยใช้ UpdateDeliveryVehicleRequest ซึ่งมี update_mask เพื่อระบุฟิลด์ที่จะอัปเดต ดูรายละเอียดได้ที่เอกสารประกอบ Protocol Buffers เกี่ยวกับ ฟิลด์มาสก์

การอัปเดตฟิลด์อื่นๆ นอกเหนือจาก last_location ต้องได้รับสิทธิ์ ผู้ดูแลระบบการจัดส่ง Fleet Engine

ตัวอย่าง: ตั้งค่าแอตทริบิวต์ที่กำหนดเอง

ตัวอย่างนี้ระบุแอตทริบิวต์ใหม่คือ zone ดังที่ระบุไว้ใน อัปเดตแอตทริบิวต์ของยานพาหนะก่อนหน้านี้ การอัปเดตฟิลด์ attributes โดยใช้ วิธีนี้กำหนดให้คุณต้องระบุแอตทริบิวต์ที่กำหนดเองทั้งหมดที่ต้องการเก็บไว้ ดังนั้นตัวอย่างจึงแสดงค่า available-at-night ที่เขียนขึ้นเพื่อป้องกันไม่ให้ค่าดังกล่าวถูกเขียนทับระหว่างการดำเนินการอัปเดตที่ระบุฟิลด์ attributes

ดูข้อมูลอ้างอิง providers.deliveryVehicles.patch

  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;
  }

  # 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

ขั้นตอนถัดไป

• อัปเดตตำแหน่งของยานพาหนะสำหรับจัดส่ง