Esta página foi traduzida pela API Cloud Translation.

Package google.maps.routing.v2

Índice

Routes (interface)
ComputeRouteMatrixRequest (mensagem)
ComputeRouteMatrixRequest.ExtraComputation (enum)
ComputeRoutesRequest (mensagem)
ComputeRoutesRequest.ExtraComputation (enum)
ComputeRoutesRequest.ReferenceRoute (enum)
ComputeRoutesResponse (mensagem)
FallbackInfo (mensagem)
FallbackReason (enum)
FallbackRoutingMode (enum)
GeocodedWaypoint (mensagem)
GeocodingResults (mensagem)
LocalizedTime (mensagem)
Location (mensagem)
Maneuver (enum)
NavigationInstruction (mensagem)
Polyline (mensagem)
PolylineEncoding (enum)
PolylineQuality (enum)
Route (mensagem)
Route.RouteLocalizedValues (mensagem)
RouteLabel (enum)
RouteLeg (mensagem)
RouteLeg.RouteLegLocalizedValues (mensagem)
RouteLeg.StepsOverview (mensagem)
RouteLeg.StepsOverview.MultiModalSegment (mensagem)
RouteLegStep (mensagem)
RouteLegStep.RouteLegStepLocalizedValues (mensagem)
RouteLegStepTransitDetails (mensagem)
RouteLegStepTransitDetails.TransitDetailsLocalizedValues (mensagem)
RouteLegStepTransitDetails.TransitStopDetails (mensagem)
RouteLegStepTravelAdvisory (mensagem)
RouteLegTravelAdvisory (mensagem)
RouteMatrixDestination (mensagem)
RouteMatrixElement (mensagem)
RouteMatrixElement.LocalizedValues (mensagem)
RouteMatrixElementCondition (enum)
RouteMatrixOrigin (mensagem)
RouteModifiers (mensagem)
RouteTravelAdvisory (mensagem)
RouteTravelMode (enum)
RoutingPreference (enum)
SpeedReadingInterval (mensagem)
SpeedReadingInterval.Speed (enum)
TollInfo (mensagem)
TollPass (enum)
TrafficModel (enum)
TransitAgency (mensagem)
TransitLine (mensagem)
TransitPreferences (mensagem)
TransitPreferences.TransitRoutingPreference (enum)
TransitPreferences.TransitTravelMode (enum)
TransitStop (mensagem)
TransitVehicle (mensagem)
TransitVehicle.TransitVehicleType (enum)
Units (enum)
VehicleEmissionType (enum)
VehicleInfo (mensagem)
Waypoint (mensagem)

Rotas

A API Routes.

ComputeRouteMatrix

ComputeRouteMatrix
`rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)` Recebe uma lista de origens e destinos e retorna um fluxo com informações de trajeto para cada combinação de origem e destino. OBSERVAÇÃO: esse método exige a especificação de uma máscara de campo de resposta na entrada. É possível fornecer a máscara de campo de resposta usando o parâmetro de URL `$fields` ou `fields` ou o cabeçalho HTTP/gRPC `X-Goog-FieldMask`. Consulte os cabeçalhos e parâmetros de URL disponíveis. O valor é uma lista separada por vírgulas de caminhos de campo. Consulte esta documentação detalhada sobre como criar os caminhos de campo. Por exemplo, neste método: Máscara de campo de todos os campos disponíveis (para inspeção manual): `X-Goog-FieldMask: ` Máscara de campo de durações de trajetos, distâncias, status do elemento, condição e índices de elementos (um exemplo de configuração de produção): `X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration` É fundamental que você inclua `status` em sua máscara de campo. Caso contrário, todas as mensagens serão exibidas corretamente. O Google não recomenda o uso da máscara de campo de resposta curinga (``) pelos seguintes motivos: Selecionar apenas os campos necessários ajuda nosso servidor a salvar ciclos de computação, o que nos permite retornar o resultado com uma latência menor. Selecionar apenas os campos necessários para o job de produção garante um desempenho de latência estável. Podemos adicionar mais campos de resposta no futuro, e esses novos campos podem exigir tempo de computação extra. Se você selecionar todos os campos ou todos os campos no nível superior, poderá haver uma queda no desempenho, porque qualquer campo novo adicionado será automaticamente incluído na resposta. Selecionar apenas os campos necessários resulta em uma resposta menor e, portanto, em maior capacidade de rede.

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Recebe uma lista de origens e destinos e retorna um fluxo com informações de trajeto para cada combinação de origem e destino.

OBSERVAÇÃO: esse método exige a especificação de uma máscara de campo de resposta na entrada. É possível fornecer a máscara de campo de resposta usando o parâmetro de URL $fields ou fields ou o cabeçalho HTTP/gRPC X-Goog-FieldMask. Consulte os cabeçalhos e parâmetros de URL disponíveis. O valor é uma lista separada por vírgulas de caminhos de campo. Consulte esta documentação detalhada sobre como criar os caminhos de campo.

Por exemplo, neste método:

Máscara de campo de todos os campos disponíveis (para inspeção manual): X-Goog-FieldMask: *
Máscara de campo de durações de trajetos, distâncias, status do elemento, condição e índices de elementos (um exemplo de configuração de produção): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

É fundamental que você inclua status em sua máscara de campo. Caso contrário, todas as mensagens serão exibidas corretamente. O Google não recomenda o uso da máscara de campo de resposta curinga (*) pelos seguintes motivos:

Selecionar apenas os campos necessários ajuda nosso servidor a salvar ciclos de computação, o que nos permite retornar o resultado com uma latência menor.
Selecionar apenas os campos necessários para o job de produção garante um desempenho de latência estável. Podemos adicionar mais campos de resposta no futuro, e esses novos campos podem exigir tempo de computação extra. Se você selecionar todos os campos ou todos os campos no nível superior, poderá haver uma queda no desempenho, porque qualquer campo novo adicionado será automaticamente incluído na resposta.
Selecionar apenas os campos necessários resulta em uma resposta menor e, portanto, em maior capacidade de rede.

ComputeRoutes

ComputeRoutes
`rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)` Retorna o trajeto principal, juntamente com trajetos alternativos opcionais, considerando um conjunto de pontos de referência terminais e intermediários. OBSERVAÇÃO: esse método exige a especificação de uma máscara de campo de resposta na entrada. É possível fornecer a máscara de campo de resposta usando o parâmetro de URL `$fields` ou `fields`, ou um cabeçalho HTTP/gRPC `X-Goog-FieldMask`. Consulte os cabeçalhos e parâmetros de URL disponíveis. O valor é uma lista separada por vírgulas de caminhos de campo. Consulte a documentação detalhada sobre como construir os caminhos de campo. Por exemplo, neste método: Máscara de campo de todos os campos disponíveis (para inspeção manual): `X-Goog-FieldMask: ` Máscara de campo da duração, distância e polilinha no nível do trajeto (um exemplo de configuração de produção): `X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline` O Google não recomenda o uso da máscara de campo de resposta curinga (``) ou a especificação da máscara de campo no nível superior (`routes`) pelos seguintes motivos: Selecionar apenas os campos necessários ajuda nosso servidor a salvar ciclos de computação, o que nos permite retornar o resultado com uma latência menor. Selecionar apenas os campos necessários para o job de produção garante um desempenho de latência estável. Podemos adicionar mais campos de resposta no futuro, e esses novos campos podem exigir tempo de computação extra. Se você selecionar todos os campos ou todos os campos no nível superior, poderá haver uma queda no desempenho, porque qualquer campo novo adicionado será automaticamente incluído na resposta. Selecionar apenas os campos necessários resulta em uma resposta menor e, portanto, em maior capacidade de rede.

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Retorna o trajeto principal, juntamente com trajetos alternativos opcionais, considerando um conjunto de pontos de referência terminais e intermediários.

OBSERVAÇÃO: esse método exige a especificação de uma máscara de campo de resposta na entrada. É possível fornecer a máscara de campo de resposta usando o parâmetro de URL $fields ou fields, ou um cabeçalho HTTP/gRPC X-Goog-FieldMask. Consulte os cabeçalhos e parâmetros de URL disponíveis. O valor é uma lista separada por vírgulas de caminhos de campo. Consulte a documentação detalhada sobre como construir os caminhos de campo.

Por exemplo, neste método:

Máscara de campo de todos os campos disponíveis (para inspeção manual): X-Goog-FieldMask: *
Máscara de campo da duração, distância e polilinha no nível do trajeto (um exemplo de configuração de produção): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

O Google não recomenda o uso da máscara de campo de resposta curinga (*) ou a especificação da máscara de campo no nível superior (routes) pelos seguintes motivos:

Selecionar apenas os campos necessários ajuda nosso servidor a salvar ciclos de computação, o que nos permite retornar o resultado com uma latência menor.
Selecionar apenas os campos necessários para o job de produção garante um desempenho de latência estável. Podemos adicionar mais campos de resposta no futuro, e esses novos campos podem exigir tempo de computação extra. Se você selecionar todos os campos ou todos os campos no nível superior, poderá haver uma queda no desempenho, porque qualquer campo novo adicionado será automaticamente incluído na resposta.
Selecionar apenas os campos necessários resulta em uma resposta menor e, portanto, em maior capacidade de rede.

ComputeRouteMatrixRequest

Mensagem de solicitação ComputeRouteMatrix

Campos
`origins[]`	`RouteMatrixOrigin` Obrigatório. Matriz de origens, que determina as linhas da matriz de resposta. Várias restrições de tamanho se aplicam à cardinalidade de origens e destinos: A soma do número de origens + o número de destinos especificados como `place_id` ou `address` não pode ser maior que 50. O produto de número de origens × número de destinos não pode ser maior que 625. O produto do número de origens × número de destinos não pode ser maior que 100 se routes_preference estiver definida como `TRAFFIC_AWARE_OPTIMAL`. O produto de número de origens × número de destinos não poderá ser maior que 100 se o valor de "travel_mode" estiver definido como `TRANSIT`.
`destinations[]`	`RouteMatrixDestination` Obrigatório. Matriz de destinos, que determina as colunas da matriz de resposta.
`travel_mode`	`RouteTravelMode` Opcional. Especifica o meio de transporte.
`routing_preference`	`RoutingPreference` Opcional. Especifica como calcular a rota. O servidor tenta usar a preferência de roteamento selecionada para calcular a rota. Se a preferência de roteamento resultar em um erro ou em uma latência extralonga, um erro será retornado. Só é possível especificar essa opção quando `travel_mode` é `DRIVE` ou `TWO_WHEELER`. Caso contrário, a solicitação vai falhar.
`departure_time`	`Timestamp` Opcional. A hora de partida. Se você não definir esse valor, ele será usado como padrão para o horário em que a solicitação foi feita. OBSERVAÇÃO: só é possível especificar um `departure_time` no passado quando `RouteTravelMode` está definido como `TRANSIT`.
`arrival_time`	`Timestamp` Opcional. O horário de chegada. OBSERVAÇÃO: só poderá ser definido quando `RouteTravelMode` for definido como `TRANSIT`. É possível especificar `departure_time` ou `arrival_time`, mas não ambos.
`language_code`	`string` Opcional. O código de idioma BCP-47, como "pt-BR" ou "en-US". Para saber mais, consulte Identificador de localidade Unicode. Consulte Compatibilidade de idiomas para ver a lista de idiomas compatíveis. Quando você não fornece esse valor, o idioma de exibição é inferido a partir do local da primeira origem.
`region_code`	`string` Opcional. O código de região, especificado como um valor ccTLD ("domínio de nível superior") de dois caracteres. Para mais informações, consulte Domínios de nível superior com códigos de país.
`units`	`Units` Opcional. Especifica as unidades de medida para os campos de exibição.
`extra_computations[]`	`ExtraComputation` Opcional. Uma lista de cálculos extras que podem ser usados para concluir a solicitação. Observação: esses cálculos extras podem retornar campos extras na resposta. Esses campos extras também precisam ser especificados na máscara de campo a ser retornada na resposta.
`traffic_model`	`TrafficModel` Opcional. Especifica as suposições a serem usadas no cálculo do tempo no trânsito. Essa configuração afeta o valor retornado no campo de duração no `RouteMatrixElement`, que contém o tempo previsto no trânsito com base nas médias históricas. `RoutingPreference` para `TRAFFIC_AWARE_OPTIMAL` e `RouteTravelMode` para `DRIVE`. O padrão será `BEST_GUESS` se o tráfego for solicitado e `TrafficModel` não for especificado.
`transit_preferences`	`TransitPreferences` Opcional. Especifica preferências que influenciam o trajeto retornado para `TRANSIT` rotas. OBSERVAÇÃO: só é possível especificar um `transit_preferences` quando `RouteTravelMode` está definido como `TRANSIT`.

ExtraComputation

Cálculos extras a serem executados ao concluir a solicitação.

Enums
`EXTRA_COMPUTATION_UNSPECIFIED`	Não utilizado. As solicitações que tiverem esse valor falharão.
`TOLLS`	Informações de pedágio para os elementos da matriz.

ComputeRoutesRequest

Mensagem de solicitação do ComputeRoutes.

Campos
`origin`	`Waypoint` Obrigatório. Ponto de referência da origem.
`destination`	`Waypoint` Obrigatório. Ponto de referência do destino.
`intermediates[]`	`Waypoint` Opcional. Um conjunto de waypoints ao longo do trajeto (excluindo pontos de terminal), para parada ou passagem. Até 25 waypoints intermediários são permitidos.
`travel_mode`	`RouteTravelMode` Opcional. Especifica o meio de transporte.
`routing_preference`	`RoutingPreference` Opcional. Especifica como calcular a rota. O servidor tenta usar a preferência de roteamento selecionada para calcular a rota. Se a preferência de roteamento resultar em um erro ou em uma latência extralonga, um erro será retornado. Só é possível especificar essa opção quando `travel_mode` é `DRIVE` ou `TWO_WHEELER`. Caso contrário, a solicitação vai falhar.
`polyline_quality`	`PolylineQuality` Opcional. Especifica sua preferência pela qualidade da polilinha.
`polyline_encoding`	`PolylineEncoding` Opcional. Especifica a codificação preferencial para a polilinha.
`departure_time`	`Timestamp` Opcional. A hora de partida. Se você não definir esse valor, ele será usado como padrão para o horário em que a solicitação foi feita. OBSERVAÇÃO: só é possível especificar um `departure_time` no passado quando `RouteTravelMode` está definido como `TRANSIT`. As viagens de transporte público estão disponíveis para até 7 dias no passado ou 100 dias no futuro.
`arrival_time`	`Timestamp` Opcional. O horário de chegada. OBSERVAÇÃO: só poderá ser definido quando `RouteTravelMode` for definido como `TRANSIT`. É possível especificar `departure_time` ou `arrival_time`, mas não ambos. As viagens de transporte público estão disponíveis para até 7 dias no passado ou 100 dias no futuro.
`compute_alternative_routes`	`bool` Opcional. Especifica se é necessário calcular rotas alternativas além da rota. Nenhum trajeto alternativo é retornado para solicitações que têm waypoints intermediários.
`route_modifiers`	`RouteModifiers` Opcional. Um conjunto de condições a serem atendidas que afetam a forma como os trajetos são calculados.
`language_code`	`string` Opcional. O código de idioma BCP-47, como "pt-BR" ou "en-US". Para saber mais, consulte Identificador de localidade Unicode. Consulte Compatibilidade de idiomas para ver a lista de idiomas compatíveis. Quando você não fornece esse valor, o idioma de exibição é inferido com base no local da solicitação de trajeto.
`region_code`	`string` Opcional. O código de região, especificado como um valor ccTLD ("domínio de nível superior") de dois caracteres. Para mais informações, consulte Domínios de nível superior com códigos de país.
`units`	`Units` Opcional. Especifica as unidades de medida para os campos de exibição. Esses campos incluem o campo `instruction` em `NavigationInstruction`. As unidades de medida usadas para trajeto, trecho, distância do passo e duração não são afetadas por esse valor. Se você não informar esse valor, as unidades de exibição serão inferidas a partir do local da primeira origem.
`optimize_waypoint_order`	`bool` Opcional. Se definida como verdadeira, o serviço tentará minimizar o custo total do trajeto reordenando os waypoints intermediários especificados. A solicitação falhará se algum dos waypoints intermediários for um `via`. Use `ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index` para encontrar a nova ordem. Se `ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index` não for solicitado no cabeçalho `X-Goog-FieldMask`, a solicitação falhará. Se `optimize_waypoint_order` for definido como falso, `ComputeRoutesResponse.optimized_intermediate_waypoint_index` estará vazio.
`requested_reference_routes[]`	`ReferenceRoute` Opcional. Especifica quais rotas de referência serão calculadas como parte da solicitação, além da rota padrão. Um trajeto de referência tem um objetivo de cálculo diferente do trajeto padrão. Por exemplo, um cálculo de trajeto de referência de `FUEL_EFFICIENT` considera vários parâmetros que gerariam um trajeto econômico ideal.
`extra_computations[]`	`ExtraComputation` Opcional. Uma lista de cálculos extras que podem ser usados para concluir a solicitação. Observação: esses cálculos extras podem retornar campos extras na resposta. Esses campos extras também precisam ser especificados na máscara de campo a ser retornada na resposta.
`traffic_model`	`TrafficModel` Opcional. Especifica as suposições a serem usadas no cálculo do tempo no trânsito. Essa configuração afeta o valor retornado no campo de duração no `Route` e no `RouteLeg`, que contém o tempo previsto no trânsito com base nas médias históricas. `TrafficModel` só está disponível para solicitações que definiram `RoutingPreference` como `TRAFFIC_AWARE_OPTIMAL` e `RouteTravelMode` como `DRIVE`. O padrão será `BEST_GUESS` se o tráfego for solicitado e `TrafficModel` não for especificado.
`transit_preferences`	`TransitPreferences` Opcional. Especifica preferências que influenciam o trajeto retornado para rotas `TRANSIT`. OBSERVAÇÃO: só é possível especificar um `transit_preferences` quando `RouteTravelMode` está definido como `TRANSIT`.

ExtraComputation

Cálculos extras a serem executados ao concluir a solicitação.

Enums
`EXTRA_COMPUTATION_UNSPECIFIED`	Não utilizado. As solicitações que tiverem esse valor falharão.
`TOLLS`	Informações sobre pedágios dos trajetos.
`FUEL_CONSUMPTION`	Consumo estimado de combustível para os trajetos.
`TRAFFIC_ON_POLYLINE`	Polilinhas com base no trânsito nos trajetos
`HTML_FORMATTED_NAVIGATION_INSTRUCTIONS`	`NavigationInstructions` apresentado como uma string de texto HTML formatada. Este conteúdo deve ser lido no estado em que se encontra. Este conteúdo é apenas para exibição. Não o analise programaticamente.

ReferenceRoute

Uma rota de referência compatível no ComputeRoutesRequest.

Enums
`REFERENCE_ROUTE_UNSPECIFIED`	Não utilizado. Solicitações com esse valor falham.
`FUEL_EFFICIENT`	Trajeto de baixo consumo de combustível. Os trajetos identificados com esse valor são determinados como otimizados para parâmetros como o consumo de combustível.

ComputeRoutesResponse

ComputeRoutes encaminha a mensagem de resposta.

Campos

Campos
`routes[]`	`Route` Contém uma matriz de rotas computadas (até três) quando você especifica `compute_alternatives_routes` e apenas uma rota quando não faz isso. Quando essa matriz contém várias entradas, a primeira é o trajeto mais recomendado. Se a matriz estiver vazia, isso significa que nenhum trajeto foi encontrado.
`fallback_info`	`FallbackInfo` Em alguns casos, quando o servidor não consegue computar os resultados da rota com todas as preferências de entrada, ele pode optar por usar uma forma de computação diferente. Quando o modo substituto é usado, esse campo contém informações detalhadas sobre a resposta substituta. Caso contrário, este campo não será definido.
`geocoding_results`	`GeocodingResults` Contém informações de resposta de geocodificação para waypoints especificados como endereços.

routes[]

Route

Contém uma matriz de rotas computadas (até três) quando você especifica compute_alternatives_routes e apenas uma rota quando não faz isso. Quando essa matriz contém várias entradas, a primeira é o trajeto mais recomendado. Se a matriz estiver vazia, isso significa que nenhum trajeto foi encontrado.

fallback_info

FallbackInfo

Em alguns casos, quando o servidor não consegue computar os resultados da rota com todas as preferências de entrada, ele pode optar por usar uma forma de computação diferente. Quando o modo substituto é usado, esse campo contém informações detalhadas sobre a resposta substituta. Caso contrário, este campo não será definido.

geocoding_results

GeocodingResults

Contém informações de resposta de geocodificação para waypoints especificados como endereços.

FallbackInfo

Informações relacionadas a como e por que um resultado substituto foi usado. Se esse campo estiver definido, isso significa que o servidor usou um modo de roteamento diferente do seu modo preferencial como substituto.

Campos

Campos
`routing_mode`	`FallbackRoutingMode` Modo de roteamento usado para a resposta. Se o substituto foi acionado, o modo pode ser diferente da preferência de roteamento definida na solicitação original do cliente.
`reason`	`FallbackReason` O motivo pelo qual a resposta substituta foi usada em vez da resposta original. Esse campo só é preenchido quando o modo substituto é acionado e a resposta substituta é retornada.

routing_mode

FallbackRoutingMode

Modo de roteamento usado para a resposta. Se o substituto foi acionado, o modo pode ser diferente da preferência de roteamento definida na solicitação original do cliente.

reason

FallbackReason

O motivo pelo qual a resposta substituta foi usada em vez da resposta original. Esse campo só é preenchido quando o modo substituto é acionado e a resposta substituta é retornada.

FallbackReason

Motivos para usar a resposta substituta.

Enums
`FALLBACK_REASON_UNSPECIFIED`	Nenhum motivo de substituição especificado.
`SERVER_ERROR`	Ocorreu um erro no servidor ao calcular os trajetos com seu modo de trajeto preferido, mas conseguimos retornar um resultado calculado por um modo alternativo.
`LATENCY_EXCEEDED`	Não conseguimos concluir o cálculo com o modo de trajeto de sua preferência a tempo, mas recebemos um resultado calculado por um modo alternativo.

FallbackRoutingMode

Modo de roteamento real usado para a resposta de fallback retornada.

Enums
`FALLBACK_ROUTING_MODE_UNSPECIFIED`	Não utilizado.
`FALLBACK_TRAFFIC_UNAWARE`	Indica que o `TRAFFIC_UNAWARE` `RoutingPreference` foi usado para calcular a resposta.
`FALLBACK_TRAFFIC_AWARE`	Indica que o `TRAFFIC_AWARE` `RoutingPreference` foi usado para calcular a resposta.

GeocodedWaypoint

Detalhes sobre os locais usados como waypoints. Preenchido apenas para waypoints do endereço. Inclui detalhes sobre os resultados de geocodificação para fins de determinar para onde o endereço foi geocodificado.

Campos
`geocoder_status`	`Status` Indica o código de status resultante da operação de geocodificação.
`type[]`	`string` Os tipos do resultado, na forma de zero ou mais tags de tipo. Tipos compatíveis: Tipos de endereço e de componentes de endereço.
`partial_match`	`bool` Indica que o geocodificador não retornou uma correspondência exata para a solicitação original, mas conseguiu corresponder parte do endereço solicitado. Pode ser recomendável verificar se a solicitação original inclui erros de ortografia e/ou um endereço incompleto.
`place_id`	`string` O ID de lugar deste resultado.
`intermediate_waypoint_request_index`	`int32` O índice do waypoint intermediário correspondente na solicitação. Preenchido apenas se o waypoint correspondente for um waypoint intermediário.

GeocodingResults

Contém GeocodedWaypoints para waypoints de origem, destino e intermediários. Preenchido apenas para waypoints do endereço.

Campos

Campos
`origin`	`GeocodedWaypoint` Ponto de referência geocodificado de origem.
`destination`	`GeocodedWaypoint` Ponto de referência geocodificado de destino.
`intermediates[]`	`GeocodedWaypoint` Uma lista de pontos de referência geocodificados intermediários, cada um contendo um campo de índice que corresponde à posição baseada em zero do ponto de referência, na ordem em que foram especificados na solicitação.

origin

GeocodedWaypoint

Ponto de referência geocodificado de origem.

destination

GeocodedWaypoint

Ponto de referência geocodificado de destino.

intermediates[]

GeocodedWaypoint

Uma lista de pontos de referência geocodificados intermediários, cada um contendo um campo de índice que corresponde à posição baseada em zero do ponto de referência, na ordem em que foram especificados na solicitação.

LocalizedTime

Descrição localizada do tempo.

Campos

Campos
`time`	`LocalizedText` O horário especificado como uma string em um determinado fuso horário.
`time_zone`	`string` Contém o fuso horário. O valor é o nome do fuso horário, conforme definido no banco de dados de fuso horário IANA, por exemplo, "América/Nova_York".

time

LocalizedText

O horário especificado como uma string em um determinado fuso horário.

time_zone

string

Contém o fuso horário. O valor é o nome do fuso horário, conforme definido no banco de dados de fuso horário IANA, por exemplo, "América/Nova_York".

Local

Encapsula um local (um ponto geográfico e um cabeçalho opcional).

Campos

Campos
`lat_lng`	`LatLng` As coordenadas geográficas do waypoint.
`heading`	`Int32Value` A orientação da bússola associada à direção do fluxo do tráfego. Esse valor especifica o lado da estrada para embarque e desembarque. Os valores de cabeçalho podem variar de 0 a 360, em que 0 especifica uma orientação para o norte, 90 especifica uma orientação para o leste e assim por diante. Você pode usar este campo apenas para `DRIVE` e `TWO_WHEELER` `RouteTravelMode`.

lat_lng

LatLng

As coordenadas geográficas do waypoint.

heading

Int32Value

A orientação da bússola associada à direção do fluxo do tráfego. Esse valor especifica o lado da estrada para embarque e desembarque. Os valores de cabeçalho podem variar de 0 a 360, em que 0 especifica uma orientação para o norte, 90 especifica uma orientação para o leste e assim por diante. Você pode usar este campo apenas para DRIVE e TWO_WHEELER RouteTravelMode.

Maneuver

Um conjunto de valores que especifica a ação de navegação a ser realizada na etapa atual (por exemplo, virar à esquerda, mesclar ou reto).

Enums
`MANEUVER_UNSPECIFIED`	Não utilizado.
`TURN_SLIGHT_LEFT`	Vire levemente para a esquerda.
`TURN_SHARP_LEFT`	Vire acentuada para a esquerda.
`UTURN_LEFT`	Faça uma curva à esquerda.
`TURN_LEFT`	Vire à esquerda.
`TURN_SLIGHT_RIGHT`	Vire levemente para a direita.
`TURN_SHARP_RIGHT`	Vire acentuada para a direita.
`UTURN_RIGHT`	Faça uma curva para a direita.
`TURN_RIGHT`	Vire à direita.
`STRAIGHT`	Vá direto.
`RAMP_LEFT`	Pegue a rampa da esquerda.
`RAMP_RIGHT`	Pegue a rampa da direita.
`MERGE`	Entre no tráfego.
`FORK_LEFT`	Pegue a bifurcação da esquerda.
`FORK_RIGHT`	Pegue a bifurcação da direita.
`FERRY`	Pegue a balsa.
`FERRY_TRAIN`	Pegue o trem que leva até a balsa.
`ROUNDABOUT_LEFT`	Vire à esquerda na rotatória.
`ROUNDABOUT_RIGHT`	Vire à direita na rotatória.
`DEPART`	Manobra inicial.
`NAME_CHANGE`	Usado para indicar uma mudança no nome da rua.

NavigationInstruction

Encapsula as instruções de navegação para um RouteLegStep.

Campos

maneuver

Maneuver

Agrupa as instruções de navegação da etapa atual (por exemplo, virar à esquerda, mesclar ou reto). Esse campo determina o ícone a ser exibido.

instructions

string

Instruções para fazer isso.

Polilinha

Encapsula uma polilinha codificada.

Campos

Campos
Campo de união `polyline_type`. Encapsula o tipo de polilinha. O padrão éencoded_polyline. `polyline_type` pode ser apenas de um dos tipos a seguir:
`encoded_polyline`	`string` A codificação de strings da polilinha usando o algoritmo de codificação de polilinha
`geo_json_linestring`	`Struct` Especifica uma polilinha usando o formato LineString GeoJSON.

Campo de união polyline_type. Encapsula o tipo de polilinha. O padrão éencoded_polyline. polyline_type pode ser apenas de um dos tipos a seguir:

encoded_polyline

string

A codificação de strings da polilinha usando o algoritmo de codificação de polilinha

geo_json_linestring

Struct

Especifica uma polilinha usando o formato LineString GeoJSON.

PolylineEncoding

Especifica o tipo preferido de polilinha a ser retornado.

Enums
`POLYLINE_ENCODING_UNSPECIFIED`	Nenhuma preferência de tipo de polilinha especificada. O valor padrão é `ENCODED_POLYLINE`.
`ENCODED_POLYLINE`	Especifica uma polilinha codificada usando o algoritmo de codificação de polilinha.
`GEO_JSON_LINESTRING`	Especifica uma polilinha usando o formato LineString GeoJSON

PolylineQuality

Um conjunto de valores que especifica a qualidade da polilinha.

Enums
`POLYLINE_QUALITY_UNSPECIFIED`	Nenhuma preferência de qualidade de polilinha especificada. O valor padrão é `OVERVIEW`.
`HIGH_QUALITY`	Especifica uma polilinha de alta qualidade, que é composta usando mais pontos do que `OVERVIEW`, ao custo do aumento do tamanho da resposta. Use esse valor quando precisar de mais precisão.
`OVERVIEW`	Especifica uma polilinha de visão geral, composta por um pequeno número de pontos. Use este valor para exibir uma visão geral do trajeto. O uso dessa opção tem uma latência de solicitação menor em comparação com o uso da opção `HIGH_QUALITY`.

Rota

Contém um trajeto, que consiste em uma série de segmentos de estrada conectados que unem waypoints iniciais, finais e intermediários.

Campos
`route_labels[]`	`RouteLabel` Rótulos do `Route` que são úteis para identificar propriedades específicas do trajeto e comparar com outras.
`legs[]`	`RouteLeg` Uma coleção de trechos (segmentos de caminho entre waypoints) que compõem o trajeto. Cada trecho corresponde à viagem entre dois `Waypoints` que não são `via`. Por exemplo, um trajeto sem waypoints intermediários tem apenas um trecho. Um trajeto que inclui um waypoint intermediário que não é `via` tem dois trechos. Um trajeto que inclui um waypoint intermediário `via` tem um trecho. A ordem dos trechos corresponde à ordem dos waypoints de `origin` a `intermediates` e `destination`.
`distance_meters`	`int32` A distância de viagem do trajeto, em metros.
`duration`	`Duration` O tempo necessário para navegar no trajeto. Se você definir `routing_preference` como `TRAFFIC_UNAWARE`, esse valor será igual a `static_duration`. Se você definir `routing_preference` como `TRAFFIC_AWARE` ou `TRAFFIC_AWARE_OPTIMAL`, esse valor será calculado considerando as condições de trânsito.
`static_duration`	`Duration` A duração da viagem no trajeto sem considerar as condições de trânsito.
`polyline`	`Polyline` A polilinha geral do trajeto. Essa é uma polilinha combinada de todas as `legs`.
`description`	`string` Uma descrição do trajeto.
`warnings[]`	`string` Uma matriz de avisos a serem mostrados durante a exibição do trajeto.
`viewport`	`Viewport` A caixa delimitadora da janela de visualização da polilinha.
`travel_advisory`	`RouteTravelAdvisory` Informações adicionais sobre o trajeto.
`optimized_intermediate_waypoint_index[]`	`int32` Se você definir `optimize_waypoint_order` como verdadeiro, esse campo conterá a ordem otimizada dos waypoints intermediários. Caso contrário, este campo ficará vazio. Por exemplo, se você fornecer uma entrada de Origem: LA; waypoints intermediários: Dallas, Bangor, Phoenix; Destino: Nova York e a ordem otimizada do waypoint intermediário for Phoenix, Dallas, Bangor, esse campo conterá os valores [2, 0, 1]. O índice começa com 0 para o primeiro waypoint intermediário fornecido na entrada.
`localized_values`	`RouteLocalizedValues` Representações de texto das propriedades da `Route`.
`route_token`	`string` Um token de rota seguro para a Web e codificado em base64 que pode ser transmitido ao SDK do Navigation. Ele permite que ele reconstrua o trajeto durante a navegação e, em caso de reencaminhamento, honre a intenção original de quando você criou o trajeto chamando ComputeRoutes. Os clientes devem tratar esse token como um blob opaco. Não compare seu valor entre solicitações. Esse token pode ser alterado mesmo que a mesma rota seja retornada. OBSERVAÇÃO: `Route.route_token` só está disponível para solicitações que definiram `ComputeRoutesRequest.routing_preference` como `TRAFFIC_AWARE` ou `TRAFFIC_AWARE_OPTIMAL`. `Route.route_token` não é compatível com solicitações que têm waypoints do tipo Via.

RouteLocalizedValues

Representações de texto de determinadas propriedades.

Campos
`distance`	`LocalizedText` Distância de viagem representada em forma de texto.
`duration`	`LocalizedText` Duração considerando as condições de trânsito, representada em forma de texto. Observação: se você não solicitou informações de tráfego, esse valor será igual a `static_duration`.
`static_duration`	`LocalizedText` Duração sem considerar as condições de trânsito, representada em forma de texto.
`transit_fare`	`LocalizedText` Tarifa de transporte público representada em formato de texto.

RouteLabel

Rótulos do Route que são úteis para identificar propriedades específicas do trajeto e comparar com outras.

Enums
`ROUTE_LABEL_UNSPECIFIED`	Padrão: não usado.
`DEFAULT_ROUTE`	O padrão "melhor" retornada para o cálculo da rota.
`DEFAULT_ROUTE_ALTERNATE`	Uma alternativa ao padrão "melhor" trajeto. Rotas como essa serão retornadas quando `compute_alternative_routes` for especificado.
`FUEL_EFFICIENT`	Trajeto de baixo consumo de combustível. Os trajetos identificados com esse valor são determinados como otimizados para parâmetros econômicos, como consumo de combustível.

RouteLeg

Contém um trecho entre waypoints diferentes de via.

Campos
`distance_meters`	`int32` A distância de viagem do trecho do trajeto, em metros.
`duration`	`Duration` O tempo necessário para navegar no trecho. Se o `route_preference` for definido como `TRAFFIC_UNAWARE`, esse valor será igual a `static_duration`. Se `route_preference` for `TRAFFIC_AWARE` ou `TRAFFIC_AWARE_OPTIMAL`, esse valor será calculado considerando as condições de trânsito.
`static_duration`	`Duration` A duração da viagem ao longo do trecho, calculada sem levar em consideração as condições de trânsito.
`polyline`	`Polyline` A polilinha geral deste trecho que inclui a polilinha de cada `step`.
`start_location`	`Location` O local de início deste trecho. Esse local pode ser diferente do `origin` fornecido. Por exemplo, quando o `origin` fornecido não está perto de uma via, isso é um ponto na via.
`end_location`	`Location` O local final deste trecho. Esse local pode ser diferente do `destination` fornecido. Por exemplo, quando o `destination` fornecido não está perto de uma via, isso é um ponto na via.
`steps[]`	`RouteLegStep` Uma matriz de etapas denotando segmentos neste trecho. Cada etapa representa uma instrução de navegação.
`travel_advisory`	`RouteLegTravelAdvisory` Contém as informações adicionais sobre as quais o usuário deve ser informado, como possíveis restrições de zona de trânsito, em um trecho de trajeto.
`localized_values`	`RouteLegLocalizedValues` Representações de texto das propriedades da `RouteLeg`.
`steps_overview`	`StepsOverview` Informações gerais sobre as etapas descritas neste `RouteLeg`. Esse campo só é preenchido para trajetos de TRANSPORTE.

RouteLegLocalizedValues

Representações de texto de determinadas propriedades.

Campos

distance

LocalizedText

Distância de viagem representada em forma de texto.

duration

LocalizedText

Duração considerando as condições de trânsito representadas em forma de texto. Observação: se você não solicitou informações de tráfego, esse valor será igual a "static_duration".

static_duration

LocalizedText

Duração sem considerar as condições de trânsito, representada em forma de texto.

StepsOverview

Fornece informações gerais sobre uma lista de RouteLegSteps.

Campos

Campos
`multi_modal_segments[]`	`MultiModalSegment` Informações resumidas sobre diferentes segmentos multimodais do `RouteLeg.steps`. Esse campo não será preenchido se o `RouteLeg` não tiver segmentos multimodais nas etapas.

multi_modal_segments[]

MultiModalSegment

Informações resumidas sobre diferentes segmentos multimodais do RouteLeg.steps. Esse campo não será preenchido se o RouteLeg não tiver segmentos multimodais nas etapas.

MultiModalSegment

Fornece informações resumidas sobre diferentes segmentos multimodais do RouteLeg.steps. Um segmento multimodal é definido como uma ou mais RouteLegStep contíguas que têm o mesmo RouteTravelMode. Esse campo não será preenchido se o RouteLeg não tiver segmentos multimodais nas etapas.

Campos
`navigation_instruction`	`NavigationInstruction` NavigationInstruções para o segmento multimodal.
`travel_mode`	`RouteTravelMode` O meio de transporte do segmento multimodal.
`step_start_index`	`int32` O índice `RouteLegStep` correspondente que é o início de um segmento multimodal.
`step_end_index`	`int32` O índice `RouteLegStep` correspondente que é o final de um segmento multimodal.

RouteLegStep

Contém um segmento de um RouteLeg. Uma etapa corresponde a uma única instrução de navegação. Os trechos do trajeto são compostos por degraus.

Campos
`distance_meters`	`int32` A distância de viagem desta etapa, em metros. Em algumas circunstâncias, este campo pode não ter um valor.
`static_duration`	`Duration` A duração da viagem por esta etapa sem levar em consideração as condições de trânsito. Em algumas circunstâncias, este campo pode não ter um valor.
`polyline`	`Polyline` A polilinha associada a esta etapa.
`start_location`	`Location` O local de início desta etapa.
`end_location`	`Location` O local final desta etapa.
`navigation_instruction`	`NavigationInstruction` Instruções de navegação.
`travel_advisory`	`RouteLegStepTravelAdvisory` Contém as informações adicionais sobre as quais o usuário deve ser informado, como possíveis restrições de zona de tráfego, em uma etapa de trecho.
`localized_values`	`RouteLegStepLocalizedValues` Representações de texto das propriedades da `RouteLegStep`.
`transit_details`	`RouteLegStepTransitDetails` Detalhes referentes a esta etapa, se o meio de transporte for `TRANSIT`.
`travel_mode`	`RouteTravelMode` O meio de transporte usado nesta etapa.

RouteLegStepLocalizedValues

Representações de texto de determinadas propriedades.

Campos

distance

LocalizedText

Distância de viagem representada em forma de texto.

static_duration

LocalizedText

Duração sem considerar as condições de trânsito, representada em forma de texto.

RouteLegStepTransitDetails

Outras informações para o RouteLegStep relacionadas aos trajetos TRANSIT.

Campos
`stop_details`	`TransitStopDetails` Informações sobre as paradas de chegada e partida da etapa.
`localized_values`	`TransitDetailsLocalizedValues` Representações de texto das propriedades da `RouteLegStepTransitDetails`.
`headsign`	`string` Especifica a direção de deslocamento nessa linha, conforme marcada no veículo ou no ponto de partida. Geralmente, a direção é a estação terminal.
`headway`	`Duration` Especifica o horário esperado como uma duração entre as partidas no mesmo ponto, nesse horário. Por exemplo, se o intervalo for igual a 600 segundos, aguarde 10 minutos caso perca o ônibus.
`transit_line`	`TransitLine` Informações sobre a linha de transporte público usada nesta etapa.
`stop_count`	`int32` O número de paradas da partida até a parada de chegada. Essa contagem inclui a parada de chegada, mas exclui a parada de partida. Por exemplo, se o seu trajeto sai da parada A, passa pelas paradas B e C e chega à parada D, stop_count retorna 3.
`trip_short_text`	`string` O texto que aparece em horários e placas para identificar uma viagem de transporte público para os passageiros. O texto deve identificar exclusivamente uma viagem no dia do serviço. Por exemplo, "538" é o `trip_short_text` do trem da Amtrak que sai de San Jose, CA às 15h10, nos dias úteis, para Sacramento, CA.

TransitDetailsLocalizedValues

Descrições localizadas de valores para RouteTransitDetails.

Campos

Campos
`arrival_time`	`LocalizedTime` Horário na representação de texto formatada com um fuso horário correspondente.
`departure_time`	`LocalizedTime` Horário na representação de texto formatada com um fuso horário correspondente.

arrival_time

LocalizedTime

Horário na representação de texto formatada com um fuso horário correspondente.

departure_time

LocalizedTime

Horário na representação de texto formatada com um fuso horário correspondente.

TransitStopDetails

Detalhes sobre as paradas de transporte público do RouteLegStep.

Campos
`arrival_stop`	`TransitStop` Informações sobre a parada de chegada para a etapa.
`arrival_time`	`Timestamp` O horário previsto de chegada para a etapa.
`departure_stop`	`TransitStop` Informações sobre a parada de partida da etapa.
`departure_time`	`Timestamp` O horário estimado de partida da etapa.

RouteLegStepTravelAdvisory

Contém as informações adicionais que o usuário precisa saber, como possíveis restrições de zona de tráfego em uma etapa de trecho.

Campos

Campos
`speed_reading_intervals[]`	`SpeedReadingInterval` OBSERVAÇÃO: este campo não está preenchido no momento.

speed_reading_intervals[]

SpeedReadingInterval

OBSERVAÇÃO: este campo não está preenchido no momento.

RouteLegTravelAdvisory

Contém as informações adicionais sobre as quais o usuário precisa ser informado em uma etapa de trecho, como possíveis restrições de zona de tráfego.

Campos

Campos
`toll_info`	`TollInfo` Contém informações sobre pedágios no `RouteLeg` específico. Esse campo só é preenchido quando há pedágios na `RouteLeg`. Se este campo estiver definido, mas o subcampo ajudar a estimar o preço estimado não estiver preenchido, esperamos que a estrada contenha pedágios, mas não saberemos um preço estimado. Se esse campo não existir, não haverá pedágio no `RouteLeg`.
`speed_reading_intervals[]`	`SpeedReadingInterval` Intervalos de leitura de velocidade que detalham a densidade de tráfego. Aplicável no caso das preferências de roteamento `TRAFFIC_AWARE` e `TRAFFIC_AWARE_OPTIMAL`. Os intervalos cobrem toda a polilinha da `RouteLeg` sem sobreposição. O ponto de início de um intervalo especificado é o mesmo que o ponto de término do intervalo anterior. Exemplo: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

Contém informações sobre pedágios no RouteLeg específico. Esse campo só é preenchido quando há pedágios na RouteLeg. Se este campo estiver definido, mas o subcampo ajudar a estimar o preço estimado não estiver preenchido, esperamos que a estrada contenha pedágios, mas não saberemos um preço estimado. Se esse campo não existir, não haverá pedágio no RouteLeg.

speed_reading_intervals[]

SpeedReadingInterval

Intervalos de leitura de velocidade que detalham a densidade de tráfego. Aplicável no caso das preferências de roteamento TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Os intervalos cobrem toda a polilinha da RouteLeg sem sobreposição. O ponto de início de um intervalo especificado é o mesmo que o ponto de término do intervalo anterior.

Exemplo:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

Um único destino para ComputeRouteMatrixRequest

Campos

Campos
`waypoint`	`Waypoint` Obrigatório. Ponto de referência do destino

waypoint

Waypoint

Obrigatório. Ponto de referência do destino

RouteMatrixElement

Contém informações de trajeto calculadas para um par origem/destino na API ComputeRouteMatrix. Esse proto pode ser transmitido para o cliente.

Campos
`status`	`Status` Código de status de erro para este elemento.
`condition`	`RouteMatrixElementCondition` Indica se o trajeto foi encontrado ou não. Independente do status.
`distance_meters`	`int32` A distância de viagem do trajeto, em metros.
`duration`	`Duration` O tempo necessário para navegar no trajeto. Se você definir `routing_preference` como `TRAFFIC_UNAWARE`, esse valor será igual a `static_duration`. Se você definir `routing_preference` como `TRAFFIC_AWARE` ou `TRAFFIC_AWARE_OPTIMAL`, esse valor será calculado considerando as condições de trânsito.
`static_duration`	`Duration` A duração do percurso pelo trajeto sem considerar as condições de trânsito.
`travel_advisory`	`RouteTravelAdvisory` Informações adicionais sobre o trajeto. Por exemplo: informações de restrição e pedágios
`fallback_info`	`FallbackInfo` Em alguns casos, quando o servidor não consegue computar a rota com as preferências informadas para esse par de origem/destino específico, ele pode voltar a usar um modo de cálculo diferente. Quando o modo substituto é usado, esse campo contém informações detalhadas sobre a resposta substituta. Caso contrário, este campo não será definido.
`localized_values`	`LocalizedValues` Representações de texto das propriedades da `RouteMatrixElement`.
`origin_index`	`int32` Índice baseado em zero da origem na solicitação.
`destination_index`	`int32` Índice baseado em zero do destino na solicitação.

LocalizedValues

Representações de texto de determinadas propriedades.

Campos
`distance`	`LocalizedText` Distância de viagem representada em forma de texto.
`duration`	`LocalizedText` Duração representada em formato de texto, considerando as condições de trânsito. Observação: se as informações de tráfego não foram solicitadas, esse valor é igual ao valor de "static_duration".
`static_duration`	`LocalizedText` Duração representada em forma de texto sem considerar as condições de trânsito.
`transit_fare`	`LocalizedText` Tarifa de transporte público representada em formato de texto.

RouteMatrixElementCondition

A condição do trajeto que está sendo retornado.

Enums
`ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED`	Usado somente quando o `status` do elemento não está OK.
`ROUTE_EXISTS`	Um trajeto foi encontrado, e as informações correspondentes foram preenchidas para o elemento.
`ROUTE_NOT_FOUND`	Nenhum trajeto foi encontrado. Os campos que contêm informações do trajeto, como `distance_meters` ou `duration`, não serão preenchidos no elemento.

RouteMatrixOrigin

Uma única origem para ComputeRouteMatrixRequest

Campos

Campos
`waypoint`	`Waypoint` Obrigatório. Ponto de referência da origem
`route_modifiers`	`RouteModifiers` Opcional. Modificadores para cada trajeto que usa esse nome como origem

waypoint

Waypoint

Obrigatório. Ponto de referência da origem

route_modifiers

RouteModifiers

Opcional. Modificadores para cada trajeto que usa esse nome como origem

RouteModifiers

Encapsula um conjunto de condições opcionais a serem atendidas ao calcular os trajetos.

Campos
`avoid_tolls`	`bool` Quando definido como verdadeiro, evita vias com pedágio onde for razoável, preferência a trajetos que não contenham vias com pedágio. Aplicável apenas aos `RouteTravelMode` de `DRIVE` e `TWO_WHEELER`.
`avoid_highways`	`bool` Quando definido como verdadeiro, evita rodovias onde for razoável, preferência a trajetos que não contenham rodovias. Aplicável apenas aos `RouteTravelMode` de `DRIVE` e `TWO_WHEELER`.
`avoid_ferries`	`bool` Quando definido como verdadeiro, evita balsas quando razoável, priorizando trajetos que não contenham balsas. Aplicável apenas aos `RouteTravelMode` de `DRIVE` e `TWO_WHEELER`.
`avoid_indoor`	`bool` Quando definido como verdadeiro, evita a navegação em ambientes fechados quando razoável, priorizando trajetos que não contenham navegação interna. Aplicável apenas aos `RouteTravelMode` do `WALK`.
`vehicle_info`	`VehicleInfo` Especifica as informações do veículo.
`toll_passes[]`	`TollPass` Encapsula informações sobre passes de pedágio. Se os passes livres forem fornecidos, a API vai tentar retornar o preço do cartão. Se os passes livres não forem fornecidos, a API vai tratar o valor como desconhecido e tentar retornar o preço em dinheiro. Aplicável apenas aos `RouteTravelMode` de `DRIVE` e `TWO_WHEELER`.

RouteTravelAdvisory

Contém as informações adicionais sobre as quais o usuário deve ser informado, como possíveis restrições de zona de tráfego.

Campos
`toll_info`	`TollInfo` Contém informações sobre pedágios no trajeto. Esse campo só é preenchido quando há pedágios no trajeto. Se este campo estiver definido, mas o subcampo `estimatedPrice` não for preenchido, o trajeto terá pedágios, mas o preço estimado será desconhecido. Se esse campo não for definido, não haverá pedágios no trajeto.
`speed_reading_intervals[]`	`SpeedReadingInterval` Intervalos de leitura de velocidade que detalham a densidade de tráfego. Aplicável no caso das preferências de roteamento `TRAFFIC_AWARE` e `TRAFFIC_AWARE_OPTIMAL`. Os intervalos abrangem toda a polilinha do trajeto sem sobreposição. O ponto de início de um intervalo especificado é o mesmo que o ponto de término do intervalo anterior. Exemplo: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`
`fuel_consumption_microliters`	`int64` O consumo de combustível previsto em microlitros.
`route_restrictions_partially_ignored`	`bool` O trajeto retornado pode ter restrições que não são adequadas para o meio de transporte ou modificadores de trajeto solicitados.
`transit_fare`	`Money` Se presente, contém o total das tarifas ou dos custos das passagens nesse trajeto. Esta propriedade é retornada somente para solicitações `TRANSIT` e somente para trajetos em que as informações de tarifas estão disponíveis para todas as etapas do transporte público.

RouteTravelMode

Um conjunto de valores usados para especificar o meio de transporte. OBSERVAÇÃO: os trajetos WALK, BICYCLE e TWO_WHEELER estão na versão Beta e podem não ter calçadas, faixas de pedestres ou ciclovias livres. Mostre esse aviso ao usuário em todos os trajetos a pé, de bicicleta e de duas rodas exibidos no app.

Enums
`TRAVEL_MODE_UNSPECIFIED`	Nenhum meio de transporte especificado. O valor padrão é `DRIVE`.
`DRIVE`	Viaje de carro de passageiros.
`BICYCLE`	Viaje de bicicleta.
`WALK`	Viaje a pé.
`TWO_WHEELER`	Veículo motorizado de duas rodas. Por exemplo, motocicleta. Isso é diferente do modo de viagem `BICYCLE`, que abrange o modo impulsionado por humanos.
`TRANSIT`	Viaje por trajetos de transporte público, quando disponíveis.

RoutingPreference

Um conjunto de valores que especifica fatores a serem considerados no cálculo do trajeto.

Enums
`ROUTING_PREFERENCE_UNSPECIFIED`	Nenhuma preferência de roteamento foi especificada. O padrão é `TRAFFIC_UNAWARE`.
`TRAFFIC_UNAWARE`	Calcula as rotas sem considerar as condições de trânsito em tempo real. Adequado quando as condições de trânsito não importam ou não são aplicáveis. O uso desse valor produz a menor latência. Observação: para `RouteTravelMode` `DRIVE` e `TWO_WHEELER`, o trajeto e a duração escolhidos se baseiam na malha rodoviária e nas condições médias de trânsito (independente da hora), não nas condições atuais das vias. Consequentemente, os trajetos podem incluir estradas que estão temporariamente fechadas. Os resultados das solicitações variam por causa de mudanças na malha rodoviária, de atualizações nas condições de trânsito e da natureza distribuída do serviço. Os resultados também podem variar entre trajetos quase equivalentes a qualquer momento ou frequência.
`TRAFFIC_AWARE`	Calcula as rotas considerando as condições de trânsito em tempo real. Ao contrário de `TRAFFIC_AWARE_OPTIMAL`, algumas otimizações são aplicadas para reduzir significativamente a latência.
`TRAFFIC_AWARE_OPTIMAL`	Calcula as rotas considerando as condições de trânsito em tempo real, sem aplicar a maioria das otimizações de desempenho. O uso desse valor produz a latência mais alta.

SpeedReadingInterval

Indicador de densidade de tráfego em um segmento contíguo de uma polilinha ou de um caminho. Dado um caminho com os pontos P_0, P_1, ... e P_N (índice de base zero), o SpeedReadingInterval define um intervalo e descreve o tráfego usando as seguintes categorias.

Campos
`start_polyline_point_index`	`int32` O índice inicial deste intervalo na polilinha.
`end_polyline_point_index`	`int32` O índice final deste intervalo na polilinha.
Campo de união `speed_type`. `speed_type` pode ser apenas de um dos tipos a seguir:
`speed`	`Speed` Velocidade do tráfego neste intervalo.

Velocidade

A classificação da velocidade da polilinha com base nos dados de trânsito.

Enums
`SPEED_UNSPECIFIED`	Valor padrão. Esse valor não é usado.
`NORMAL`	Velocidade normal, nenhuma lentidão é detectada.
`SLOW`	Lentidão foi detectada, mas não houve engarrafamento.
`TRAFFIC_JAM`	Engarrafamento detectado.

TollInfo

Encapsula informações de pedágio em um Route ou em um RouteLeg.

Campos

Campos
`estimated_price[]`	`Money` O valor monetário dos pedágios para o `Route` ou o `RouteLeg` correspondente. Esta lista contém uma quantia em dinheiro para cada moeda que deve ser cobrada pelas estações de pedágio. Normalmente, essa lista contém apenas um item para trajetos com pedágios em uma moeda. No caso de viagens internacionais, essa lista pode ter vários itens para refletir os pedágios em diferentes moedas.

estimated_price[]

Money

O valor monetário dos pedágios para o Route ou o RouteLeg correspondente. Esta lista contém uma quantia em dinheiro para cada moeda que deve ser cobrada pelas estações de pedágio. Normalmente, essa lista contém apenas um item para trajetos com pedágios em uma moeda. No caso de viagens internacionais, essa lista pode ter vários itens para refletir os pedágios em diferentes moedas.

TollPass

Lista de passes livres aceitos no mundo todo.

Enums
`TOLL_PASS_UNSPECIFIED`	Não utilizado. Se esse valor for usado, a solicitação falhará.
`AU_ETOLL_TAG`	Pedágio de Sydney. Veja mais detalhes em https://www.myetoll.com.au (em inglês).
`AU_EWAY_TAG`	Pedágio de Sydney. Veja mais detalhes em https://www.tollpay.com.au.
`AU_LINKT`	Cartão de pedágio em toda a Austrália. Saiba mais em https://www.linkt.com.au/.
`AR_TELEPASE`	Pedágio na Argentina. Confira mais detalhes em https://telepase.com.ar.
`BR_AUTO_EXPRESO`	Pedágio no Brasil. Veja mais detalhes em https://www.autoexpreso.com.
`BR_CONECTCAR`	Pedágio no Brasil. Saiba mais em https://conectcar.com.
`BR_MOVE_MAIS`	Pedágio no Brasil. Saiba mais em https://movemais.com.
`BR_PASSA_RAPIDO`	Pedágio no Brasil. Saiba mais em https://pasorapido.gob.do/.
`BR_SEM_PARAR`	Pedágio no Brasil. Veja mais detalhes em https://www.semparar.com.br (em inglês).
`BR_TAGGY`	Pedágio no Brasil. Saiba mais em https://taggy.com.br.
`BR_VELOE`	Pedágio no Brasil. Confira mais detalhes em https://veloe.com.br/site/onde-usar.
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	Cruzamento das fronteiras entre Canadá e Estados Unidos.
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	Cruzamento das fronteiras entre Canadá e Estados Unidos.
`CA_US_BLUE_WATER_EDGE_PASS`	Ponte de Ontário, Canadá a Michigan, na fronteira com os Estados Unidos.
`CA_US_CONNEXION`	Ponte de Ontário, Canadá a Michigan, na fronteira com os Estados Unidos.
`CA_US_NEXUS_CARD`	Cruzamento das fronteiras entre Canadá e Estados Unidos.
`ID_E_TOLL`	Indonésia. Cartão eletrônico fornecido por vários bancos e usado para pagar pedágios. Todos os cartões eletrônicos via bancos são cobrados da mesma forma, portanto, é necessário apenas um valor de tipo enumerado. Por exemplo: — Bank Mandiri https://www.bankmandiri.co.id/e-money — BCA https://www.bca.co.id/flazz — BNI https://www.bni.co.id/id-id/ebanking/tapcash
`IN_FASTAG`	India.
`IN_LOCAL_HP_PLATE_EXEMPT`	Isenção de placa estadual da Índia e HP.
`JP_ETC`	Japan etc. Sistema eletrônico sem fio para coletar pedágios. https://www.go-etc.jp/
`JP_ETC2`	Japan ETC2.0. Nova versão do ETC com desconto adicional e comunicação bidirecional entre dispositivos em veículos e antenas na estrada. https://www.go-etc.jp/etc2/index.html
`MX_IAVE`	Pedágio no México. https://iave.capufe.gob.mx/#/
`MX_PASE`	México https://www.pase.com.mx
`MX_QUICKPASS`	México https://operadoravial.com/quick-pass/
`MX_SISTEMA_TELEPEAJE_CHIHUAHUA`	http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
`MX_TAG_IAVE`	México
`MX_TAG_TELEVIA`	Empresa de pedágio no México. Um dos muitos que operam na Cidade do México. Veja mais detalhes em https://www.televia.com.mx.
`MX_TELEVIA`	Empresa de pedágio no México. Um dos muitos que operam na Cidade do México. https://www.televia.com.mx
`MX_VIAPASS`	Pedágio no México. Veja mais detalhes em https://www.viapass.com.mx/viapass/web_home.aspx.
`US_AL_FREEDOM_PASS`	Alabama, EUA.
`US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS`	AK, EUA.
`US_CA_FASTRAK`	Califórnia, EUA.
`US_CA_FASTRAK_CAV_STICKER`	Indica que o motorista tem um passe livre do FasTrak além do adesivo de veículo sem ar (CAV, na sigla em inglês) emitido pelo DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	CO, EUA.
`US_CO_GO_PASS`	CO, EUA.
`US_DE_EZPASSDE`	Alemanha, EUA.
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	Flórida, EUA.
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	Flórida, EUA.
`US_FL_EPASS`	Flórida, EUA.
`US_FL_GIBA_TOLL_PASS`	Flórida, EUA.
`US_FL_LEEWAY`	Flórida, EUA.
`US_FL_SUNPASS`	Flórida, EUA.
`US_FL_SUNPASS_PRO`	Flórida, EUA.
`US_IL_EZPASSIL`	Illinois, EUA.
`US_IL_IPASS`	Illinois, EUA.
`US_IN_EZPASSIN`	Índia, EUA.
`US_KS_BESTPASS_HORIZON`	Kansas, EUA.
`US_KS_KTAG`	Kansas, EUA.
`US_KS_NATIONALPASS`	Kansas, EUA.
`US_KS_PREPASS_ELITEPASS`	Kansas, EUA.
`US_KY_RIVERLINK`	KY, EUA.
`US_LA_GEAUXPASS`	Los Angeles, EUA.
`US_LA_TOLL_TAG`	Los Angeles, EUA.
`US_MA_EZPASSMA`	Massachusetts, EUA.
`US_MD_EZPASSMD`	MD, EUA.
`US_ME_EZPASSME`	MIM, EUA.
`US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD`	MI, EUA.
`US_MI_BCPASS`	MI, EUA.
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	MI, EUA.
`US_MI_IQ_PROX_CARD`	MI, EUA. Obsoleto porque esse tipo de cartão não existe mais. Este item está obsoleto.
`US_MI_IQ_TAG`	MI, EUA.
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	MI, EUA.
`US_MI_NEXPRESS_TOLL`	MI, EUA.
`US_MN_EZPASSMN`	MN, EUA.
`US_NC_EZPASSNC`	Carolina do Norte, EUA.
`US_NC_PEACH_PASS`	Carolina do Norte, EUA.
`US_NC_QUICK_PASS`	Carolina do Norte, EUA.
`US_NH_EZPASSNH`	New Hampshire, EUA.
`US_NJ_DOWNBEACH_EXPRESS_PASS`	Nova Jersey, EUA.
`US_NJ_EZPASSNJ`	Nova Jersey, EUA.
`US_NY_EXPRESSPASS`	Nova York, EUA.
`US_NY_EZPASSNY`	Nova York, EUA.
`US_OH_EZPASSOH`	Oh, EUA.
`US_PA_EZPASSPA`	Pensilvânia, EUA.
`US_RI_EZPASSRI`	RI, EUA.
`US_SC_PALPASS`	Carolina do Sul, EUA.
`US_TX_AVI_TAG`	Texas, EUA.
`US_TX_BANCPASS`	Texas, EUA.
`US_TX_DEL_RIO_PASS`	Texas, EUA.
`US_TX_EFAST_PASS`	Texas, EUA.
`US_TX_EAGLE_PASS_EXPRESS_CARD`	Texas, EUA.
`US_TX_EPTOLL`	Texas, EUA.
`US_TX_EZ_CROSS`	Texas, EUA.
`US_TX_EZTAG`	Texas, EUA.
`US_TX_FUEGO_TAG`	Texas, EUA.
`US_TX_LAREDO_TRADE_TAG`	Texas, EUA.
`US_TX_PLUSPASS`	Texas, EUA.
`US_TX_TOLLTAG`	Texas, EUA.
`US_TX_TXTAG`	Texas, EUA.
`US_TX_XPRESS_CARD`	Texas, EUA.
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	Utah, EUA.
`US_VA_EZPASSVA`	VA, EUA.
`US_WA_BREEZEBY`	Washington, EUA.
`US_WA_GOOD_TO_GO`	Washington, EUA.
`US_WV_EZPASSWV`	WV, EUA.
`US_WV_MEMORIAL_BRIDGE_TICKETS`	WV, EUA.
`US_WV_MOV_PASS`	WV, EUA
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	WV, EUA.

TrafficModel

Especifica as suposições a serem usadas no cálculo do tempo no trânsito. Essa configuração afeta o valor retornado no campo duration na resposta, que contém o tempo previsto no trânsito com base nas médias históricas.

Enums
`TRAFFIC_MODEL_UNSPECIFIED`	Não utilizado. Se especificado, o padrão será `BEST_GUESS`.
`BEST_GUESS`	Indica que o `duration` retornado deve ser a melhor estimativa do tempo de viagem com base no que se sabe sobre as condições de trânsito históricas e em tempo real. Quanto mais próximo de agora for a `departure_time`, mais importante será o trânsito em tempo real.
`PESSIMISTIC`	Indica que a duração retornada deve ser maior do que o tempo de viagem na maioria dos dias, embora ele possa ser maior em alguns dias em que as condições de trânsito são particularmente ruins.
`OPTIMISTIC`	Indica que a duração retornada deve ser menor que o tempo de viagem na maioria dos dias, embora ele possa ser menor em alguns dias em que as condições de trânsito são particularmente boas.

TransitAgency

Uma empresa de transporte público que opera uma linha de transporte público.

Campos

Campos
`name`	`string` O nome desta empresa de transporte público.
`phone_number`	`string` O número de telefone formatado específico da localidade da empresa de transporte público.
`uri`	`string` O URI da empresa de transporte público.

name

string

O nome desta empresa de transporte público.

phone_number

string

O número de telefone formatado específico da localidade da empresa de transporte público.

uri

string

O URI da empresa de transporte público.

TransitLine

Contém informações sobre a linha de transporte público usada nesta etapa.

Campos
`agencies[]`	`TransitAgency` A empresa de transporte público que opera essa linha.
`name`	`string` O nome completo dessa linha de transporte público. Por exemplo, "8 Avenue Local".
`uri`	`string` o URI da linha de transporte público, conforme fornecido pela empresa de transporte público.
`color`	`string` A cor usada com frequência na sinalização dessa linha. Representado no formato hexadecimal.
`icon_uri`	`string` URI do ícone associado a essa linha.
`name_short`	`string` O nome curto desta linha de transporte público. Esse nome normalmente será um número de linha, como "M7" ou "355".
`text_color`	`string` A cor usada com frequência no texto da sinalização dessa linha. Representado no formato hexadecimal.
`vehicle`	`TransitVehicle` O tipo de veículo que opera nessa linha de transporte público.

TransitPreferences

Preferências para rotas com base em TRANSIT que influenciam a rota retornada.

Campos

allowed_travel_modes[]

TransitTravelMode

Um conjunto de meios de transporte a serem usados ao acessar um trajeto TRANSIT. O padrão é todos os meios de transporte aceitos.

routing_preference

TransitRoutingPreference

Uma preferência de trajeto que, quando especificada, influencia a rota TRANSIT retornada.

TransitRoutingPreference

Especifica preferências de trajeto para trajetos de transporte público.

Enums
`TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED`	Nenhuma preferência especificada.
`LESS_WALKING`	Indica que o trajeto calculado deve dar preferência a uma quantidade limitada de caminhada.
`FEWER_TRANSFERS`	Indica que o trajeto calculado deve dar preferência a um número limitado de baldeações.

TransitTravelMode

Um conjunto de valores usados para especificar o meio de transporte público.

Enums
`TRANSIT_TRAVEL_MODE_UNSPECIFIED`	Nenhum meio de transporte de transporte público especificado.
`BUS`	Viaje de ônibus.
`SUBWAY`	Viaje de metrô.
`TRAIN`	Viaje de trem.
`LIGHT_RAIL`	Viaje de VLT ou bonde.
`RAIL`	Viaje de trem. Isso é equivalente a uma combinação de `SUBWAY`, `TRAIN` e `LIGHT_RAIL`.

TransitStop

Informações sobre uma parada de transporte público.

Campos

name

string

O nome da parada de transporte público.

location

Location

O local da parada expresso em coordenadas de latitude/longitude.

TransitVehicle

Informações sobre um veículo usado em trajetos de transporte público.

Campos
`name`	`LocalizedText` O nome deste veículo, em letras maiúsculas.
`type`	`TransitVehicleType` O tipo de veículo usado.
`icon_uri`	`string` URI de um ícone associado a esse tipo de veículo.
`local_icon_uri`	`string` O URI do ícone associado a esse tipo de veículo, com base na sinalização de transporte local.

TransitVehicleType

O tipo de veículo dos trajetos de transporte público.

Enums
`TRANSIT_VEHICLE_TYPE_UNSPECIFIED`	Não utilizado.
`BUS`	Ônibus
`CABLE_CAR`	Um veículo que opera por meio de um cabo, normalmente terrestre. Bondes aéreos podem ser do tipo `GONDOLA_LIFT`.
`COMMUTER_TRAIN`	Trem metropolitano.
`FERRY`	Balsa.
`FUNICULAR`	Um veículo puxado por cabo em declives acentuados. Um funicular geralmente consiste em dois vagões que funcionam como contrapesos um para o outro.
`GONDOLA_LIFT`	Um bonde aéreo.
`HEAVY_RAIL`	Vagões pesados.
`HIGH_SPEED_TRAIN`	Trem de alta velocidade.
`INTERCITY_BUS`	Ônibus intermunicipal.
`LONG_DISTANCE_TRAIN`	Trem de longa distância.
`METRO_RAIL`	Trilho para veículos leves.
`MONORAIL`	Monotrilho.
`OTHER`	Todos os outros veículos.
`RAIL`	Trem
`SHARE_TAXI`	Um transporte compartilhado é um veículo que pode deixar e coletar passageiros em qualquer ponto de sua rota.
`SUBWAY`	Veículo leve subterrâneo.
`TRAM`	Veículo leve acima do chão.
`TROLLEYBUS`	Ônibus elétrico.

Unidades

Um conjunto de valores que especifica a unidade de medida usada na tela.

Enums
`UNITS_UNSPECIFIED`	Unidades de medida não especificadas. O padrão é a unidade de medida inferida da solicitação.
`METRIC`	Unidades de medida métricas.
`IMPERIAL`	Unidades de medida imperiais (inglês).

VehicleEmissionType

Um conjunto de valores que descreve o tipo de emissão do veículo. Aplicável apenas aos RouteTravelMode do DRIVE.

Enums
`VEHICLE_EMISSION_TYPE_UNSPECIFIED`	Nenhum tipo de emissão especificado. O padrão é `GASOLINE`.
`GASOLINE`	Veículo a gasolina/combustível.
`ELECTRIC`	Veículo com eletricidade.
`HYBRID`	Veículo híbrido com combustível (como gasolina + elétrico).
`DIESEL`	Veículo a diesel.

VehicleInfo

Contém as informações do veículo, como o tipo de emissão.

Campos

emission_type

VehicleEmissionType

Descreve o tipo de emissão do veículo. Aplicável apenas aos RouteTravelMode do DRIVE.

Ponto de referência

Encapsula um waypoint. Os waypoints marcam o início e o fim de um trajeto e incluem paradas intermediárias ao longo do trajeto.

Campos
`via`	`bool` Marca o ponto de referência como um marco em vez de um ponto de parada. Para cada waypoint da solicitação que não é via, a resposta anexa uma entrada à matriz `legs` para fornecer os detalhes das paradas nesse trecho da viagem. Defina esse valor como true quando quiser que o trajeto passe por esse waypoint sem parar. Os waypoints Via não fazem com que uma entrada seja adicionada à matriz `legs`, mas roteiam a jornada pelo waypoint. Esse valor só pode ser definido em waypoints intermediários. A solicitação falhará se você definir esse campo em waypoints do terminal. Se `ComputeRoutesRequest.optimize_waypoint_order` for definido como verdadeiro, este campo não poderá ser definido como verdadeiro. caso contrário, a solicitação vai falhar.
`vehicle_stopover`	`bool` Indica que o waypoint é destinado a veículos para parada, onde a intenção é embarcar ou desembarcar. Quando você definir esse valor, o trajeto calculado não incluirá waypoints que não sejam `via` em vias inadequadas para embarque e desembarque. Essa opção funciona apenas para os meios de transporte `DRIVE` e `TWO_WHEELER` e quando `location_type` é `Location`.
`side_of_road`	`bool` Indica que o local deste waypoint deve ter uma preferência quanto à parada do veículo em um lado específico da via. Quando você define esse valor, o trajeto passa pelo local para que o veículo possa parar no lado da via para a qual o local está direcionado do centro da estrada. Essa opção funciona apenas para `DRIVE` e `TWO_WHEELER` `RouteTravelMode`.
Campo de união `location_type`. Maneiras diferentes de representar um local. `location_type` pode ser apenas de um dos tipos a seguir:
`location`	`Location` Um ponto especificado por meio de coordenadas geográficas, incluindo um cabeçalho opcional.
`place_id`	`string` O ID de lugar do PDI associado ao waypoint.
`address`	`string` Endereço legível por humanos ou um Plus Code. Consulte https://plus.codes para mais detalhes.