|
เอกสารนี้ครอบคลุมช่องยานพาหนะที่สำคัญซึ่งคุณอัปเดตได้เมื่อสร้างและจัดการยานพาหนะ
|
ดูรายการฟิลด์ยานพาหนะทั้งหมดได้ที่ |
ฟิลด์แอตทริบิวต์ของยานพาหนะ
ใช้ช่องยานพาหนะ attributes เพื่อสร้างเกณฑ์ที่กำหนดเองเพื่อให้ผู้บริโภคหรือผู้ดำเนินการเดินรถค้นหายานพาหนะในฟลีตของคุณผ่านเกณฑ์การค้นหาที่หลากหลายมากขึ้น วิธีนี้จะช่วยเพิ่มความสามารถของแอปในการค้นหายานพาหนะที่ตรงกันดีกว่าการใช้เกณฑ์การค้นหาตามช่องยานพาหนะอื่นๆ เพียงอย่างเดียว ยานพาหนะแต่ละคันจะมีแอตทริบิวต์ได้สูงสุด 100 รายการ และแต่ละรายการต้องมีคีย์ที่ไม่ซ้ำกัน ค่าอาจเป็นสตริง บูลีน หรือตัวเลข
เช่น คุณอาจประกาศแอตทริบิวต์ที่กำหนดเองชื่อ zone เพื่อแยกความแตกต่างของโซนในเมืองที่ยานพาหนะนำส่งของคุณทำงาน คุณจะใช้ค่าสตริง เช่น 1B, 2C และ 3A เพื่อแสดงโซนต่างๆ ได้ จากนั้นคุณอาจใช้ตัวกรองในการติดตามยานพาหนะเพื่อแสดงเฉพาะยานพาหนะที่ทำงานในโซนหนึ่งๆ ให้แก่ผู้ปฏิบัติงานที่รับผิดชอบโซนนั้น
อย่างไรก็ตาม ค่าแอตทริบิวต์ที่กำหนดเองไม่จำเป็นต้องแยกกัน คุณอาจใช้เกณฑ์ เช่น available-at-night และ has-refrigeration รายการเหล่านี้แต่ละรายการอาจเป็นแอตทริบิวต์ที่กำหนดเองแยกต่างหากซึ่งใช้ค่าบูลีน ยานพาหนะหนึ่งๆ อาจได้รับการกำหนดแอตทริบิวต์ที่กำหนดเองทั้ง 3 รายการนี้ พร้อมกับแอตทริบิวต์ที่กำหนดเองโซนที่ตั้งค่าเป็นสตริงค่าที่เหมาะสม
อัปเดตแอตทริบิวต์ของยานพาหนะ
คีย์ attributes แต่ละรายการจะมีค่าได้เพียงค่าเดียวต่อยานพาหนะ คุณจะประกาศแอตทริบิวต์ยานพาหนะที่กำหนดเองได้โดยใช้ attributes ในมาสก์ฟิลด์ จากนั้นระบุค่าตามวิธีการด้านล่าง
UpdateDeliveryVehicle API นี้ไม่อนุญาตให้อัปเดตเพียงแอตทริบิวต์เดียว เมื่อใช้วิธีการนี้ การใช้ช่อง attributes ในมาสก์ช่องจะส่งผลให้มีการประกาศแอตทริบิวต์ทั้งชุดของยานพาหนะอีกครั้ง ซึ่งจะส่งผลให้มีการเขียนทับแอตทริบิวต์ที่มีอยู่เดิมที่ไม่ได้รวมอยู่ในมาสก์ช่องอย่างชัดเจน หากใช้วิธีการนี้เพื่อประกาศแอตทริบิวต์ที่กำหนดเองใหม่ คุณต้องประกาศแอตทริบิวต์ที่กำหนดเองทุกรายการที่ต้องการให้ยานพาหนะเก็บไว้อีกครั้ง หากคุณยกเว้น attributes ในมาสก์ฟิลด์ วิธีการนี้จะเก็บแอตทริบิวต์ที่กำหนดเองที่มีอยู่ไว้ตามที่ได้กำหนดไว้ก่อนหน้านี้สำหรับยานพาหนะ
หากคุณใช้ attributes ในมาสก์ช่อง แต่ไม่ได้ตั้งค่า การดำเนินการดังกล่าวจะเทียบเท่ากับการนำแอตทริบิวต์ที่กำหนดเองทั้งหมดออกจากยานพาหนะ
ตัวอย่างการอัปเดตช่องยานพาหนะ
ส่วนนี้จะแสดงวิธีอัปเดตฟิลด์ยานพาหนะโดยใช้ UpdateDeliveryVehicleRequest ซึ่งมี update_mask เพื่อระบุฟิลด์ที่จะอัปเดต ดูรายละเอียดได้ในเอกสารประกอบของ Protocol Buffers เกี่ยวกับมาสก์ฟิลด์
การอัปเดตฟิลด์อื่นที่ไม่ใช่ last_location ต้องมีสิทธิ์ผู้ดูแลระบบการนำส่งเครื่องยนต์ของ Flank
ตัวอย่าง: ตั้งค่าแอตทริบิวต์ที่กำหนดเอง
ตัวอย่างนี้ระบุแอตทริบิวต์ใหม่ zone ดังที่ระบุไว้ในส่วนอัปเดตแอตทริบิวต์ยานพาหนะก่อนหน้านี้ การอัปเดตฟิลด์ attributes โดยใช้แนวทางนี้กำหนดให้คุณระบุแอตทริบิวต์ที่กำหนดเองทั้งหมดที่ต้องการเก็บไว้
ดังนั้นตัวอย่างจึงแสดงค่า available-at-night ที่เขียนขึ้นเพื่อรักษาไม่ให้มีการเขียนทับในระหว่างการดำเนินการอัปเดตที่ระบุช่อง attributes
ดูข้อมูลอ้างอิง 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