В этом документе рассматриваются важные поля транспортных средств, которые вы можете обновить при создании и управлении транспортными средствами.
| Полный список полей транспортного средства см. здесь: |
Поле атрибутов транспортного средства
Используйте поле attributes транспортного средства» для создания настраиваемых критериев, которые позволят вашим клиентам или операторам автопарков находить автомобили в вашем автопарке по более широкому спектру критериев поиска. Это расширяет возможности ваших приложений по предоставлению более точных результатов поиска по сравнению с использованием критериев поиска, основанных исключительно на других полях. У каждого транспортного средства может быть не более 100 атрибутов, и каждый должен иметь уникальный ключ. Значения могут быть строковыми, логическими или числовыми.
Например, вы можете объявить настраиваемый атрибут с именем «zone» , чтобы указать, в какой зоне города работают ваши автомобили доставки. Для обозначения различных зон можно использовать строковые значения, например, следующие: 1B , 2C и 3A . Затем можно использовать фильтр в Fleet Tracking, чтобы показывать оператору, ответственному за эту зону, только автомобили, работающие в определённой зоне.
Однако значения настраиваемых атрибутов не обязательно должны быть взаимоисключающими. Вы можете использовать такие критерии, как «доступно ночью» и «есть ли охлаждение» . Каждый из них может быть отдельным настраиваемым атрибутом, использующим логические значения. Транспортному средству можно назначить все три этих настраиваемых атрибута вместе с настраиваемым атрибутом «зона» , которому будет присвоено соответствующее строковое значение.
Обновить атрибуты транспортного средства
Каждый ключ attributes может иметь только одно значение для транспортного средства . Вы можете объявить пользовательские атрибуты транспортного средства, используя attributes в маске поля, а затем указать значения, используя метод, описанный ниже.
API UpdateDeliveryVehicle не позволяет обновлять только один атрибут. При использовании этого метода любое использование поля 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;
}
ОТДЫХ
# 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