|
Este documento aborda campos importantes que você pode atualizar ao criar e gerenciar veículos.
|
Para uma lista completa de campos de veículos, consulte: |
Campo de atributos do veículo
Use o campo attributes do veículo para criar critérios personalizados que permitam que os
consumidores ou operadores de frota encontrem veículos na sua frota em uma variedade maior
de critérios de pesquisa. Isso melhora os recursos dos seus apps para
fornecer correspondências de veículos melhores do que as que você teria usando critérios de pesquisa
baseados apenas em outros campos de veículos. Cada veículo pode ter no máximo 100
atributos, e cada um precisa ter uma chave exclusiva. Os valores podem ser strings,
booleanos ou números.
Por exemplo, é possível declarar um atributo personalizado chamado zone para
diferenciar em qual zona da cidade seus veículos de entrega operam. Você usaria
valores de string como os seguintes para representar zonas diferentes: 1B,
2C e 3A. Em seguida, você pode usar um filtro no Fleet Tracking para mostrar apenas
os veículos que trabalham em uma zona específica para o operador responsável por ela.
No entanto, os valores de atributos personalizados não precisam ser mutuamente exclusivos. Você pode usar critérios como available-at-night e has-refrigeration. Cada uma delas pode ser um atributo personalizado separado que usa valores booleanos. Um determinado veículo pode receber todos esses três atributos personalizados, além do atributo personalizado zone definido como o valor de string apropriado.
Atualizar atributos do veículo
Cada chave attributes pode ter apenas um valor por veículo. Declare
atributos personalizados de veículos usando attributes na máscara de campo e, em seguida,
forneça valores com base no método abaixo.
Essa API UpdateDeliveryVehicle não permite atualizar apenas um atributo. Ao usar esse método, qualquer uso do campo attributes na
máscara de campo resulta na redeclaração do conjunto completo de atributos
do veículo. Isso resulta na substituição de qualquer atributo preexistente não
incluído explicitamente na máscara de campo. Se você usar esse método para declarar um novo atributo personalizado, também será necessário declarar novamente todos os atributos personalizados que você quer que o veículo mantenha. Se você excluir o attributes na máscara de campo, esse método vai deixar os atributos personalizados atuais como definidos anteriormente para o veículo.
Se você usar attributes na máscara de campo, mas sem definir valores, isso será
equivalente a remover todos os atributos personalizados do veículo.
Exemplo de atualização de campos de veículos
Nesta seção, mostramos como atualizar os campos do veículo usando
UpdateDeliveryVehicleRequest, que inclui um update_mask para indicar
quais campos serão atualizados. Consulte a documentação de buffers de protocolo sobre
máscaras de campo para mais detalhes.
As atualizações em campos que não sejam last_location exigem privilégios de administrador de entrega do Fleet Engine.
Exemplo: definir atributo personalizado
Este exemplo especifica um novo atributo: zone. Como observado em
Atualizar atributos do veículo anteriormente, para atualizar o campo attributes usando
essa abordagem, é necessário indicar todos os atributos personalizados que você quer manter.
Portanto, o exemplo mostra um valor available-at-night gravado para evitar que ele seja substituído durante uma operação de atualização que especifica o campo attributes.
Consulte a referência de 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