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