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