|
本文將說明建立及管理車輛時，可以更新的重要車輛欄位。
|
如需車輛欄位的完整清單，請參閱： |
車輛屬性欄位
使用車輛 attributes 欄位建立自訂條件，讓消費者或車隊營運商能夠根據多種搜尋條件，在你的車隊中找到車輛。這樣一來，應用程式就能提供更強大的功能，比起只使用其他車輛欄位的搜尋條件，提供更精準的車輛比對結果。每輛車輛最多可有 100 個屬性，且每個屬性都必須有專屬索引鍵。值可以是字串、布林值或數字。
舉例來說，您可以宣告名為「zone」的自訂屬性，用來區分運送車輛在城市中的哪個區域運作。您會使用字串值 (例如以下值) 來代表不同的區域：1B、2C 和 3A。接著，您可以在車隊追蹤中使用篩選器，只向負責該區域的操作員顯示在該區域內工作的車輛。
不過，自訂屬性值不必互斥。您可以使用「可在晚上入住」和「有冷藏設備」等條件。每個屬性都可以是使用布林值的個別自訂屬性。指定車輛可指派這三個自訂屬性，並將區域自訂屬性設為適當的字串值。
更新車輛屬性
每個 attributes 鍵每輛車只能有一個值。您可以使用欄位遮罩中的 attributes 宣告自訂車輛屬性，然後根據下列方法提供值。
這個 UpdateDeliveryVehicle API 不允許只更新單一屬性。使用此方法時，如果在欄位遮罩中使用 attributes 欄位，系統就會為車輛重新宣告整組車輛屬性。這會導致覆寫任何未明確納入欄位遮罩的現有屬性。如果您使用這個方法宣告新的自訂屬性，則必須重新宣告您希望車輛保留的每個自訂屬性。如果您在欄位遮罩中排除 attributes，則這個方法會保留先前為車輛定義的自訂屬性。如果您在欄位遮罩中使用 attributes，但未設定值，則系統會從車輛中移除所有自訂屬性。
更新車輛欄位範例
本節說明如何使用 UpdateDeliveryVehicleRequest 更新車輛欄位，其中包含 update_mask，可用於指出要更新的欄位。如需詳細資訊，請參閱通訊協定緩衝區說明文件中的「欄位遮罩」一節。
如要更新 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