Package google.maps.routes.v1

Índice

RoutesPreferred

A API Routes Preferred.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Com um conjunto de waypoints terminais e intermediários e um objetivo de rota, calcula a melhor rota para esse objetivo. Também retorna o trajeto mais rápido e o mais curto como trajetos de referência.

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 informações de distância, durações, token e pedágio do trajeto: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

O Google não recomenda o uso da máscara de campo de resposta curinga (*) nem 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.
Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Para mais informações, consulte a Visão geral do OAuth 2.0.
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.
Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Para mais informações, consulte a Visão geral do OAuth 2.0.
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.
Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Para mais informações, consulte a Visão geral do OAuth 2.0.

ComputeCustomRoutesRequest

Mensagem da solicitação ComputeCustomRoutes.

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. No momento, somente o DRIVE é compatível.
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. No futuro, poderemos implementar um mecanismo substituto para usar uma opção diferente quando a opção preferida não fornecer um resultado válido. 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. Se você definir esse valor para um horário que já ocorreu, a solicitação falhará.
route_modifiers

RouteModifiers

Opcional. Um conjunto de condições a serem atendidas que afetam a forma como os trajetos são calculados.
route_objective

RouteObjective

Obrigatório. Um objetivo de rota para otimização.
language_code

string

Opcional. O código de idioma BCP-47, como "pt-BR" ou "en-US". Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. 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.
units

Units

Opcional. Especifica as unidades de medida para os campos de exibição. Isso inclui 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 fornecer esse valor, as unidades de exibição serão inferidas do local da solicitação.

ComputeCustomRoutesResponse

Mensagem de resposta de ComputeCustomRoutes.

Campos
routes[]

CustomRoute

As "melhores" rotas para o objetivo da rota de entrada.
fastest_route

CustomRoute

O trajeto de referência mais rápido.
shortest_route

CustomRoute

A rota de referência mais curta.
fallback_info

FallbackInfo

Informações de fallback para rotas personalizadas.

FallbackInfo

Encapsula informações de substituição para ComputeCustomRoutes. O ComputeCustomRoutes executa dois tipos de substitutos:

  1. Se não for possível calcular a rota usando o routes_preference solicitado pelo cliente, ele usará outro modo de roteamento. Nesse caso, fallback_routing_mode e roteamento_mode_fallback_reason são usados para comunicar o modo de roteamento substituto usado e o motivo.

  2. Se não for possível calcular um "melhor" rota para o objetivo da rota especificado pelo cliente, ela pode substituí-la por outro objetivo. fallback_route_objective é usado para comunicar o objetivo da rota substituta.

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

FallbackRouteObjective

O objetivo da rota usado para a resposta. Se o substituto foi acionado, o objetivo pode ser diferente do objetivo da rota informado na solicitação original do cliente.

FallbackRouteObjective

RouteObjective usado para a resposta.

Enums
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED Objetivo da rota substituta não especificado.
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA Se o cliente solicitar o RateCard, definir "include_tolls" como verdadeiro e o Google não tiver dados sobre os preços dos pedágios para o trajeto, a API voltará ao RateCard sem considerar o preço dos pedágios.

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:

  • O número de elementos (origens × destinos) não pode ser maior que 625.
  • Se o campo "route_preference" estiver definido como TRAFFIC_AWARE_OPTIMAL, o número de elementos (origens × destinos) não poderá ser maior que 100.
  • O número de waypoints (origens + destinos) especificados como place_id não pode ser maior que 50.
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. No futuro, poderemos implementar um mecanismo substituto para usar uma opção diferente quando a opção preferida não fornecer um resultado válido. 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, o padrão será o horário em que a solicitação foi feita. Se você definir esse valor para um horário que já ocorreu, a solicitação falhará.

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. No futuro, poderemos implementar um mecanismo substituto para usar uma opção diferente quando a opção preferida não fornecer um resultado válido. 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. Se você definir esse valor para um horário que já ocorreu, a solicitação falhará.
compute_alternative_routes

bool

Especifica se é necessário calcular rotas alternativas além da rota.
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 mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. 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.
units

Units

Opcional. Especifica as unidades de medida para os campos de exibição. Isso inclui 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 fornecer esse valor, as unidades de exibição serão inferidas do local da solicitação.
optimize_waypoint_order

bool

Se OptimizeWaypointOrder for definido como true, será feita uma tentativa de reordenar os waypoints intermediários especificados para minimizar o custo total do trajeto. Se algum dos waypoints intermediários estiver percorrendo esse modo, a solicitação falhará. Use ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index para encontrar a nova ordem. Se routes.optimized_intermediate_waypoint_index não for solicitado no cabeçalho X-Goog-FieldMask, a solicitação falhará. Se OptimizeWaypointOrder for definido como falso, ComputeRoutesResponse.optimized_intermediate_waypoint_index vai estar vazio.

ComputeRoutesResponse

ComputeRoutes encaminha a mensagem de resposta.

Campos
routes[]

Route

Contém uma matriz de rotas calculadas (até três) quando você especifica compute_alternatives_routes e contém apenas uma rota quando você não especifica. 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.

CustomRoute

Encapsula uma rota personalizada calculada com base no objetivo do trajeto especificado pelo cliente. A CustomRoute contém um token e um trajeto, que podem ser transmitidos ao NavSDK para reconstruir a rota personalizada para a navegação guiada.

Campos
route

Route

A rota considerada "melhor" para o objetivo da rota de entrada.
token

string

O token de rota codificado em base64 seguro para a Web que pode ser transmitido ao NavSDK, o que permite que o NavSDK reconstrua a rota durante a navegação e, no caso de reencaminhamento, respeite a intenção original quando o Routespreferred ComputeCustomRoutes é chamado. Os clientes devem tratar esse token como um blob opaco.

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
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 "TRAFFIC_UNAWARE" o modo de roteamento foi usado para calcular a resposta.
FALLBACK_TRAFFIC_AWARE Indica "TRAFFIC_AWARE" o modo de roteamento foi usado para calcular a resposta.

Local

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

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 é usado para especificar o lado da estrada a ser usado 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 etc. Esse campo só pode ser usado para os modos de transporte DRIVE e TWO_WHEELER.

Maneuver

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

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

Maneuver

Agrupa as instruções de navegação para a etapa atual (por exemplo, virar à esquerda, mesclar, em frente etc.). Esse campo determina o ícone a ser exibido.
instructions

string

Instruções para fazer isso.

Polilinha

Encapsula uma polilinha codificada.

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

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

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

Campos
legs[]

RouteLeg

Um conjunto de trechos (segmentos de caminho entre waypoints) que compõem o trajeto. Cada trecho corresponde à viagem entre dois waypoints diferentes do 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 até 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 do percurso pelo trajeto sem considerar as condições de trânsito.
polyline

Polyline

A polilinha geral do trajeto. Esta será a 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 ComputeRoutesRequest.optimize_waypoint_order estiver definido como verdadeiro, este campo conterá a ordem otimizada dos waypoints intermediários. Caso contrário, este campo ficará vazio. Por exemplo, suponha que a entrada seja Origin: LA; Intermediários: Dallas, Bangor, Phoenix; Destino: Nova York e a ordem otimizada dos waypoints intermediários é: Phoenix, Dallas, Bangor. Esse campo contém os valores [2, 0, 1]. O índice começa com 0 para o primeiro waypoint intermediário.

RouteLeg

Agrupa um segmento 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 do percurso ao longo do trecho, calculada sem considerar as condições de trânsito.
polyline

Polyline

A polilinha geral deste trecho. Isso inclui a polilinha de cada step.
start_location

Location

O local de início deste trecho. Ele 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. Ele 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

Agrupa as informações adicionais sobre as quais o usuário precisa ser informado, como possível restrição à zona de trânsito etc. em um trecho do trajeto.

RouteLegStep

Encapsula um segmento de uma 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

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

RouteLegStepTravelAdvisory

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

Campos
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 RouteLegStep 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).

RouteLegTravelAdvisory

Agrupa as informações adicionais sobre as quais o usuário precisa ser informado, como possível restrição à zona de trânsito etc. em um trecho do trajeto.

Campos
toll_info

TollInfo

Agrupa informações sobre pedágios no RouteLeg específico. Este campo só é preenchido quando há pedágios no RouteLeg. Se este campo estiver definido, mas o subcampo confirmar_preço não estiver preenchido, a estrada deve conter pedágios, mas não será possível saber 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 do RouteLg 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
waypoint

Waypoint

Obrigatório. Ponto de referência do destino

RouteMatrixElement

Encapsula informações de rota calculadas para um par origem/destino na API ComputeRouteMatrix. Esse proto pode ser transmitido para o cliente.

Campos
origin_index

int32

Índice baseado em zero da origem na solicitação.
destination_index

int32

Índice baseado em zero do destino na solicitação.
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.

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

Especifica se é necessário evitar vias com pedágio onde for razoável. Será dada preferência aos trajetos que não contenham vias com pedágio. Aplicável apenas aos meios de transporte DRIVE e TWO_WHEELER.
avoid_highways

bool

Especifica se é necessário evitar rodovias onde for razoável. Será dada preferência para trajetos que não contenham rodovias. Aplicável apenas aos meios de transporte DRIVE e TWO_WHEELER.
avoid_ferries

bool

Especifica se balsas devem ser evitadas quando for razoável. Será dada preferência aos trajetos que não contenham balsas. Aplicável apenas aos meios de transporte DRIVE e TWO_WHEELER.
avoid_indoor

bool

Especifica se é necessário evitar a navegação em ambientes fechados, quando razoável. Será dada preferência para trajetos que não contenham navegação interna. Aplicável apenas ao modo de viagem 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 meios de transporte DRIVE e TWO_WHEELER.

RouteObjective

Encapsula um objetivo a ser otimizado pelo ComputeCustomRoutes.

Campos
rate_card

RateCard

O objetivo da tabela de preços.

RateCard

Agrupa um objetivo de rota do RateCard.

Campos
cost_per_minute

MonetaryCost

Opcional. Custo por minuto.
cost_per_km

MonetaryCost

Opcional. Custo por quilômetro.
include_tolls

bool

Opcional. Indica se o custo dos pedágios será incluído no custo geral.

MonetaryCost

Agrupa o custo usado na tabela de preços.

Campos
value

double

Obrigatório. O valor de custo na moeda local inferido pela solicitação.

RouteTravelAdvisory

Agrupa as informações adicionais sobre as quais o usuário precisa ser informado, como possível restrição de zona de trânsito etc.

Campos
toll_info

TollInfo

Agrupa informações sobre os pedágios do trajeto. Esse campo só é preenchido quando há pedágios no trajeto. Se este campo estiver definido, mas o subcampo confirmar_preço não estiver preenchido, a estrada deve conter pedágios, mas não será possível saber um preço estimado. Se esse campo não for definido, não haverá pedágio 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).

RouteTravelMode

Um conjunto de valores usados para especificar o meio de transporte.

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

Viajar de táxi licenciado, o que pode permitir que o veículo utilize as pistas designadas em algumas áreas.

O modo TAXI é um recurso experimental. Se o cliente solicitar um trajeto de TÁXI em uma cidade onde os dados de faixa de táxi não estão disponíveis, um trajeto do DRIVE será retornado.

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_AWARE.
TRAFFIC_UNAWARE Calcula as rotas sem considerar as condições de trânsito. Adequado para quando as condições de trânsito não importam. O uso desse valor produz a menor latência.
TRAFFIC_AWARE Calcula os trajetos considerando as condições de trânsito. 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, 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 pontos P_0, P_1, ... , P_N (índice baseado em 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. No JSON, quando o índice é 0, o campo parece não estar preenchido.
end_polyline_point_index

int32

O índice final deste intervalo na polilinha. No JSON, quando o índice é 0, o campo parece não estar preenchido.
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
estimated_price[]

Money

O valor monetário dos pedágios para o trajeto ou trajeto 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 Um dos muitos fornecedores de passes de pedágio de Sydney. https://www.myetoll.com.au
AU_EWAY_TAG Um dos muitos fornecedores de passes de pedágio de Sydney. 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 (em inglês)
IN_FASTAG India.
IN_LOCAL_HP_PLATE_EXEMPT Isenção de placa estadual da Índia e HP.
MX_TAG_IAVE Pedágio no 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_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_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_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, EUA.
US_MI_IQ_PROX_CARD 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_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_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_NEWELL_TOLL_BRIDGE_TICKET WV, EUA.

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 ao modo de viagem 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).

VehicleInfo

Encapsula as informações do veículo, como o último caractere da placa.

Campos
emission_type

VehicleEmissionType

Descreve o tipo de emissão do veículo. Aplicável apenas ao modo de viagem 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 que não é do ponto de referência na solicitação, 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 estiver 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. Esta opção funciona apenas para "DRIVE" e 'TWO_WHEELER' meios de transporte e quando o campo 'location_type' é definido como "location".
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.