W tym dokumencie omawiamy ważne kwestie związane z pojazdami, które można aktualizować podczas tworzenia pojazdów i zarządzania nimi.
|
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