Package maps.fleetengine.v1

BatteryStatus

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

PowerSource

Status da fonte de alimentação da bateria.

float

Porcentagem atual da bateria [0-100].

SpeedReadingInterval

Velocidade do trânsito ao longo do caminho do ponto de referência anterior até o atual.

string

O caminho que o motorista está fazendo do ponto de referência anterior até o atual. Esse caminho tem pontos de referência para que os clientes possam mostrar marcadores de trânsito ao longo dele (consulte speed_reading_interval). A decodificação ainda não é compatível.

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 faz essa chamada é membro.

string

Obrigatório. ID exclusivo da viagem. Sujeito às seguintes restrições:

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

Trip

Obrigatório. Entidade de viagem a ser criada.

Ao criar uma viagem, os seguintes campos são obrigatórios:

• trip_type
• pickup_point

Os seguintes campos serão usados se você os fornecer:

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

Todos os outros campos de 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.

Somente viagens de EXCLUSIVE são compatíveis com intermediate_destinations.

Quando vehicle_id é definido para uma viagem compartilhada, é necessário fornecer a lista de Trip.vehicle_waypoints para especificar a ordem dos pontos de parada restantes para o veículo. Caso contrário, a ordem dos pontos de parada será indeterminada.

Quando você especifica Trip.vehicle_waypoints, a lista precisa conter todos os pontos de parada restantes das viagens do veículo, sem pontos extras. É necessário ordenar esses pontos de referência de forma que, para uma determinada viagem, o ponto de partida seja antes dos destinos intermediários, e todos os destinos intermediários sejam antes do ponto de desembarque. Os pontos de referência de uma viagem EXCLUSIVE não podem se intercalar com outras viagens.

Os campos trip_id, waypoint_type e location são usados, e todos os outros campos 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 faz essa chamada é membro.

string

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

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

Vehicle

Obrigatório. A entidade "Vehicle" 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 se forem fornecidos.

RequestHeader

Opcional. 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 faz essa chamada é membro.

RequestHeader

Opcional. 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 faz essa chamada é membro.

LocationPowerSaveMode

Como os recursos de localização se comportam no dispositivo quando a Economia de bateria está ativada.

bool

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

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 faz essa chamada é membro.

TripView

O subconjunto de campos de viagem que precisam ser retornados e a interpretação deles.

Timestamp

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

Timestamp

Descontinuado: os Trip.remaining_waypoints são sempre recuperados. Use remaining_waypoints_route_version para controlar quando os dados de Trip.remaining_waypoints.traffic_to_waypoint e Trip.remaining_waypoints.path_to_waypoint são recuperados.

PolylineFormatType

O formato da rota atual retornada, 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 tiverem sido alterados desde esse carimbo de data/hora, o campo current_route_segment_traffic não será 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 de 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 faz essa chamada é membro.

Timestamp

Indica o carimbo de data/hora mínimo (exclusivo) para o qual Vehicle.current_route_segment é recuperado. Se a rota não tiver sido 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 sempre será recuperado.

Timestamp

Indica o carimbo de data/hora mínimo (exclusivo) para o qual os dados de Vehicle.waypoints são recuperados. Se os pontos de referência não tiverem sido alterados desde esse carimbo de data/hora, os dados de vehicle.waypoints não serão definidos na resposta. Se esse campo não for especificado, vehicle.waypoints sempre será 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 ou "-1" para indicar que não há valor numérico 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 faz essa chamada é membro.

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 necessária 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 que aceitam pelo menos um dos tipos de viagem especificados.

Duration

Restringe a resposta a veículos que enviaram atualizações de local para o Fleet Engine dentro da duração especificada. Veículos parados que ainda transmitem suas localizações não são considerados desatualizados. Se estiver 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 chamadores 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, e required_one_of_attributes usa uma mensagem que permite 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. Este campo é uma operação de conjunção/AND. São permitidos no máximo 50 required_attributes. Isso corresponde ao número máximo de atributos permitidos em um veículo. Cada string repetida precisa estar no formato "chave:valor".

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 disjunção inclusiva/operação OR em cada VehicleAttributeList e uma conjunção/operação AND em toda a 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.

Assim como 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 um VehicleAttributeList. Em cada lista, um veículo precisa corresponder a todos os atributos. Esse campo é uma operação de conjunção/AND em cada VehicleAttributeList e uma operação de disjunção inclusiva/OR em toda a 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

Retorna apenas os veículos com viagens em andamento.

string

Opcional. Uma consulta de filtro a ser aplicada ao listar veículos. Consulte http://aip.dev/160 para ver exemplos da 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 compatíveis são as de 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 permitidas em uma consulta de filtro é 50.

Além disso, todos os atributos são armazenados como strings. Portanto, as únicas comparações compatíveis são as de strings. Para comparar com valores numéricos ou booleanos, os valores precisam ser colocados entre aspas explicitamente 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 vazio se não houver mais veículos que atendam aos critérios da solicitação.

int64

Obrigatório. Número total de veículos que correspondem aos critérios da 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 faz essa chamada é membro.

string

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

BillingPlatformIdentifier

A plataforma em que a solicitação foi emitida.

string

Os identificadores diretamente relacionados à viagem que está sendo denunciada. Geralmente, são IDs (por exemplo, IDs de sessão) de operações de pré-reserva feitas antes que o ID da viagem esteja disponível. 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á ser em qualquer idioma, com preferência pelo inglês se esse nome existir. Exemplo de valor do campo: en-US.

string

Obrigatório. Código regional do 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", por exemplo: 1.1.2.

string

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

string

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

SdkType

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

string

Versão do MapSDK de que o SDK de chamada depende, se aplicável. O formato da versão é "major.minor.patch", por 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", por exemplo: 2.1.0.

Platform

Plataforma do SDK de chamada.

string

Fabricante do dispositivo Android do SDK de chamada. Aplicável apenas aos SDKs do Android. Exemplo de valor do campo: Samsung.

int32

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

string

ID opcional que pode ser fornecido para fins de geração de registros e 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 faz essa chamada é membro.

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 definido como "true", a resposta vai incluir viagens que influenciam a rota de um motorista.

int32

Se não for definido, o servidor vai decidir o número de resultados a serem retornados.

string

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

Duration

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

Trip

A lista de viagens do veículo solicitado.

string

Transmita esse token no SearchTripsRequest para paginar os resultados da lista. A API retorna uma lista de viagens em cada chamada, e quando não há mais resultados, a lista 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 faz essa chamada é membro.

TerminalLocation

Obrigatório. O ponto de retirada para pesquisar por perto.

TerminalLocation

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

int32

Obrigatório. Define o raio de pesquisa de veículos ao redor do ponto de coleta. 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 1. O motorista não é considerado no valor da capacidade.

TripType

Obrigatório. Representa o tipo de viagem proposta. É necessário incluir exatamente um tipo. A política UNKNOWN_TRIP_TYPE não é permitida. Restringe a pesquisa apenas aos veículos que podem fazer esse tipo de viagem.

Duration

Restringe a pesquisa apenas aos veículos que enviaram atualizações de localização para o Fleet Engine dentro da duração especificada. Veículos parados que ainda transmitem suas localizações não são considerados desatualizados. Se este 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. Não são permitidos VehicleTypes com uma categoria de UNKNOWN.

VehicleAttribute

Os chamadores 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, e required_one_of_attributes usa uma mensagem que permite 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. Este campo é uma operação de conjunção/AND. São permitidos no máximo 50 required_attributes. Isso 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 disjunção inclusiva/operação OR em cada VehicleAttributeList e uma conjunção/operação AND em toda a coleção de VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets oferece mais funcionalidades.

Assim como 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 um VehicleAttributeList. Em cada lista, um veículo precisa corresponder a todos os atributos. Esse campo é uma operação de conjunção/AND em cada VehicleAttributeList e uma operação de disjunção inclusiva/OR em toda a coleção de VehicleAttributeList.

VehicleMatchOrder

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

bool

Isso indica se os 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 este campo é true, os resultados da pesquisa podem incluir veículos com uma viagem ativa que tenha o status ENROUTE_TO_DROPOFF. Quando current_trips_present é especificado, esse campo não pode ser definido como verdadeiro.

O valor padrão é false.

string

Indica a viagem associada a este SearchVehicleRequest.

CurrentTripsPresent

Isso indica se os 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 a ser aplicada ao pesquisar veículos. Consulte http://aip.dev/160 para ver exemplos da 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 compatíveis são as de 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 permitidas em uma consulta de filtro é 50.

Além disso, todos os atributos são armazenados como strings. Portanto, as únicas comparações compatíveis são as de strings. Para comparar com valores numéricos ou booleanos, os valores precisam ser colocados entre aspas explicitamente 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, ordenada de acordo com o campo SearchVehiclesRequest.order_by.

int32

O índice inicial desse intervalo no caminho. Em JSON, quando o índice é 0, o campo parece não estar preenchido.

int32

O índice final desse intervalo no caminho. Em JSON, quando o índice é 0, o campo parece não estar preenchido.

Speed

Velocidade do trânsito 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

Indica o LatLng exato do waypoint. É preciso especificar point ou place como entrada. Se ambos forem especificados, point será usado para o roteamento e place para os metadados. Se apenas place for especificado como entrada, point será calculado com base em place e incluído na saída.

string

O nome do recurso do lugar que representa este local. O formato é places/{place_id}. É preciso especificar point ou place como entrada. Se ambos forem especificados, point será usado para o roteamento e place para os metadados. place só é incluído na saída se estiver na entrada. Isso significa que não há uma pesquisa de place em LatLng.

Este é um recurso experimental.

PointSource

Apenas saída. A origem do campo point.

TerminalPointId

Descontinuado: especifique o campo place.

string

Descontinuado: especifique o campo place.

string

Obsoleto.

WaypointType

Descontinuado: Vehicle.waypoint terá esses dados.

string

Obsoleto.

string

Obsoleto.

string

Obsoleto.

VisualTrafficReportPolylineRendering

Uma renderização de polilinha da velocidade do trânsito em todas as regiões ao longo de um trecho do trajeto de um cliente.

string

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

string

ID do veículo que está fazendo a viagem.

TripStatus

Status atual da viagem.

TripType

O tipo da viagem.

TerminalLocation

Local onde o cliente indica que vai ser buscado.

StopLocation

Somente entrada. O local exato em que o cliente foi buscado. Este campo é para o provedor enviar feedback sobre as informações reais de coleta.

StopLocation

Somente entrada. O horário e o local exatos da chegada do motorista ao ponto de encontro. Este campo é para o provedor enviar feedback sobre as informações de chegada no ponto de encontro.

Timestamp

Apenas saída. O horário estimado em que os passageiros serão buscados ou o horário real em que foram buscados.

TerminalLocation

Paradas intermediárias na ordem em que as viagens são solicitadas (além do embarque e desembarque). Inicialmente, isso não será compatível com viagens compartilhadas.

Timestamp

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

int32

Quando TripStatus é 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 é 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, esse campo será ignorado.

StopLocation

Somente entrada. O horário e o local reais da chegada do motorista a um destino intermediário. Este campo é para o provedor fornecer feedback sobre as informações de chegada reais em destinos intermediários.

StopLocation

Somente entrada. O horário e o local exatos em que o cliente foi buscado em um destino intermediário. Este campo é para o provedor enviar feedback sobre as informações de coleta reais em destinos intermediários.

TerminalLocation

Local onde o cliente indica que vai desembarcar.

StopLocation

Somente entrada. A hora e o local reais em que o cliente foi deixado. Este campo é para o provedor dar feedback sobre as informações reais de desembarque.

Timestamp

Apenas saída. O horário estimado em que os passageiros vão ser deixados no destino final ou o horário real em que foram deixados.

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

Esse campo permite a ordenação manual dos waypoints da viagem. Ele contém todos os pontos de parada restantes do veículo atribuído, bem como os pontos de parada de coleta e desembarque da 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 em chamadas UpdateTrip e CreateTrip, NÃO em chamadas GetTrip.

LatLng

Apenas saída. Rota prevista para esta viagem até a primeira entrada em "remaining_waypoints". O primeiro ponto de parada pode pertencer a outra viagem.

string

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

Observação: este campo é destinado apenas ao uso pelo SDK Driver e pelo SDK Consumer. Ainda não é possível fazer a decodificação.

Timestamp

Apenas saída. Indica a última vez que a rota foi modificada.

Observação: este campo é destinado apenas ao uso pelo SDK Driver e pelo SDK Consumer.

ConsumableTrafficPolyline

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

Observação: este campo é destinado apenas ao uso pelo SDK Driver e pelo SDK Consumer.

Timestamp

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

Observação: este campo é destinado apenas ao uso pelo SDK Driver e pelo SDK Consumer.

TripWaypoint

Apenas saída. O ponto de referência em que current_route_segment termina.

Int32Value

Apenas saída. A distância restante a ser percorrida no campo current_route_segment. O valor não é especificado se a viagem não for atribuída a um veículo ou se for concluída ou cancelada.

Timestamp

Apenas saída. A HEC para o próximo ponto de referência (a primeira entrada no campo remaining_waypoints). O valor não é especificado se a viagem não for atribuída a um veículo ou se estiver inativa (concluída ou cancelada).

Duration

Apenas saída. A duração desde o momento em que os dados da viagem são retornados até o horário em Trip.eta_to_first_waypoint. O valor não é especificado se a viagem não for 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 ponto de referência 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. O 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 só sejam retornados se forem 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 informado do veículo ao longo do trajeto.

bool

Apenas saída. Indica se o last_location do veículo pode ser ajustado ao current_route_segment. "False" se last_location ou current_route_segment não existir. Ele é calculado pelo Fleet Engine. Qualquer atualização dos clientes será ignorada.

TripView

O subconjunto de campos de viagem que são preenchidos e como eles devem ser interpretados.

TripAttribute

Uma lista de atributos personalizados de viagem. Cada atributo precisa ter uma chave exclusiva.

string

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

string

Valor do atributo do tipo string.

bool

Valor de atributo booleano digitado.

double

Valor de atributo digitado como double.

TerminalLocation

O local deste ponto de parada.

string

A viagem associada a este ponto de parada.

WaypointType

A função que este ponto de parada desempenha na viagem, como coleta ou desembarque.

LatLng

O caminho do ponto de referência anterior até o atual. Se for o primeiro ponto de parada, o trajeto será do local atual do veículo até o ponto de parada. Esse campo só é preenchido quando solicitado.

string

O caminho codificado do ponto de parada anterior até o atual.

Observação: este campo é destinado apenas ao uso pelo SDK Driver e pelo SDK Consumer. Ainda não é possível fazer a decodificação.

ConsumableTrafficPolyline

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

Int32Value

A distância do caminho do ponto de referência anterior até o atual. Se for o primeiro ponto de parada, a distância do trajeto será do local atual do veículo até o ponto de parada.

Timestamp

A hora estimada de chegada neste ponto de parada.

Duration

O tempo de viagem do ponto de parada anterior até este ponto de parada. Se for o primeiro ponto de parada, o tempo de viagem será do local atual do veículo até o ponto de parada.

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 faz essa chamada é membro.

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 pontos de parada restantes. Caso contrário, a ordem será indeterminada.

Quando você especifica Trip.vehicle_waypoints, a lista precisa conter todos os pontos de parada restantes das viagens do veículo, sem pontos extras. É necessário ordenar esses pontos de referência de forma que, para uma determinada viagem, o ponto de partida seja antes dos destinos intermediários, e todos os destinos intermediários sejam antes do ponto de desembarque. Os pontos de referência de uma viagem EXCLUSIVE não podem se intercalar com outras viagens. Os campos trip_id, waypoint_type e location são usados, e todos os outros campos TripWaypoint em vehicle_waypoints são ignorados.

Para evitar uma condição de corrida em viagens com vários destinos, forneça 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. Caso contrário, a solicitação falhará.

FieldMask

Obrigatório. A máscara de campo que indica quais campos da 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 faz essa chamada é membro.

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 não modificados.

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 faz essa chamada é membro.

Vehicle

Obrigatório. Os valores da entidade Vehicle a serem aplicados. Ao atualizar um Vehicle, os campos a seguir não podem 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 pontos de parada 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 informar o nome de pelo menos um campo.

string

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

VehicleState

O estado do veículo.

TripType

Tipos de viagem aceitos por este veículo.

string

Apenas saída. Lista de trip_ids para viagens atribuídas a este veículo.

VehicleLocation

Último local informado do veículo.

VehicleLocation

Somente entrada. Locais em que o veículo esteve no passado e que ainda não foram informados ao Fleet Engine. Usado no UpdateVehicleRequest para registrar locais que não puderam ser enviados ao servidor. Isso geralmente acontece quando o veículo não tem conectividade com a Internet.

int32

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

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

VehicleType

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

LicensePlate

Informações da placa do veículo.

TerminalLocation

Descontinuado: use Vehicle.waypoints.

string

A polilinha que especifica o trajeto que o app do motorista pretende fazer até o próximo ponto de parada. 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 ao uso pelo SDK Driver. Ainda não é possível fazer a decodificação.

TrafficPolylineData

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

Timestamp

Apenas saída. Hora em que current_route_segment foi definido. Ele pode ser armazenado pelo cliente e transmitido em futuras solicitações GetVehicle para evitar o retorno de rotas que não mudaram.

TripWaypoint

O ponto de referência em que current_route_segment termina. Ele pode ser fornecido pelos motoristas em chamadas UpdateVehicle como um ponto de parada completo da viagem, um ponto de parada LatLng ou como o último LatLng da current_route_segment. Em seguida, o Fleet Engine fará o possível para interpolar um ponto de parada real se ele não estiver totalmente especificado. Esse campo é ignorado nas chamadas UpdateVehicle, a menos que current_route_segment também seja especificado.

Int32Value

A distância restante para o current_route_segment. 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 current_route_segment estiver vazio.

Timestamp

A previsão de chegada 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 de viagem para o 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 pontos de parada restantes atribuídos a este veículo.

Timestamp

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

bool

Indica se o motorista aceita viagens consecutivas. Se true, 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 do dispositivo móvel usado pelo motorista.

Category

Categoria do tipo de veículo

string

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

string

O valor do atributo.

string

Valor do atributo do tipo string.

Observação: isso é idêntico ao campo value, que será descontinuado. Para 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, eles precisarão ser idênticos. Caso contrário, um erro será gerado. Ambos os campos são preenchidos nas respostas.

bool

Valor de atributo booleano digitado.

double

Valor de atributo digitado como double.

VehicleAttribute

Uma lista de atributos nesta coleção.

LatLng

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

DoubleValue

Descontinuado: 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 o norte. O intervalo válido é [0,360).

DoubleValue

Descontinuado: use heading_accuracy.

DoubleValue

Precisão de heading em graus.

DoubleValue

Altitude em metros acima do WGS84.

DoubleValue

Descontinuado: use altitude_accuracy.

DoubleValue

Precisão de altitude em metros.

Int32Value

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

DoubleValue

Velocidade do veículo em metros/segundo

DoubleValue

Precisão de speed em metros/segundo.

Timestamp

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

Timestamp

Apenas saída. O horário em que o servidor recebeu as informações de local.

LocationSensor

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

BoolValue

Indica se location está ajustado 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 ao servidor pela primeira vez. Esse valor será zero na primeira atualização. Se o horário for desconhecido (por exemplo, quando o app for reiniciado), esse valor será redefinido como zero.

Int32Value

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

LatLng

Localização bruta do veículo (não processada pelo ajuste de via).

Timestamp

Carimbo de data/hora associado ao local bruto.

LocationSensor

Origem do local bruto. O valor padrão é GPS.

DoubleValue

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

LatLng

O local do provedor de localização combinada do Android.

Timestamp

Atualizar o carimbo de data/hora de flp_location

DoubleValue

Precisão de flp_location em metros como um raio.

Int32Value

Direção em que o veículo está se movendo em graus, conforme determinado pelo provedor de localização combinada. 0 representa o norte. O intervalo válido é [0,360).

LatLng

Local complementar fornecido 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

Descontinuado: use is_road_snapped.

Vehicle

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

Timestamp

A estimativa de chegada do veículo ao ponto de encontro especificado na solicitação. Um valor vazio indica uma falha no cálculo da ETA do veículo. Se SearchVehiclesRequest.include_back_to_back era true e o veículo tem uma viagem ativa, vehicle_pickup_eta inclui 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 partida especificado na solicitação, incluindo pontos intermediários de partida ou desembarque para viagens atuais. Essa distância inclui a distância calculada de carro (trajeto) mais a distância em linha reta entre o ponto final da navegação e o ponto de encontro solicitado. A distância entre o ponto final da navegação e o ponto de embarque solicitado geralmente é 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 tempo estimado de chegada do veículo até o ponto de desembarque especificado na solicitação. A estimativa inclui paradas em todos os waypoints antes do dropoff_point especificado na solicitação. O valor só será preenchido quando um ponto de desistência for especificado na solicitação. Um valor vazio indica um erro no cálculo da ETA.

Int32Value

A distância percorrida pelo veículo (em metros) do ponto de embarque até 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 nem outros pontos que precisam ser visitados antes do ponto de coleta ou de entrega. O valor só será preenchido quando um dropoff_point for especificado na solicitação. Um valor vazio indica uma falha no cálculo da distância entre o ponto de coleta e o ponto de entrega especificados na solicitação.

TripType

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

Waypoint

A lista ordenada de pontos de referência usada para calcular a ETA. A lista inclui a localização do veículo, os pontos de coleta de viagens ativas para o veículo e os pontos de coleta fornecidos na solicitação. Uma lista vazia indica uma falha no cálculo da ETA do veículo.

VehicleMatchType

Tipo de correspondência de veículo.

VehicleMatchOrder

A ordem solicitada para classificar correspondências de veículos. É equivalente a ordered_by.

VehicleMatchOrder

A ordem solicitada para classificar correspondências de veículos. É equivalente a requested_ordered_by.

RoadStretch

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

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

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 comprimento do caminho em que o estilo será aplicado.

LatLng

O local deste ponto de parada.

Timestamp

A hora estimada de chegada do veículo a esse ponto de parada.