REST Resource: providers.vehicles

Recurso: veículo

Metadados do veículo.

Representação JSON
{
  "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)
  }
}
Campos
name

string

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

vehicleState

enum (VehicleState)

O estado do veículo.

supportedTripTypes[]

enum (TripType)

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

currentTrips[]

string

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

lastLocation

object (VehicleLocation)

Último local informado do veículo.

maximumCapacity

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.

attributes[]

object (VehicleAttribute)

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

vehicleType

object (VehicleType)

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

licensePlate

object (LicensePlate)

Informações da placa do veículo.

route[]
(deprecated)

object (TerminalLocation)

Obsoleto: use Vehicle.waypoints.

currentRouteSegment

string

A polilinha que especifica o trajeto que o app do motorista pretende seguir para o próximo waypoint. Essa lista também é retornada no 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.

currentRouteSegmentTraffic

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.

currentRouteSegmentVersion

string (Timestamp format)

Apenas saída. Hora em que currentRouteSegment foi definido. Ela pode ser armazenada pelo cliente e transmitida em solicitações vehicles.get futuras para evitar rotas que não mudaram.

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".

currentRouteSegmentEndPoint

object (TripWaypoint)

O waypoint onde currentRouteSegment termina. Pode ser fornecido pelos motoristas em chamadas de vehicles.update como um waypoint da viagem completa, um waypoint LatLng ou como o último LatLng do currentRouteSegment. O Fleet Engine fará o possível para interpolar em um waypoint real se não for totalmente especificado. Este campo é ignorado em chamadas vehicles.update, a menos que currentRouteSegment também seja especificado.

remainingDistanceMeters

integer

A distância de carro restante do currentRouteSegment. Esse valor também é retornado no 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.

etaToFirstWaypoint

string (Timestamp format)

O HEC para a primeira entrada no campo waypoints. O valor não será especificado se o campo waypoints ou 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".

remainingTimeSeconds

integer

Somente entrada. O tempo restante do percurso do veículo currentRouteSegment. O valor não será especificado se o campo waypoints ou 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.

waypoints[]

object (TripWaypoint)

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

waypointsVersion

string (Timestamp format)

Apenas saída. Última vez 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 só seja retornado 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".

backToBackEnabled

boolean

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

navigationStatus

enum (NavigationStatus)

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

deviceSettings

object (DeviceSettings)

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

VehicleState

O estado de uma Vehicle.

Enums
UNKNOWN_VEHICLE_STATE Padrão, usado para estados de veículo não especificados ou não reconhecidos.
OFFLINE O veículo não está aceitando novas viagens. Observação: o veículo pode continuar operando nesse estado durante uma viagem atribuída a ele.
ONLINE O veículo está aceitando novas viagens.

VehicleAttribute

Descreve um atributo de veículo como um par de chave-valor. "key:value" não pode ter mais de 256 caracteres.

Representação JSON
{
  "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.
}
Campos
key

string

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

value

string

O valor do atributo.

Campo de união vehicle_attribute_value. O valor do atributo pode ser string, booleano ou duplo. vehicle_attribute_value pode ser apenas de um dos tipos a seguir:
stringValue

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, precisarão ser idênticos. Caso contrário, um erro será gerado. Ambos os campos são preenchidos nas respostas.

boolValue

boolean

Valor do atributo tipado booleano.

numberValue

number

Valor de atributo com dois tipos.

VehicleType

O tipo de veículo.

Representação JSON
{
  "category": enum (Category)
}
Campos
category

enum (Category)

Categoria do tipo de veículo

Categoria

Categorias de tipos de veículo

Enums
UNKNOWN Padrão, usado para categorias de veículos não especificadas ou não reconhecidas.
AUTO Um automóvel.
TAXI Qualquer veículo que funcione como táxi (normalmente licenciado ou regulamentado).
TRUCK Geralmente, um veículo com grande capacidade de armazenamento.
TWO_WHEELER Uma moto, ciclomoto ou outro veículo de duas rodas
BICYCLE Transporte impulsionado por humanos.
PEDESTRIAN Um transportador humano, normalmente caminhando ou correndo, viajando ao longo de vias para pedestres.

LicensePlate

As informações da placa do veículo. Para evitar o armazenamento de informações de identificação pessoal, apenas o mínimo de informações sobre a placa do carro é armazenado como parte da entidade.

Representação JSON
{
  "countryCode": string,
  "lastCharacter": string
}
Campos
countryCode

string

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

lastCharacter

string

O último dígito da placa do carro ou "-1" para indicar que nenhum valor numérico está presente na placa.

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

TrafficPolylineData

Condições de trânsito no trajeto esperado do veículo.

Representação JSON
{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}
Campos
trafficRendering

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.

VisualTrafficReportPolylineRendering

Descreve como os clientes devem colorir uma parte da polilinha ao longo do trajeto.

Representação JSON
{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}
Campos
roadStretch[]

object (RoadStretch)

Opcional. Trechos de estrada que precisam ser renderizados 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 definir o estilo, o cliente deve aplicar o padrão para o trajeto.

RoadStretch

Um trecho de via que precisa ser renderizado.

Representação JSON
{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}
Campos
style

enum (Style)

Obrigatório. O estilo a ser aplicado.

offsetMeters

integer

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

lengthMeters

integer

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

Estilo

O estilo do trânsito, que indica a velocidade do tráfego.

Enums
STYLE_UNSPECIFIED Nenhum estilo selecionado.
SLOWER_TRAFFIC O tráfego está diminuindo.
TRAFFIC_JAM Há um engarrafamento.

DeviceSettings

Informações sobre diversas configurações do dispositivo móvel.

Representação JSON
{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}
Campos
locationPowerSaveMode

enum (LocationPowerSaveMode)

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

isPowerSaveMode

boolean

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

isInteractive

boolean

Se o dispositivo está em um estado interativo.

batteryInfo

object (BatteryInfo)

Informações sobre o estado da bateria.

LocationPowerSaveMode

Como os recursos de localização são configurados para se comportar no dispositivo móvel quando os dispositivos "Economia de bateria" está ativado. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Enums
UNKNOWN_LOCATION_POWER_SAVE_MODE LocationPowerSaveMode indefinida
LOCATION_MODE_NO_CHANGE Os provedores de localização não devem ser afetados pela economia de bateria ou a economia de bateria está desativada.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF O provedor de localização com base em GPS deve ser desativado quando a economia de bateria estiver ativada e o dispositivo não estiver interativo.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF Todos os provedores de localização devem ser desativados quando a economia de bateria estiver ativada e o dispositivo não for interativo.
LOCATION_MODE_FOREGROUND_ONLY Todos os provedores de localização vão continuar disponíveis, mas as correções de local só vão ser fornecidas aos apps em primeiro plano.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF A localização não será desativada, mas o LocationManager vai limitar todas as solicitações a provedores quando o dispositivo não for interativo.

BatteryInfo

Informações sobre a bateria do dispositivo.

Representação JSON
{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}
Campos
batteryStatus

enum (BatteryStatus)

Status da bateria: cheia, carregando etc.

powerSource

enum (PowerSource)

Status da fonte de energia da bateria.

batteryPercentage

number

Porcentagem atual da bateria [0-100].

BatteryStatus

Status da bateria: cheia, carregando etc.

Enums
UNKNOWN_BATTERY_STATUS Status da bateria desconhecido.
BATTERY_STATUS_CHARGING A bateria está sendo carregada.
BATTERY_STATUS_DISCHARGING A bateria está descarregando.
BATTERY_STATUS_FULL A bateria está cheia.
BATTERY_STATUS_NOT_CHARGING A bateria não está carregando.
BATTERY_STATUS_POWER_LOW A bateria está com pouca energia.

PowerSource

Tipo de carregador usado para carregar a bateria.

Enums
UNKNOWN_POWER_SOURCE Fonte de energia desconhecida.
POWER_SOURCE_AC A fonte de energia é um carregador CA.
POWER_SOURCE_USB A fonte de energia é uma porta USB.
POWER_SOURCE_WIRELESS A fonte de energia não tem fio.
POWER_SOURCE_UNPLUGGED A bateria está desconectada.

Métodos

create

Instanciar um veículo novo associado a um provedor de transporte por aplicativo sob demanda ou de entregas.

get

Retorna um veículo do Fleet Engine.

list

Retorna uma lista paginada de veículos associados a um provedor que correspondem às opções da solicitação.
Retorna uma lista de veículos que correspondem às opções de solicitação.

update

Grava dados atualizados do veículo no Fleet Engine.

updateAttributes

Atualiza parcialmente os atributos de um veículo.