Aktualizowanie pól pojazdu dostawczego

W tym dokumencie omawiamy ważne kwestie związane z pojazdami, które można aktualizować podczas tworzenia pojazdów i zarządzania nimi.

  • type: typ tego pojazdu dostawy. Ma to wpływ tras wygenerowanych dla tego pojazdu.
  • attributes[]: tablica opcji typu DeliveryVehicleAttribute Użyj ich, aby zdefiniować kryteria niestandardowe pojazdów w swojej usłudze i poprawić działanie filtrowania podczas wyszukiwania lub wyświetlania pojazdów.
 

Pełną listę pól dotyczących pojazdów znajdziesz w tych sekcjach:

Pole Atrybuty pojazdu

W polu attributes pojazdu możesz utworzyć niestandardowe kryteria, które umożliwią konsumentów lub operatorów flotowych, aby znajdować pojazdy we flocie w większej liczbie lokalizacji zróżnicowanych kryteriów wyszukiwania. Dzięki temu aplikacje mogą lepiej dopasowywać pojazdy niż przy użyciu kryteriów wyszukiwania opartych wyłącznie na innych polach pojazdu. Każdy pojazd może mieć maksymalnie 100 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 strefa, aby odróżnić strefy miasta, w których działają Twoje pojazdy dostawcze. Aby reprezentować różne strefy, użyj wartości ciągu znaków, takich jak 1B, 2C i 3A. Następnie możesz użyć filtra w obsłudze śledzenia floty, aby wyświetlać operatorowi odpowiedzialnemu za daną strefę tylko pojazdy pracujące w konkretnej strefie.

Wartości atrybutów niestandardowych nie muszą się wykluczać. Możesz użyć kryteriów takich jak available-at-night (dostępne w nocy) i has-refrigeration (posiada lodówkę). Każda z tych opcji może być oddzielnym atrybutem niestandardowym z wartościami logicznymi. dany pojazd. można przypisać wszystkie trzy takie atrybuty niestandardowe wraz z atrybutem zone w atrybucie niestandardowym ustawionym na odpowiednią wartość ciągu znaków.

Zaktualizuj atrybuty pojazdu

Każdy klucz attributes może mieć tylko 1 wartość na pojazd. Deklarujesz niestandardowych atrybutów pojazdu za pomocą atrybutu attributes w masce pola, a następnie podając wartości w sposób opisany poniżej.

Ten interfejs API UpdateDeliveryVehicle nie zezwala na aktualizowanie tylko jednego . Podczas korzystania z tej metody każde użycie pola attributes w parametrze powoduje ponowne zadeklarowanie całego zbioru atrybutów pojazdu dla pojazdu. Spowoduje to zastąpienie wszystkich wcześniejszych atrybutów, które nie zostały wyraźnie uwzględnione w masce pola. Jeśli używasz tej metody do zadeklarowania nowego , musisz też ponownie zadeklarować każdy atrybut niestandardowy, który ma być pojazdu do zachowania. Jeśli wykluczysz pole attributes w masce pola, ta metoda pozostawi dotychczasowe atrybuty niestandardowe w postaci zdefiniowanej wcześniej dla pojazdu. Jeśli używasz w masce pola attributes, ale nie ustawiasz wartości, jest to co odpowiada usunięciu z pojazdu wszystkich atrybutów niestandardowych.

Przykład aktualizowania pól pojazdu

Z tej sekcji dowiesz się, jak zaktualizować pola pojazdu za pomocą UpdateDeliveryVehicleRequest: zawiera element update_mask wskazujący które pola zaktualizować. Zapoznaj się z dokumentacją buforów protokołów w sekcji maski pola.

Aktualizacje pól innych niż last_location wymagają Fleet Engine Delivery Uprawnienia administratora.

Przykład: ustaw atrybut niestandardowy

W tym przykładzie określono nowy atrybut: zone. Jak już wspomnieliśmy w sekcji Aktualizowanie atrybutów pojazdu, aby zaktualizować pole attributes, musisz wskazać wszystkie atrybuty niestandardowe, które chcesz zachować. Dlatego w tym przykładzie widać wartość available-at-night zapisaną w celu jej zachowania. przed zastąpieniem podczas operacji aktualizacji, która określa attributes.

Zobacz odwołanie 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

Co dalej?