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

ช่องแอตทริบิวต์ยานพาหนะ

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

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

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

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

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

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

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

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

การอัปเดตฟิลด์อื่นที่ไม่ใช่ last_location จำเป็นต้องมี Fleet Engine Delivery สิทธิ์ของผู้ดูแลระบบ

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

ตัวอย่างนี้ระบุแอตทริบิวต์ใหม่: 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

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

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