Zaktualizuj pola pojazdu

Pole Stan pojazdu

System może ustawić stan pojazdu jako OFFLINE lub ONLINE. Na przykład: może ustawiać stan pojazdu na ONLINE codziennie o 9:00 i OFFLINE codziennie o 17:00.

Pole atrybutów pojazdu

Użyj pola Pojazd attributes, aby utworzyć niestandardowe kryteria, które umożliwią klientom lub operatorom floty znajdowanie pojazdów w Twojej flocie na podstawie większej liczby kryteriów wyszukiwania. Zwiększy to możliwości aplikacji, lepsze dopasowanie pojazdów w porównaniu do wartości z kryteriów wyszukiwania wyłącznie na podstawie innych danych dotyczących pojazdów. Każdy pojazd może mieć maksymalnie 100 atrybutów, a każdy z nich musi mieć unikalny klucz. Wartościami mogą być ciągi znaków, wartości logiczne czy liczby.

Możesz na przykład zadeklarować atrybut niestandardowy o nazwie class dla zróżnicuj samochody do wspólnych przejazdów na różnych poziomach klasowych. Aby reprezentować poziomy klasy pojazdu, użyj tych wartości ciągu znaków: ECONOMY, STANDARD i LUXURY.

Wartości atrybutów niestandardowych nie muszą się wykluczać. Możesz wykorzystanie kryteriów takich jak przyjazne zwierzętom, zakaz palenia i możliwość przebywania dłużej podróży. Każdy z nich może być osobnym atrybutem niestandardowym, który używa wartości logicznych. Do danego pojazdu można przypisać wszystkie 3 atrybuty niestandardowe z atrybutem niestandardowym class ustawionym na odpowiednią wartość ciągu znaków.

Użycie atrybutów w ten sposób zapewni Ci dostęp do różnorodnych funkcji przydatnych w na wyszukiwanie pojazdów o określonych potrzebach. Instrukcje korzystania z atrybutów niestandardowych jako filtrów zapytań znajdziesz w artykule Wyszukiwanie pojazdów.

Zaktualizuj atrybuty pojazdu

Atrybuty pojazdu możesz aktualizować za pomocą UpdateVehicle lub UpdateVehicleAttributes Każdy klucz attributes może mieć tylko jedną wartość na pojazdem. Niestandardowe atrybuty pojazdu deklarujesz za pomocą atrybutu attributes i podaj wartości zgodnie z poniższą metodą.

Przykład aktualizowania pól pojazdu

W tej sekcji dowiesz się, jak aktualizować pola pojazdu za pomocą UpdateVehicleRequest, które zawiera update_mask wskazujący, które pola należy zaktualizować. Szczegółowe informacje znajdziesz w dokumentacji Protocol Buffers na temat masek pól.

Aktualizacje pól innych niż last_location wymagają usługi Fleet Engine na żądanie Uprawnienia administratora.

Przykład: włączanie nowego typu podróży i atrybutu niestandardowego

Ten przykład umożliwia przejechanie back_to_back samochodem i określa nowy atrybut: class. Jak wspominaliśmy wcześniej w sekcji Aktualizowanie atrybutów pojazdu: aktualizacja pola attributes za pomocą tej metody wymaga wskazania wszystkich atrybutów niestandardowych, które chcesz zachować. W tym przykładzie widać więc: cash_only. wartość zapisana w celu zabezpieczenia jej przed zastąpieniem podczas aktualizacji. określające pole attributes.

Aby zaktualizować tylko wartość jednej pary atrybutu klucz-wartość, użyj funkcji UpdateVehicleAttributes i nie uwzględniaj pola attribute. w masce pola dla żądania UpdateVehicle.

Zapoznaj się z dokumentacją providers.vehicles.update dotyczącą interfejsów gRPC i 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

Co dalej?

• Aktualizowanie lokalizacji pojazdu