Esta página foi traduzida pela API Cloud Translation.

Introdução: criar veículos

Para informações gerais sobre como os veículos funcionam no Fleet Engine, consulte os seguintes guias na seção essencial do Fleet Engine:

A documentação desta seção descreve como criar e gerenciar veículos no Fleet Engine. Você cria veículos no ambiente do servidor do Fleet Engine para espelhar os veículos reais na operação real. Os veículos do Fleet Engine também precisam corresponder aos usados no sistema de back-end que você usa para atribuição e roteamento de veículos.

Você usa um método de criação para criar um recurso de veículo usando o gRPC ou o REST. Os nomes de campo neste guia usam a notação gRPC para simplificar.

Viagens sob demanda

CreateVehicleRequest (gRPC)
providers.vehicle.create (REST)
Recurso Vehicle (REST, gRPC)

Tarefas agendadas

CreateDeliveryVehicleRequest (gRPC)
providers.deliveryVehicles.create (REST)
DeliveryVehicle (REST, gRPC)

Solicitações de veículos

Para recursos de tarefas sob demanda e programadas, você cria e atualiza um veículo emitindo uma mensagem de solicitação com campos, resumida da seguinte maneira:

O pai: uma string associada ao ID do projeto do Google Cloud, usada para preencher o campo de nome da instância do veículo.
O ID do veículo: uma string exclusiva usada para preencher o campo name do veículo.

Observação: as strings de ID do veículo têm certas restrições de caracteres. Evite IDs de incremento automático e verifique se eles não contêm informações de identificação pessoal. Para detalhes sobre as restrições de caracteres, consulte o campo de ID do veículo para CreateVehicleRequest ou CreateDeliveryVehicleRequest.
Uma instância de veículo com os campos obrigatórios. Esses campos dependem do recurso do Fleet Engine que você usa.

As informações no corpo da solicitação variam de acordo com a natureza dela. Confira esses detalhes nos respectivos guias.

Tokens de autenticação e autorização

As solicitações para o Fleet Engine também precisam fornecer as credenciais de acesso corretas. Os exemplos neste guia têm as seguintes suposições:

Os exemplos do gRPC pressupõem o uso da biblioteca de autorização para Java.
Os exemplos REST ilustram um cabeçalho de solicitação HTTP, que precisa conter o campo Authorization com um valor de Bearer <token>, em que <token> é um token da Web JSON emitido por você.

Para mais detalhes, consulte os guias Configurar o Fleet Engine.

Campos de recursos de veículo

Um recurso de veículo tem os seguintes tipos de campos:

Campos somente de saída. Campos que são definidos pelo serviço como uma saída de outro método e não podem ser definidos diretamente. Um campo importante desse tipo é o name. O Fleet Engine ignora qualquer valor fornecido para o campo name do veículo de acordo com as orientações do Google AIP para IDs especificados pelo usuário. Se você fornecer valores para esses campos, o Fleet Engine vai retornar um erro.
Campos obrigatórios. Os veículos criados no serviço de viagens sob demanda exigem que alguns campos sejam definidos na criação. Os veículos criados no serviço de tarefas programadas não têm campos de recursos de veículo obrigatórios.
Campos opcionais. Ambos os serviços têm campos que podem ser definidos na criação ou depois. Elas podem ser encontradas no respectivo guia de referência do serviço que você usa.

Nome do veículo (somente saída)

O campo name é exatamente o mesmo para viagens sob demanda e serviços de tarefas programadas. O Fleet Engine define o campo ao criar o veículo com base em dois campos definidos na criação do veículo:

O pai: uma string associada ao ID do projeto do Google Cloud do formato providers/{provider}, em que {provider} é o ID do projeto do Cloud. Cada veículo criado para um determinado projeto terá o mesmo caminho pai.

O projeto do Cloud que você referencia aqui também precisa conter os papéis da conta de serviço do Fleet Engine para o serviço que você usa. Consulte Contas de serviço para ver uma lista dessas contas. O Fleet Engine não oferece suporte a acesso de vários projetos do Google Cloud.
O ID do veículo, que precisa ser exclusivo para todos os veículos da sua frota e ser uma string Unicode válida. Esse é o ID do recurso do veículo. As viagens sob demanda e as paradas programadas usam isso para associar uma viagem ou uma tarefa ao veículo que a realiza.

Em serviços baseados no Google Cloud, todas as APIs precisam representar recursos como strings. Consulte Nomeação de recursos no Fleet Engine para mais detalhes.

Identificadores exclusivos de entidade

O formato e o valor dos identificadores de entidade exclusivos usados em chamadas de recursos são opacos para o Fleet Engine. Verifique se o identificador não contém informações de identificação pessoal (PII), como o número de telefone do motorista.

Reutilização de veículos

Depois que um veículo conclui todas as paradas de um determinado itinerário, ele continua disponível para reutilização no Fleet Engine por 7 dias, o que significa que você pode reutilizar um veículo em dias úteis subsequentes sem precisar criar um novo. Sempre que você reutiliza um veículo, o Fleet Engine redefine a disponibilidade dele, e a contagem regressiva de 7 dias começa de novo.

A abordagem recomendada para manter um veículo disponível no Fleet Engine é atualizar o local em intervalos regulares. As atualizações da maioria dos outros campos na entidade Vehicle também vão estender a vida útil dela, desde que o novo valor do campo seja diferente do atual.

OBSERVAÇÃO: alguns campos na entidade Vehicle, como device_settings, são informações de depuração puras que não são mantidas pelo Fleet Engine. A atualização delas não prolonga a vida útil da entidade Vehicle.

Para melhorar a análise do sistema, é melhor reutilizar o mesmo pareamento de ID de motorista e veículo diariamente. Para fazer isso, use o mesmo ID do veículo associado ao motorista para paradas programadas anteriores ou viagens sob demanda.