Обновить поля транспортного средства

Поле состояния транспортного средства

Ваша система может устанавливать состояние автомобиля в положение OFFLINE или ONLINE . Например, вы можете устанавливать состояние автомобиля в ONLINE каждый день в 9:00 и OFFLINE каждый день в 17:00.

Поле «Атрибуты транспортного средства»

Используйте поле « attributes транспортного средства» для создания настраиваемых критериев, позволяющих вашим клиентам или операторам автопарка находить транспортные средства в вашем автопарке по более широкому спектру поисковых запросов. Это расширяет возможности ваших приложений, обеспечивая более точное соответствие транспортных средств по сравнению с поиском, основанным исключительно на других полях, относящихся к транспортным средствам. Каждое транспортное средство может иметь не более 100 атрибутов, и каждый из них должен иметь уникальный ключ. Значения могут быть строками, логическими значениями или числами.

Например, вы можете объявить пользовательский атрибут с именем class , чтобы различать автомобили для совместных поездок по классам. Для обозначения классов автомобилей вы будете использовать следующие строковые значения: ECONOMY , STANDARD и LUXURY .

Однако значения пользовательских атрибутов не обязательно должны быть взаимоисключающими. Вы можете использовать такие критерии, как « разрешено перевозить домашних животных» , «некурящий» и «возможность совершать длительные поездки» . Каждый из этих критериев может быть отдельным пользовательским атрибутом, использующим логические значения. Конкретному транспортному средству могут быть присвоены все три этих пользовательских атрибута, а также пользовательский атрибут класса , установленный на соответствующее строковое значение.

Использование атрибутов таким образом может предоставить вам широкий спектр функций, полезных для поиска транспортных средств для поездок с конкретными потребностями. Инструкции по использованию пользовательских атрибутов в качестве фильтров запроса см. в разделе «Поиск транспортных средств» .

Обновить характеристики транспортного средства

Вы можете обновлять атрибуты транспортного средства, используя либо UpdateVehicle , либо UpdateVehicleAttributes . Каждый ключ attributes может иметь только одно значение для каждого транспортного средства . Вы объявляете пользовательские атрибуты транспортного средства, используя attributes в маске поля, а затем указываете значения на основе описанного ниже метода.

Пример обновления полей транспортного средства

В этом разделе показано, как обновлять поля транспортного средства с помощью UpdateVehicleRequest , который включает параметр update_mask , указывающий, какие поля следует обновить. Более подробную информацию о масках полей см. в документации Protocol Buffers.

Для обновления полей, отличных от last_location требуются права администратора Fleet Engine по запросу .

Пример: включение нового типа поездки и пользовательского атрибута.

В этом примере включены back_to_back поездки для транспортного средства, а также указан новый атрибут: class . Как отмечалось ранее в разделе «Обновление атрибутов транспортного средства» , обновление поля attributes с помощью этого подхода требует указания всех пользовательских атрибутов, которые вы хотите сохранить. Поэтому в примере показано значение cash_only записанное таким образом, чтобы оно не было перезаписано во время операции обновления, которая указывает поле attributes .

Чтобы обновить только значение одной пары атрибутов «ключ-значение», используйте метод UpdateVehicleAttributes и не включайте поле attribute в маску поля для запроса UpdateVehicle .

См. справочник providers.vehicles.update для gRPC и REST .

static final String PROJECT_ID = "project-id";
static final String VEHICLE_ID = "vid-8241890";

VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);

String vehicleName = "providers/" + PROJECT_ID + "/vehicles/" + VEHICLE_ID;
Vehicle updatedVehicle = Vehicle.newBuilder()
    .setVehicleState(VehicleState.ONLINE)
    .addAllAttributes(ImmutableList.of(
        VehicleAttribute.newBuilder().setKey("class").setValue("ECONOMY").build(),
        VehicleAttribute.newBuilder().setKey("cash_only").setValue("false").build()))
    .setBackToBackEnabled(true)
    .build();

UpdateVehicleRequest updateVehicleRequest = UpdateVehicleRequest.newBuilder()
    .setName(vehicleName)
    .setVehicle(updatedVehicle)
    .setUpdateMask(FieldMask.newBuilder()
        .addPaths("vehicle_state")
        .addPaths("attributes")
        .addPaths("back_to_back_enabled"))
    .build();

try {
  Vehicle updatedVehicle =
      vehicleService.updateVehicle(updateVehicleRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:
      // Most implementations will call CreateVehicle in this case
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}
// If no Exception, Vehicle updated successfully.

curl -X PUT \
  "https://fleetengine.googleapis.com/v1/providers/project-id/vehicles/vid-8241890?updateMask=vehicle_state,attributes,back_to_back_enabled" \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  --data-binary @- << EOM
{
    "vehicleState": "ONLINE",
    "attributes": [
      {"key": "class", "value": "LUXURY"},
      {"key": "cash_only", "value": "false"}
    ],
    "backToBackEnabled": true
}
EOM

Что дальше?

• Обновить местоположение транспортного средства