REST Resource: providers.vehicles

{
  "name": string,
  "vehicleState": enum (VehicleState),
  "supportedTripTypes": [
    enum (TripType)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocation)
  },
  "maximumCapacity": integer,
  "attributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "vehicleType": {
    object (VehicleType)
  },
  "licensePlate": {
    object (LicensePlate)
  },
  "route": [
    {
      object (TerminalLocation)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentTraffic": {
    object (TrafficPolylineData)
  },
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeSeconds": integer,
  "waypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "waypointsVersion": string,
  "backToBackEnabled": boolean,
  "navigationStatus": enum (NavigationStatus),
  "deviceSettings": {
    object (DeviceSettings)
  }
}

string

Apenas saída. O nome exclusivo do veículo. O formato é providers/{provider}/vehicles/{vehicle}.

enum (VehicleState)

O estado do veículo.

enum (TripType)

Tipos de viagem compatíveis com este veículo.

string

Apenas saída. Lista de tripId para viagens atribuídas a este veículo no momento.

object (VehicleLocation)

Último local informado do veículo.

integer

O número total de passageiros que este veículo pode transportar. O driver não é considerado nesse valor. O valor precisa ser maior ou igual a um.

object (VehicleAttribute)

Lista de atributos do veículo. Um veículo pode ter no máximo 100 atributos, e cada atributo precisa ter uma chave exclusiva.

object (VehicleType)

Obrigatório. O tipo do veículo. Pode ser usado para filtrar veículos em resultados de vehicles.search. Também influencia os cálculos de ETA e rota.

object (LicensePlate)

Informações da placa do veículo.

object (TerminalLocation)

Obsoleto: use Vehicle.waypoints.

string

A polilinha que especifica o trajeto que o app do motorista pretende seguir para o próximo waypoint. Essa lista também é retornada em Trip.current_route_segment para todas as viagens ativas atribuídas ao veículo.

Observação: este campo é destinado apenas para uso pelo SDK do Driver. Ainda não há suporte para decodificação.

object (TrafficPolylineData)

Somente entrada. O Fleet Engine usa essas informações para melhorar o compartilhamento de jornadas. Observação: este campo é destinado apenas para uso pelo SDK do Driver.

string (Timestamp format)

Apenas saída. Hora em que currentRouteSegment foi definido. Ele pode ser armazenado pelo cliente e transmitido em solicitações vehicles.get futuras para evitar rotas de retorno que não foram alteradas.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

O waypoint onde currentRouteSegment termina. Isso pode ser fornecido pelos motoristas em chamadas vehicles.update como um ponto de passagem de viagem completo, um ponto de passagem LatLng ou como o último LatLng da currentRouteSegment. O Fleet Engine vai fazer o possível para interpolar para um waypoint real se ele não for totalmente especificado. Esse campo é ignorado em chamadas vehicles.update, a menos que currentRouteSegment também seja especificado.

integer

A distância de carro restante do percurso currentRouteSegment. Esse valor também é retornado em Trip.remaining_distance_meters para todas as viagens ativas atribuídas ao veículo. O valor não será especificado se o campo currentRouteSegment estiver vazio.

string (Timestamp format)

O HEC para a primeira entrada no campo waypoints. O valor não será especificado se o campo waypoints estiver vazio ou o campo Vehicle.current_route_segment estiver vazio.

Ao atualizar um veículo, remainingTimeSeconds tem precedência sobre etaToFirstWaypoint na mesma solicitação.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

integer

Somente entrada. O tempo restante de percurso do veículo currentRouteSegment. O valor não será especificado se o campo waypoints estiver vazio ou o campo Vehicle.current_route_segment estiver vazio. Esse valor precisa corresponder a etaToFirstWaypoint - current_time se todas as partes estiverem usando o mesmo relógio.

Ao atualizar um veículo, remainingTimeSeconds tem precedência sobre etaToFirstWaypoint na mesma solicitação.

object (TripWaypoint)

Os waypoints restantes atribuídos a este veículo.

string (Timestamp format)

Apenas saída. Última vez em que o campo waypoints foi atualizado. Os clientes precisam armazenar esse valor em cache e transmiti-lo em GetVehicleRequest para garantir que o campo waypoints seja retornado apenas se for atualizado.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

boolean

Indica se o motorista aceita viagens de ida e volta. Se true, vehicles.search pode incluir o veículo mesmo que ele esteja atribuído a uma viagem. O valor padrão é false.

enum (NavigationStatus)

O status de navegação do veículo.

object (DeviceSettings)

Somente entrada. Informações sobre as configurações do dispositivo móvel usado pelo motorista.

{
  "key": string,
  "value": string,

  // Union field vehicle_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field vehicle_attribute_value.
}

string

A chave do atributo. As chaves não podem conter dois-pontos (:).

string

O valor do atributo.

string

Valor do atributo tipado de string.

Observação: ele é idêntico ao campo value, que será descontinuado. Para os métodos de criação ou atualização, qualquer um dos campos pode ser usado, mas é altamente recomendável usar stringValue. Se stringValue e value forem definidos, eles precisarão ser idênticos ou um erro será gerado. Ambos os campos são preenchidos nas respostas.

boolean

Valor do atributo tipado booleano.

number

Valor de atributo com dois tipos.

{
  "category": enum (Category)
}

enum (Category)

Categoria do tipo de veículo

{
  "countryCode": string,
  "lastCharacter": string
}

string

Obrigatório. Código de país/região do CLDR. Por exemplo, US para os Estados Unidos ou IN para a Índia.

string

O último dígito da placa ou "-1" para indicar que não há valor numérico está presente na placa.

• "ABC 1234" -> "4"
• "AB 123 CD" -> "3"
• "ABCDEF" -> "-1"

{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}

object (VisualTrafficReportPolylineRendering)

Uma renderização de polilinha que mostra a velocidade do trânsito para todas as regiões ao longo de um trecho de uma viagem com o cliente.

{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}

object (RoadStretch)

Opcional. Trecho de via que precisa ser renderizado ao longo da polilinha. Os trechos não se sobrepõem e não abrangem necessariamente todo o trajeto.

Na ausência de um trecho de estrada para estilizar, o cliente deve aplicar o padrão da rota.

{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}

enum (Style)

Obrigatório. O estilo a ser aplicado.

integer

Obrigatório. O estilo precisa ser aplicado entre [offsetMeters, offsetMeters + lengthMeters).

integer

Obrigatório. O tamanho do caminho em que o estilo será aplicado.

{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}

enum (LocationPowerSaveMode)

Como os recursos de localização são configurados para se comportar no dispositivo quando a Economia de bateria está ativada.

boolean

Se o dispositivo está no modo de economia de energia no momento.

boolean

Se o dispositivo está em um estado interativo.

object (BatteryInfo)

Informações sobre o estado da bateria.

{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}

enum (BatteryStatus)

Status da bateria, se está cheia ou carregando etc.

enum (PowerSource)

Status da fonte de energia da bateria.

number

Porcentagem atual da bateria [0-100].