このドキュメントでは、追加可能な重要な車両フィールドについて説明します。 車両の作成と管理に役立ちます。
|
車両フィールドの完全なリストについては、以下をご覧ください。 |
車両属性フィールド
車両の attributes
フィールドを使用してカスタマイズされた条件を作成すると、消費者やフリート事業者は、さまざまな検索条件でフリート内の車両を見つけることができます。これにより、アプリの機能が強化され、
検索条件を使用した結果よりも車両の一致率が向上します
他の車両フィールドのみに基づいて生成されます。各車両に設定できる属性は最大 100 個で、それぞれに一意のキーが必要です。値は文字列、
ブール値、数値などです。
たとえば、zone というカスタム属性を宣言して、配送車両が運行する都市のゾーンを区別できます。あなたなら
ゾーンを表すには、1B
のような文字列値を使用します。
2C
、3A
。その後、フリート トラッキングでフィルタを使用して、
特定のゾーンで走行中の車両を
そのゾーンを担当するオペレーターに提供します
ただし、カスタム属性値は相互に排他的である必要はありません。available-at-night や has-refrigeration などの条件を使用できます。これらの ブール値を使用する個別のカスタム属性を指定できます。車両 ゾーンとともにこれら 3 つのカスタム属性をすべて割り当てることができます。 カスタム属性を適切な文字列値に設定します。
車両属性を更新する
各 attributes
キーに設定できる値は、車両ごとに 1 つのみです。カスタム車両属性を宣言するには、フィールドマスクで attributes
を使用し、次の方法に基づいて値を指定します。
この UpdateDeliveryVehicle
API では、1 つのファイルのみを更新することはできません。
属性です。このメソッドを使用する場合、attributes
フィールド マスクを使用すると、車両属性のセット全体が再宣言されます。
使用します。これにより、フィールド マスクに明示的に含まれていない既存の属性が上書きされます。このメソッドを使用して新しい
必要なカスタム属性をすべて再宣言する必要もあります。
確保できます。フィールド マスクで attributes
を除外すると、この方法では、車両に以前に定義された既存のカスタム属性がそのまま残ります。フィールド マスクで attributes
を使用し、値を設定しないと、次のようになります。
車両からすべてのカスタム属性を削除するのと同じ結果になります。
車両フィールドの更新例
このセクションでは、UpdateDeliveryVehicleRequest
を使用して車両フィールドを更新する方法について説明します。UpdateDeliveryVehicleRequest
には、更新するフィールドを示す update_mask
が含まれています。プロトコル バッファのドキュメントについては、
フィールド マスクをご覧ください。
last_location
以外のフィールドを更新するには、Fleet Engine Delivery が必要
Admin 権限が含まれます。
例: カスタム属性を設定する
この例では、新しい属性 zone
を指定しています。前述の車両属性を更新するで説明したように、この方法で attributes
フィールドを更新するには、保持するすべてのカスタム属性を指定する必要があります。そのため、この例では、attributes
フィールドを指定する更新オペレーション中に上書きされないように、available-at-night
値が書き込まれています。
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