Package maps.fleetengine.v1

BatteryStatus

Status da bateria: cheia, carregando etc.

PowerSource

Status da fonte de energia da bateria.

float

Porcentagem atual da bateria [0-100].

SpeedReadingInterval

Velocidade do trânsito no caminho desde o waypoint anterior até o waypoint atual.

string

O caminho que o motorista está seguindo do waypoint anterior até o atual. Esse caminho contém pontos de referência para que os clientes possam mostrar marcadores de trânsito ao longo do caminho (consulte speed_reading_interval). Ainda não há suporte para decodificação.

RequestHeader

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

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 de que a conta de serviço que está fazendo a chamada faz parte.

string

Obrigatório. ID exclusivo da viagem. 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 os seguintes caracteres ASCII: "/", ':', '?', ',' ou '#'.

Trip

Obrigatório. Entidade de viagem a ser criada.

Ao criar um grupo "Viagem", os seguintes campos são obrigatórios:

• trip_type
• pickup_point

Os campos a seguir serão usados se forem informados:

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

Todos os outros campos "Viagem" são ignorados. Por exemplo, todas as viagens começam com um trip_status de NEW, mesmo que você transmita um trip_status de CANCELED na solicitação de criação.

Apenas viagens de EXCLUSIVE aceitam intermediate_destinations.

Quando vehicle_id estiver definido para uma viagem compartilhada, você precisará fornecer a lista de Trip.vehicle_waypoints para especificar a ordem dos waypoints restantes para o veículo. Caso contrário, a ordem dos waypoints será indeterminada.

Quando você especifica Trip.vehicle_waypoints, a lista precisa conter todos os waypoints restantes das viagens do veículo, sem outros waypoints. Você precisa ordenar esses waypoints para que, em uma determinada viagem, o ponto de embarque fique antes dos destinos intermediários e todos os destinos intermediários fiquem antes do ponto de desembarque. Os waypoints de uma viagem EXCLUSIVE não podem ser intercalados com outras viagens.

Os campos trip_id, waypoint_type e location são usados, e todos os outros campos do TripWaypoint em vehicle_waypoints são ignorados.

RequestHeader

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

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 de que a conta de serviço que está fazendo a chamada faz parte.

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 os seguintes caracteres ASCII: "/", ':', '?', ',' ou '#'.

Vehicle

Obrigatório. A entidade "Veículo" a ser criada. Ao criar um veículo, os seguintes campos são obrigatórios:

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

Ao criar um veículo, os seguintes campos são ignorados:

• name
• currentTrips
• availableCapacity
• current_route_segment
• current_route_segment_end_point
• current_route_segment_version
• current_route_segment_traffic
• route
• waypoints
• waypoints_version
• remaining_distance_meters
• remaining_time_seconds
• eta_to_next_waypoint
• navigation_status

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

LocationPowerSaveMode

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

bool

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

bool

Se o dispositivo está em um estado interativo.

BatteryInfo

Informações sobre o estado da bateria.

RequestHeader

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

string

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

TripView

O subconjunto de campos Trip que deve ser retornado e a interpretação deles.

Timestamp

Indica o carimbo de data/hora mínimo (exclusivo) para o qual os dados Trip.route ou Trip.current_route_segment são recuperados. Se os dados do trajeto não tiverem sido alterados desde esse carimbo de data/hora, o campo do trajeto não será definido na resposta. Se um mínimo não for especificado, os dados de trajeto serão sempre recuperados.

Timestamp

Indica o carimbo de data/hora mínimo (exclusivo) para o qual Trip.remaining_waypoints são recuperados. Se eles não tiverem sido alterados desde esse carimbo de data/hora, os remaining_waypoints não serão definidos na resposta. Se esse campo não for especificado, remaining_waypoints será sempre recuperado.

PolylineFormatType

O formato do trajeto atual retornado, LAT_LNG_LIST_TYPE (em Trip.route) ou ENCODED_POLYLINE_TYPE (em Trip.current_route_segment). O padrão é LAT_LNG_LIST_TYPE.

Timestamp

Indica o carimbo de data/hora mínimo (exclusivo) para o qual Trip.current_route_segment_traffic é recuperado. Se os dados de tráfego não foram alterados desde esse carimbo de data/hora, o campo current_route_segment_traffic não é definido na resposta. Se um mínimo não for especificado, os dados de tráfego serão sempre recuperados. O tráfego só está disponível para clientes da solução de viagens e entregas sob demanda.

Timestamp

Indica o carimbo de data/hora mínimo (exclusivo) para o qual os dados Trip.remaining_waypoints.traffic_to_waypoint e Trip.remaining_waypoints.path_to_waypoint são recuperados. Se os dados não tiverem sido alterados desde esse carimbo de data/hora, os campos acima não serão definidos na resposta. Se remaining_waypoints_route_version não for especificado, o tráfego e o caminho serão sempre recuperados.

RequestHeader

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

string

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

Timestamp

Indica o carimbo de data/hora mínimo (exclusivo) para o qual Vehicle.current_route_segment é recuperado. Se a rota não for alterada desde esse carimbo de data/hora, o campo current_route_segment não será definido na resposta. Se um mínimo não for especificado, o current_route_segment será sempre recuperado.

Timestamp

Indica o carimbo de data/hora mínimo (exclusivo) para o qual os dados Vehicle.waypoints são recuperados. Se os waypoints não foram alterados desde o carimbo de data/hora, os dados de vehicle.waypoints não são definidos na resposta. Se esse campo não for especificado, vehicle.waypoints será sempre recuperado.

string

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

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”

RequestHeader

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

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 de que a conta de serviço que está fazendo a chamada faz parte.

int32

O número máximo de veículos a serem retornados. Valor padrão: 100.

string

O valor do next_page_token fornecido por uma chamada anterior para ListVehicles, para que você possa paginar grupos de veículos. O valor será indefinido se os critérios de filtro da solicitação não forem os mesmos da chamada anterior para ListVehicles.

Int32Value

Especifica a capacidade mínima exigida do veículo. Todos os veículos retornados terão um maximum_capacity maior ou igual a esse valor. Se definido, precisa ser maior ou igual a 0.

TripType

Restringe a resposta a veículos compatíveis com pelo menos um dos tipos de viagem especificados.

Duration

Restringe a resposta a veículos que enviaram atualizações de localização para o Fleet Engine no período especificado. Veículos parados que ainda transmitam suas localizações não são considerados desatualizados. Se presente, precisa ser uma duração positiva válida.

Category

Obrigatório. Restringe a resposta a veículos com uma das categorias de tipo especificadas. A política UNKNOWN não é permitida.

string

Os autores da chamada podem formar operações lógicas complexas usando qualquer combinação dos campos required_attributes, required_one_of_attributes e required_one_of_attribute_sets.

required_attributes é uma lista; O required_one_of_attributes usa uma mensagem que permite criar uma lista de listas. Em combinação, os dois campos permitem a composição desta expressão:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Restringe a resposta a veículos com os atributos especificados. Esse campo é uma operação de conjunção/E. São permitidos no máximo 50 required_attributes. Esse valor corresponde ao número máximo de atributos permitidos em um veículo. Cada string repetida precisa estar no formato "key:value".

string

Restringe a resposta a veículos com pelo menos um dos atributos especificados em cada VehicleAttributeList. Em cada lista, um veículo precisa corresponder a pelo menos um dos atributos. Esse campo é uma operação de disjunção/E inclusiva em cada VehicleAttributeList e uma operação de conjunção/E na coleção de VehicleAttributeList. Cada string repetida precisa estar no formato "key1:value1|key2:value2|key3:value3".

string

required_one_of_attribute_sets oferece mais funcionalidades.

Semelhante a required_one_of_attributes, required_one_of_attribute_sets usa uma mensagem que permite uma lista de listas, permitindo expressões como esta:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Restringe a resposta a veículos que correspondem a todos os atributos em uma VehicleAttributeList. Em cada lista, um veículo precisa corresponder a todos os atributos. Esse campo é uma operação de conjunção/E em cada VehicleAttributeList e uma operação inclusiva de disjunção/OU na coleção de VehicleAttributeList. Cada string repetida precisa estar no formato "key1:value1|key2:value2|key3:value3".

VehicleState

Restringe a resposta a veículos que têm esse estado.

bool

Só devolver os veículos com as viagens em andamento.

string

Opcional. Uma consulta de filtro para aplicar ao listar veículos. Consulte http://aip.dev/160 para ver exemplos de sintaxe de filtro.

Esse campo foi criado para substituir os campos required_attributes, required_one_of_attributes e required_one_of_attributes_sets. Se um valor não vazio for especificado aqui, os seguintes campos precisarão estar vazios: required_attributes, required_one_of_attributes e required_one_of_attributes_sets.

Esse filtro funciona como uma cláusula AND com outras restrições, como vehicle_state ou on_trip_only.

As únicas consultas aceitas são nos atributos do veículo (por exemplo, attributes.<key> = <value> ou attributes.<key1> = <value1> AND attributes.<key2> = <value2>). O número máximo de restrições permitido em uma consulta de filtro é 50.

Além disso, todos os atributos são armazenados como strings. Portanto, as únicas comparações compatíveis com os atributos são aquelas de strings. Para fazer uma comparação com valores numéricos ou booleanos, os valores precisam estar explicitamente entre aspas para serem tratados como strings (por exemplo, attributes.<key> = "10" ou attributes.<key> = "true").

Viewport

Opcional. Um filtro que limita os veículos retornados àqueles cujo último local conhecido estava na área retangular definida pela janela de visualização.

Vehicle

Veículos que correspondem aos critérios da solicitação. O número máximo de veículos retornados é determinado pelo campo page_size na solicitação.

string

Token para recuperar a próxima página de veículos ou vazia se não houver mais veículos que atendam aos critérios de solicitação.

int64

Obrigatório. Número total de veículos que correspondem aos critérios de solicitação em todas as páginas.

string

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

string

Obrigatório. Código do país com duas letras do país onde a viagem acontece. O preço é definido de acordo com o código do país.

BillingPlatformIdentifier

Plataforma em que a solicitação foi emitida.

string

Os identificadores diretamente relacionados à viagem que está sendo informada. Geralmente, são IDs (por exemplo, IDs de sessão) de operações de pré-reserva realizadas antes da disponibilização do ID da viagem. O número de related_ids é limitado a 50.

SolutionType

O tipo de solução de produto do GMP (por exemplo, ON_DEMAND_RIDESHARING_AND_DELIVERIES) usado na viagem informada.

string

O código de idioma BCP-47, como en-US ou sr-Latn. Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Se nenhum for especificado, a resposta poderá estar em qualquer idioma, com preferência para o inglês, se esse nome existir. Exemplo de valor do campo: en-US.

string

Obrigatório. Código regional CLDR da região de origem da solicitação. Exemplo de valor do campo: US.

string

Versão do SDK de chamada, se aplicável. O formato da versão é "major.minor.patch", exemplo: 1.1.2.

string

Versão do sistema operacional em que o SDK de chamada está sendo executado. Exemplos de valor de campo: 4.4.1, 12.1.

string

Modelo do dispositivo em que o SDK de chamada está sendo executado. Exemplos de valor de campo: iPhone12,1, SM-G920F.

SdkType

O tipo de SDK que envia a solicitação.

string

Versão do MapSDK da qual o SDK de chamada depende, se aplicável. O formato da versão é "major.minor.patch", exemplo: 5.2.1.

string

Versão do NavSDK de que o SDK de chamada depende, se aplicável. O formato da versão é "major.minor.patch", exemplo: 2.1.0.

Platform

Plataforma do SDK de chamada.

string

Fabricante do dispositivo Android do SDK de chamada, aplicável somente a SDKs do Android. Exemplo de valor de campo: Samsung.

int32

Nível da API do Android do SDK de chamada, aplicável apenas a SDKs do Android. Exemplo de valor de campo: 23.

string

ID opcional que pode ser fornecido para fins de registro em log a fim de identificar a solicitação.

RequestHeader

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

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 de que a conta de serviço que está fazendo a chamada faz parte.

string

O veículo associado às viagens na solicitação. Se não for especificado, as viagens retornadas não vão conter:

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

Se ela for definida como verdadeira, a resposta incluirá viagens que influenciam o trajeto de um motorista.

int32

Se ela não for definida, o servidor decidirá o número de resultados a serem retornados.

string

Defina-o como um valor retornado anteriormente no SearchTripsResponse para continuar dos resultados anteriores.

Duration

Se especificado, retorna as viagens que não foram atualizadas depois do horário (current - minimum_staleness).

Trip

A lista de viagens para o veículo solicitado.

string

Transmita esse token no SearchTripsRequest para percorrer os resultados da lista. A API retorna uma lista de viagens em cada chamada e, quando não restam mais resultados, a lista de viagens fica vazia.

RequestHeader

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

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 de que a conta de serviço que está fazendo a chamada faz parte.

TerminalLocation

Obrigatório. O ponto de encontro próximo ao qual pesquisar.

TerminalLocation

O local de entrega pretendido do cliente. O campo é obrigatório se trip_types contiver TripType.SHARED.

int32

Obrigatório. Define o raio de pesquisa do veículo ao redor do ponto de embarque. Somente veículos dentro do raio de pesquisa serão retornados. O valor precisa estar entre 400 e 10.000 metros (inclusive).

int32

Obrigatório. Especifica o número máximo de veículos a serem retornados. O valor precisa estar entre 1 e 50 (inclusive).

int32

Obrigatório. Especifica o número de passageiros considerados para uma viagem. O valor precisa ser maior ou igual a um. O driver não é considerado no valor da capacidade.

TripType

Obrigatório. Representa o tipo de viagem proposta. Precisa incluir exatamente um tipo. A política UNKNOWN_TRIP_TYPE não é permitida. Restringe a pesquisa apenas aos veículos compatíveis com esse tipo de viagem.

Duration

Restringe a pesquisa apenas aos veículos que enviaram atualizações de localização ao Fleet Engine no período especificado. Veículos parados que ainda transmitam suas localizações não são considerados desatualizados. Se esse campo não for definido, o servidor usará cinco minutos como valor padrão.

VehicleType

Obrigatório. Restringe a pesquisa a veículos com um dos tipos especificados. É necessário especificar pelo menos um tipo de veículo. VehicleTypes com uma categoria de UNKNOWN não são permitidos.

VehicleAttribute

Os autores da chamada podem formar operações lógicas complexas usando qualquer combinação dos campos required_attributes, required_one_of_attributes e required_one_of_attribute_sets.

required_attributes é uma lista; O required_one_of_attributes usa uma mensagem que permite criar uma lista de listas. Em combinação, os dois campos permitem a composição desta expressão:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Restringe a pesquisa apenas aos veículos com os atributos especificados. Esse campo é uma operação de conjunção/E. São permitidos no máximo 50 required_attributes. Esse valor corresponde ao número máximo de atributos permitidos em um veículo.

VehicleAttributeList

Restringe a pesquisa apenas aos veículos com pelo menos um dos atributos especificados em cada VehicleAttributeList. Em cada lista, um veículo precisa corresponder a pelo menos um dos atributos. Esse campo é uma operação de disjunção/E inclusiva em cada VehicleAttributeList e uma operação de conjunção/E na coleção de VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets oferece mais funcionalidades.

Semelhante a required_one_of_attributes, required_one_of_attribute_sets usa uma mensagem que permite uma lista de listas, permitindo expressões como esta:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Restringe a pesquisa apenas aos veículos com todos os atributos em uma VehicleAttributeList. Em cada lista, um veículo precisa corresponder a todos os atributos. Esse campo é uma operação de conjunção/E em cada VehicleAttributeList e uma operação inclusiva de disjunção/OU na coleção de VehicleAttributeList.

VehicleMatchOrder

Obrigatório. Especifica o critério de ordenação desejado para os resultados.

bool

Indica se veículos com uma única viagem ativa estão qualificados para essa pesquisa. Esse campo só é usado quando current_trips_present não é especificado. Quando current_trips_present não é especificado e esse campo é false, os veículos com viagens atribuídas são excluídos dos resultados da pesquisa. Quando current_trips_present não é especificado e esse campo é true, os resultados da pesquisa podem incluir veículos com uma viagem ativa com status ENROUTE_TO_DROPOFF. Quando current_trips_present é especificado, este campo não pode ser definido como verdadeiro.

O valor padrão é false.

string

Indica a viagem associada a este SearchVehicleRequest.

CurrentTripsPresent

Indica se veículos com viagens ativas estão qualificados para essa pesquisa. Precisa ser definido como algo diferente de CURRENT_TRIPS_PRESENT_UNSPECIFIED se trip_type incluir SHARED.

string

Opcional. Uma consulta de filtro para aplicar ao pesquisar veículos. Consulte http://aip.dev/160 para ver exemplos de sintaxe de filtro.

Esse campo foi criado para substituir os campos required_attributes, required_one_of_attributes e required_one_of_attributes_sets. Se um valor não vazio for especificado aqui, os seguintes campos precisarão estar vazios: required_attributes, required_one_of_attributes e required_one_of_attributes_sets.

Esse filtro funciona como uma cláusula AND com outras restrições, como minimum_capacity ou vehicle_types.

As únicas consultas aceitas são nos atributos do veículo (por exemplo, attributes.<key> = <value> ou attributes.<key1> = <value1> AND attributes.<key2> = <value2>). O número máximo de restrições permitido em uma consulta de filtro é 50.

Além disso, todos os atributos são armazenados como strings. Portanto, as únicas comparações compatíveis com os atributos são aquelas de strings. Para fazer uma comparação com valores numéricos ou booleanos, os valores precisam estar explicitamente entre aspas para serem tratados como strings (por exemplo, attributes.<key> = "10" ou attributes.<key> = "true").

VehicleMatch

Lista de veículos que correspondem aos critérios SearchVehiclesRequest, ordenados de acordo com o campo SearchVehiclesRequest.order_by.

int32

O índice inicial deste intervalo no caminho. No JSON, quando o índice for 0, o campo parecerá não preenchido.

int32

O índice final deste intervalo no caminho. No JSON, quando o índice for 0, o campo parecerá não preenchido.

Speed

Velocidade do tráfego neste intervalo.

LatLng

Obrigatório. Indica o local real.

Timestamp

Indica quando a parada aconteceu.

Timestamp

Somente entrada. Obsoleto. Use o campo de carimbo de data/hora.

LatLng

Obrigatório. Indica o local de um waypoint da viagem.

TerminalPointId

Obsoleto: especifique o campo point.

string

Obsoleto: especifique o campo point.

string

Obsoleto.

WaypointType

Descontinuado: Vehicle.waypoint terá estes dados.

string

Obsoleto.

string

Obsoleto.

string

Obsoleto.

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.

string

Apenas saída. Use o formato "providers/{provider}/trips/{trip}".

string

ID do veículo que faz essa viagem.

TripStatus

Status atual da viagem.

TripType

O tipo de viagem.

TerminalLocation

Local onde o cliente indica que ele será retirado.

StopLocation

Somente entrada. O local real quando e onde o cliente foi retirado. Este campo serve para o fornecedor enviar feedback sobre as informações de retirada.

StopLocation

Somente entrada. A hora e o local reais de chegada do motorista no ponto de embarque. Este campo serve para o fornecedor enviar feedback sobre as informações reais de chegada ao ponto de embarque.

Timestamp

Apenas saída. A hora futura estimada em que os passageiros embarcarão ou a hora real em que eles foram embarcados.

TerminalLocation

Paradas intermediárias para que a viagem solicite (além dos embarques e desembarques). Inicialmente, não haverá suporte para viagens compartilhadas.

Timestamp

Indica a última vez que o intermediate_destinations foi modificado. Seu servidor precisa armazenar esse valor em cache e transmiti-lo em UpdateTripRequest ao atualizar o intermediate_destination_index para garantir que o intermediate_destinations não seja modificado.

int32

Quando TripStatus for ENROUTE_TO_INTERMEDIATE_DESTINATION, um número entre [0..N-1] indica qual destino intermediário o veículo vai atravessar em seguida. Quando TripStatus for ARRIVED_AT_INTERMEDIATE_DESTINATION, um número entre [0..N-1] indica em qual destino intermediário o veículo está. O provedor define esse valor. Se não houver intermediate_destinations, este campo será ignorado.

StopLocation

Somente entrada. A hora e o local reais de chegada do motorista em um destino intermediário. Este campo serve para o provedor fornecer feedback sobre informações reais de chegada em destinos intermediários.

StopLocation

Somente entrada. A hora e o local reais quando e onde o cliente foi retirado de um destino intermediário. Este campo serve para o provedor enviar feedback sobre informações reais de embarque em destinos intermediários.

TerminalLocation

Local onde o cliente indica que será deixado.

StopLocation

Somente entrada. A hora e o local reais quando e onde o cliente foi deixado. Este campo serve para o provedor fornecer feedback sobre as informações reais de desembarque.

Timestamp

Apenas saída. A hora futura estimada em que os passageiros desembarcam no destino final ou a hora real em que desembarcam.

TripWaypoint

Apenas saída. O caminho completo do local atual até o ponto de desembarque, inclusive. Esse caminho pode incluir waypoints de outras viagens.

TripWaypoint

Este campo permite a ordenação manual dos waypoints da viagem. Ele contém todos os waypoints restantes do veículo atribuído, além dos waypoints de embarque e desembarque dessa viagem. Se a viagem não tiver sido atribuída a um veículo, o Fleet Engine vai ignorar esse campo. Por motivos de privacidade, esse campo só é preenchido pelo servidor nas chamadas UpdateTrip e CreateTrip, NÃO em chamadas GetTrip.

LatLng

Apenas saída. Trajeto previsto para esta viagem até a primeira entrada em quarter_waypoints. O primeiro waypoint pode pertencer a uma viagem diferente.

string

Apenas saída. Um caminho codificado para o próximo ponto de referência.

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

Timestamp

Apenas saída. Indica a última vez que o trajeto foi modificado.

Observação: este campo é destinado apenas para uso do SDK do Driver e do SDK do consumidor.

ConsumableTrafficPolyline

Apenas saída. Indica as condições de trânsito ao longo da current_route_segment quando eles estão disponíveis.

Observação: este campo é destinado apenas para uso do SDK do Driver e do SDK do consumidor.

Timestamp

Apenas saída. Indica a última vez que o current_route_segment_traffic foi modificado.

Observação: este campo é destinado apenas para uso do SDK do Driver e do SDK do consumidor.

TripWaypoint

Apenas saída. O waypoint onde current_route_segment termina.

Int32Value

Apenas saída. A distância de carro restante no campo current_route_segment. O valor não será especificado se a viagem não estiver atribuída a um veículo ou tiver sido concluída ou cancelada.

Timestamp

Apenas saída. O HEC até o próximo waypoint (a primeira entrada no campo remaining_waypoints). O valor não será especificado se a viagem não estiver atribuída a um veículo ou se estiver inativa (concluída ou cancelada).

Duration

Apenas saída. A duração do retorno dos dados de viagem ao horário em Trip.eta_to_first_waypoint. O valor não será especificado se a viagem não estiver atribuída a um veículo ou se estiver inativa (concluída ou cancelada).

Timestamp

Apenas saída. Indica a última vez que remaining_waypoints foi alterado (um waypoint foi adicionado, removido ou alterado).

Timestamp

Apenas saída. Indica a última vez que remaining_waypoints.path_to_waypoint e remaining_waypoints.traffic_to_waypoint foram modificados. Seu app cliente precisa armazenar esse valor em cache e transmiti-lo em GetTripRequest para garantir que os caminhos e o tráfego de remaining_waypoints sejam retornados somente se atualizados.

int32

Imutável. Indica o número de passageiros nesta viagem e não inclui o motorista. Um veículo precisa ter capacidade disponível para ser retornado em uma resposta SearchVehicles.

VehicleLocation

Apenas saída. Indica o último local relatado do veículo ao longo do trajeto.

bool

Apenas saída. Indica se o last_location do veículo pode ser vinculado ao current_route_segment. Falso se last_location ou current_route_segment não existir. Ele é calculado pelo Fleet Engine. Todas as atualizações de clientes serão ignoradas.

TripView

O subconjunto de campos "Viagem" preenchidos e como eles devem ser interpretados.

TerminalLocation

O local deste waypoint.

string

A viagem associada a este waypoint.

WaypointType

A função do waypoint na viagem, como embarque ou desembarque.

LatLng

O caminho do waypoint anterior até o waypoint atual. Indefinido para o primeiro ponto de referência de uma lista. Esse campo só é preenchido quando solicitado.

string

O caminho codificado do ponto de referência anterior até o waypoint atual.

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

ConsumableTrafficPolyline

As condições de trânsito ao longo do caminho até este waypoint. O tráfego está disponível apenas para clientes da solução de viagens e entregas da Plataforma Google Maps.

Int32Value

A distância do caminho do waypoint anterior até o waypoint atual. Indefinido para o primeiro ponto de referência de uma lista.

Timestamp

O horário previsto de chegada a este ponto de referência. Indefinido para o primeiro ponto de referência de uma lista.

Duration

O tempo de viagem do ponto de referência anterior até este ponto. Indefinido para o primeiro ponto de referência de uma lista.

RequestHeader

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

string

Obrigatório. Precisa estar no formato providers/{provider}/trips/{trip}. O provedor precisa ser o ID do projeto (por exemplo, sample-consumer-project) do projeto do Google Cloud de que a conta de serviço que está fazendo a chamada faz parte.

Trip

Obrigatório. A viagem associada à atualização.

Os campos a seguir são mantidos pelo Fleet Engine. Não os atualize usando Trip.update.

• current_route_segment
• current_route_segment_end_point
• current_route_segment_traffic
• current_route_segment_traffic_version
• current_route_segment_version
• dropoff_time
• eta_to_next_waypoint
• intermediate_destinations_version
• last_location
• name
• number_of_passengers
• pickup_time
• remaining_distance_meters
• remaining_time_to_first_waypoint
• remaining_waypoints
• remaining_waypoints_version
• route

Ao atualizar o Trip.vehicle_id de uma viagem compartilhada, você precisa fornecer a lista de Trip.vehicle_waypoints para especificar a ordem dos waypoints restantes. Caso contrário, a ordem será indeterminada.

Quando você especifica Trip.vehicle_waypoints, a lista precisa conter todos os waypoints restantes das viagens do veículo, sem outros waypoints. Você precisa ordenar esses waypoints para que, em uma determinada viagem, o ponto de embarque fique antes dos destinos intermediários e todos os destinos intermediários fiquem antes do ponto de desembarque. Os waypoints de uma viagem EXCLUSIVE não podem ser intercalados com outras viagens. Os campos trip_id, waypoint_type e location são usados, e todos os outros campos do TripWaypoint em vehicle_waypoints são ignorados.

Para evitar uma disputa em viagens com vários destinos, informe Trip.intermediate_destinations_version ao atualizar o status da viagem para ENROUTE_TO_INTERMEDIATE_DESTINATION. O Trip.intermediate_destinations_version transmitido precisa ser consistente com a versão do Fleet Engine. Se não estiver, a solicitação falhará.

FieldMask

Obrigatório. Máscara de campo que indica quais campos em "Viagem" serão atualizados. O update_mask precisa conter pelo menos um campo.

RequestHeader

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

string

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

VehicleAttribute

Obrigatório. Os atributos do veículo a serem atualizados. Os atributos não mencionados não são alterados nem removidos.

VehicleAttribute

Obrigatório. A lista completa atualizada de atributos do veículo, incluindo atributos novos, alterados e intactos.

RequestHeader

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

string

Obrigatório. Precisa estar no formato providers/{provider}/vehicles/{vehicle}. O {provider} precisa ser o ID do projeto (por exemplo, sample-cloud-project) do projeto do Google Cloud de que a conta de serviço que está fazendo a chamada faz parte.

Vehicle

Obrigatório. Os valores de entidade Vehicle a serem aplicados. Ao atualizar um Vehicle, os campos a seguir podem não ser atualizados porque são gerenciados pelo servidor.

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

Se o campo attributes for atualizado, todos os atributos do veículo serão substituídos pelos atributos fornecidos na solicitação. Se você quiser atualizar apenas alguns atributos, consulte o método UpdateVehicleAttributes.

Da mesma forma, o campo waypoints pode ser atualizado, mas precisa conter todos os waypoints atuais no veículo e nenhum outro.

FieldMask

Obrigatório. Uma máscara de campo que indica quais campos do Vehicle serão atualizados. É necessário fornecer pelo menos um nome de campo.

string

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

VehicleState

O estado do veículo.

TripType

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

string

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

VehicleLocation

Último local informado do veículo.

int32

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.

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

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

LicensePlate

Informações da placa do veículo.

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

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.

Timestamp

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

TripWaypoint

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

Int32Value

A distância de carro restante do current_route_segment. 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 current_route_segment estiver vazio.

Timestamp

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, remaining_time_seconds tem precedência sobre eta_to_first_waypoint na mesma solicitação.

Int32Value

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

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

TripWaypoint

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

Timestamp

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.

bool

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

NavigationStatus

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

DeviceSettings

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

Category

Categoria do tipo de veículo

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

bool

Valor do atributo tipado booleano.

double

Valor de atributo com dois tipos.

VehicleAttribute

Uma lista de atributos desta coleção.

LatLng

A localização do veículo. Quando ele é enviado ao Fleet Engine, a localização do veículo é uma localização de GPS. Quando você a recebe em uma resposta, a localização do veículo pode ser uma localização de GPS, um local complementar ou algum outro local aproximado. A origem é especificada em location_sensor.

DoubleValue

Obsoleto: use latlng_accuracy.

DoubleValue

Precisão de location em metros como um raio.

Int32Value

Direção em que o veículo está se movendo em graus. 0 representa Norte. O intervalo válido é [0,360).

DoubleValue

Obsoleto: use heading_accuracy.

DoubleValue

Precisão de heading em graus.

DoubleValue

Altitude em metros acima de WGS84.

DoubleValue

Obsoleto: use altitude_accuracy.

DoubleValue

Precisão de altitude em metros.

Int32Value

Velocidade do veículo em quilômetros por hora. Obsoleto: use speed.

DoubleValue

Velocidade do veículo em metros/segundo

DoubleValue

Precisão de speed em metros/segundo.

Timestamp

A hora em que location foi informado pelo sensor de acordo com o relógio dele.

Timestamp

Apenas saída. A hora em que o servidor recebeu as informações de local.

LocationSensor

Provedor de dados de local (por exemplo, GPS).

BoolValue

Indica se o location está alinhado a uma via.

BoolValue

Somente entrada. Indica se o sensor de GPS está ativado no dispositivo móvel.

Int32Value

Somente entrada. Tempo (em segundos) desde que esse local foi enviado pela primeira vez ao servidor. Esse valor será zero na primeira atualização. Se a hora for desconhecida (por exemplo, quando o app for reiniciado), esse valor será redefinido como zero.

Int32Value

Somente entrada. Obsoleto: outros indicadores agora são usados para determinar se um local está desatualizado.

LatLng

Localização do veículo sem dados (não processado pelo Snapper da Estrada).

Timestamp

Carimbo de data/hora associado ao local bruto.

LocationSensor

Origem da localização bruta. O valor padrão é GPS.

DoubleValue

Precisão de raw_location como um raio, em metros.

LatLng

Localização complementar fornecida pelo app de integração.

Timestamp

Carimbo de data/hora associado ao local complementar.

LocationSensor

Origem do local complementar. O valor padrão é CUSTOMER_SUPPLIED_LOCATION.

DoubleValue

Precisão de supplemental_location como um raio, em metros.

bool

Obsoleto: use is_road_snapped.

Vehicle

Obrigatório. Um veículo que corresponde à solicitação.

Timestamp

O HEC de carro do veículo até o ponto de embarque especificado na solicitação. Um valor vazio indica uma falha no cálculo do HEC do veículo. Se SearchVehiclesRequest.include_back_to_back era true e este veículo tem uma viagem ativa, vehicle_pickup_eta vai incluir o tempo necessário para concluir a viagem ativa atual.

Int32Value

A distância da localização atual do Veículo até o ponto de embarque especificado na solicitação, incluindo os pontos de embarque ou desembarque intermediários de viagens existentes. Essa distância compreende a distância de percurso (trajeto) calculada mais a distância em linha reta entre o ponto final da navegação e o ponto de embarque solicitado. A distância entre o ponto de destino da navegação e o ponto de embarque solicitado normalmente é pequena. Um valor vazio indica um erro no cálculo da distância.

Int32Value

Obrigatório. A distância em linha reta entre o veículo e o ponto de embarque especificado na solicitação.

Timestamp

O HEC completo do veículo até o ponto de desembarque especificado na solicitação. O ETA inclui parada em qualquer waypoint antes do dropoff_point especificado na solicitação. O valor só é preenchido quando um ponto de desembarque é especificado na solicitação. Um valor vazio indica um erro no cálculo do HEC.

Int32Value

A distância de carro (em metros) do veículo entre o ponto de embarque e o ponto de desembarque especificado na solicitação. A distância é apenas entre os dois pontos e não inclui a localização do veículo ou qualquer outro ponto que precise ser visitado antes da chegada do veículo ao ponto de embarque ou desembarque. O valor só será preenchido quando dropoff_point for especificado na solicitação. Um valor vazio indica uma falha no cálculo da distância do ponto de embarque ao desembarque especificado na solicitação.

TripType

Obrigatório. O tipo de viagem da solicitação que foi usada para calcular o HEC até o ponto de embarque.

Waypoint

A lista ordenada de waypoints usados para calcular o HEC. A lista inclui a localização e os pontos de embarque das viagens ativas do veículo e fornecidos na solicitação. Uma lista vazia indica uma falha no cálculo do HEC do veículo.

VehicleMatchType

Tipo de correspondência do veículo.

VehicleMatchOrder

A ordem solicitada para classificar as correspondências do veículo.

VehicleMatchOrder

O pedido real usado para este veículo. Normalmente, isso corresponde ao atributo 'order_by' da solicitação. No entanto, em determinadas circunstâncias, como um erro interno do servidor, outro método pode ser usado (como PICKUP_POINT_STRAIGHT_DISTANCE).

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.

Style

Obrigatório. O estilo a ser aplicado.

int32

Obrigatório. O estilo precisa ser aplicado entre [offset_meters, offset_meters + length_meters).

int32

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

LatLng

O local deste waypoint.

Timestamp

O tempo estimado que o veículo chegará a este waypoint.