Method: providers.vehicles.create

Instanciar um veículo novo associado a um provedor de transporte por aplicativo sob demanda ou de entregas. Cada Vehicle precisa ter um ID de veículo exclusivo.

Os campos Vehicle a seguir são obrigatórios ao criar um Vehicle:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Os campos Vehicle a seguir são ignorados durante a criação de um Vehicle:

  • name
  • currentTrips
  • availableCapacity
  • currentRouteSegment
  • currentRouteSegmentEndPoint
  • currentRouteSegmentVersion
  • currentRouteSegmentTraffic
  • route
  • waypoints
  • waypointsVersion
  • remainingDistanceMeters
  • remainingTimeSeconds
  • eta_to_next_waypoint
  • navigationStatus

Todos os outros campos são opcionais e usados se informados.

Solicitação HTTP

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Precisa estar no formato providers/{provider}. O provedor precisa ser o ID do projeto (por exemplo, sample-cloud-project) do projeto do Google Cloud do qual a conta de serviço que faz a chamada é membro.

Parâmetros de consulta

Parâmetros
header

object (RequestHeader)

O cabeçalho de solicitação padrão do Fleet Engine.
vehicleId

string

Obrigatório. ID exclusivo do veículo. Sujeito às seguintes restrições:

  • Precisa ser uma string Unicode válida.
  • Limitado a um tamanho máximo de 64 caracteres.
  • Normalizado de acordo com o Formulário C de normalização Unicode.
  • Não pode conter nenhum dos seguintes caracteres ASCII: '/', ':', '?', ',' ou '#'.

Corpo da solicitação

O corpo da solicitação contém uma instância de Vehicle.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Vehicle.