Introdução: criar veículos

Para informações gerais sobre o funcionamento dos veículos no Fleet Engine, consulte o guias a seguir na seção "Fundamentos do Fleet Engine":

A documentação nesta 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 em sua operação no mundo real. Seu motor de frota Os veículos também precisam corresponder àqueles usados no sistema de back-end que você para atribuições e trajetos de veículos.

Use um método de criação para criar um recurso de veículo usando gRPC ou REST. Para simplificar, os nomes dos campos neste guia usam a notação gRPC.

Viagens sob demanda

Tarefas agendadas

Solicitações de veículos

Para recursos de tarefas sob demanda e agendadas, é possível criar e atualizar veículo emitindo uma mensagem de solicitação com campos, resumidos da seguinte forma:

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

  2. ID do veículo: uma string exclusiva usada para preencher o name. do veículo.

  3. Uma instância de veículo com os campos obrigatórios. Esses campos dependem Capacidade do Fleet Engine que você usa.

As informações no corpo da solicitação variam de acordo com a natureza dela. Consulte 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 de gRPC pressupõem o uso da biblioteca de autorização para Java.
  • Exemplos de REST ilustram um cabeçalho de solicitação HTTP, que deve conter a campo Authorization com um valor de Bearer <token>, em que <token> é um JSON Web Token emitido.

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

Campos de recursos do 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 pode ser definido diretamente. Um campo importante dessa O tipo é o campo name. O Fleet Engine ignora os valores fornecidos para o Campo name do veículo conforme orientação da AIP do Google para especificado pelo usuário IDs. Se você fornecer valores para esses campos, a Fleet Engine retorna um erro.
  • Campos obrigatórios. Os veículos criados no serviço de viagem sob demanda precisam que determinados campos sejam definidos na criação. Veículos criados no serviço de tarefas não tem campos obrigatórios de recurso de veículo.
  • Campos opcionais. Ambos os serviços têm campos que podem ser definidos na criação ou depois. Eles podem ser encontrados no respectivo guia de referência para os serviço que você usa.

Nome do veículo (apenas saída)

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

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

    O projeto do Cloud mencionado aqui também precisa conter o Fleet Engine papéis da conta de serviço para o serviço que você usa. Consulte Contas de serviço para uma lista dessas contas de serviço. O Fleet Engine não aceita acesso de vários projetos do Google Cloud.

  • O ID do veículo, que precisa ser exclusivo em todos os veículos da sua frota e ser uma string Unicode válida. Este é o ID do recurso para veículo Tanto viagens sob demanda quanto paradas programadas usam esse recurso para associar um viagem ou tarefa com o veículo que a conclui.

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

Identificadores exclusivos de entidade

O formato e o valor dos identificadores exclusivos de entidade usados nas chamadas de recursos são opacas 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 permanece disponível para reutilização no Fleet Engine por 7 dias, ou seja, você pode reutilizar dias úteis subsequentes sem precisar criar um novo. Cada vez que você reutilizar um veículo, o Fleet Engine redefinirá a disponibilidade, quando A contagem regressiva de 7 dias começa de novo.

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

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

Para uma análise de sistema aprimorada, é melhor reutilizar o mesmo documento de identificação do veículo do motorista o pareamento de um dia para o outro. Para isso, use o mesmo ID do veículo associado ao o motorista de paradas programadas ou viagens sob demanda anteriores.

A seguir