Package google.maps.routes.v1

Índice

RoutesPreferred

A API Routes Preferred.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

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

OBSERVAÇÃO:esse método exige que você especifique uma máscara de campo de resposta na entrada. Você pode 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 parâmetros e cabeçalhos de URL disponíveis. O valor é uma lista separada por vírgulas de caminhos de campo. Consulte esta 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 de distâncias, durações, tokens e informações de pedágio da rota: 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) porque:

  • Selecionar apenas os campos necessários ajuda nosso servidor a economizar ciclos de computação, permitindo que retornemos o resultado com uma latência menor.
  • Selecionar apenas os campos necessários no seu trabalho de produção garante uma performance de latência estável. Podemos adicionar mais campos de resposta no futuro, e esses novos campos podem exigir mais tempo de computação. Se você selecionar todos os campos ou todos os campos no nível superior, poderá ocorrer uma degradação da performance, porque qualquer novo campo adicionado será incluído automaticamente na resposta.
  • Selecionar apenas os campos necessários resulta em um tamanho de resposta menor e, portanto, maior capacidade de processamento da 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 que você especifique uma máscara de campo de resposta na entrada. Você pode 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 parâmetros e cabeçalhos de URL disponíveis. O valor é uma lista separada por vírgulas de caminhos de campo. Consulte esta 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 de durações, distâncias, status, condição e índices de elementos da rota (exemplo de configuração de produção): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

É fundamental incluir status na máscara de campo. Caso contrário, todas as mensagens vão parecer estar OK. O Google não recomenda o uso da máscara de campo de resposta curinga (*) porque:

  • Selecionar apenas os campos necessários ajuda nosso servidor a economizar ciclos de computação, permitindo que retornemos o resultado com uma latência menor.
  • Selecionar apenas os campos necessários no seu trabalho de produção garante uma performance de latência estável. Podemos adicionar mais campos de resposta no futuro, e esses novos campos podem exigir mais tempo de computação. Se você selecionar todos os campos ou todos os campos no nível superior, poderá ocorrer uma degradação da performance, porque qualquer novo campo adicionado será incluído automaticamente na resposta.
  • Selecionar apenas os campos necessários resulta em um tamanho de resposta menor e, portanto, maior capacidade de processamento da 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 a rota principal e rotas alternativas opcionais, considerando um conjunto de waypoints terminais e intermediários.

OBSERVAÇÃO:esse método exige que você especifique uma máscara de campo de resposta na entrada. Você pode 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 parâmetros e cabeçalhos 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 de duração, distância e polilinha no nível da rota (exemplo de configuração de produção): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

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

  • Selecionar apenas os campos necessários ajuda nosso servidor a economizar ciclos de computação, permitindo que retornemos o resultado com uma latência menor.
  • Selecionar apenas os campos necessários no seu trabalho de produção garante uma performance de latência estável. Podemos adicionar mais campos de resposta no futuro, e esses novos campos podem exigir mais tempo de computação. Se você selecionar todos os campos ou todos os campos no nível superior, poderá ocorrer uma degradação da performance, porque qualquer novo campo adicionado será incluído automaticamente na resposta.
  • Selecionar apenas os campos necessários resulta em um tamanho de resposta menor e, portanto, maior capacidade de processamento da 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 de solicitação ComputeCustomRoutes.

Campos
origin

Waypoint

Obrigatório. Ponto de parada de origem.
destination

Waypoint

Obrigatório. Ponto de parada de destino.
intermediates[]

Waypoint

Opcional. Um conjunto de waypoints ao longo do trajeto (excluindo os pontos finais), para parar ou passar por eles. É possível usar até 25 waypoints intermediários.
travel_mode

RouteTravelMode

Opcional. Especifica o meio de transporte. Somente DRIVE e "TWO_WHEELER" são aceitos.
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 uma latência muito longa, um erro será retornado. Você só pode especificar essa opção quando travel_mode for 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 preferida para a polilinha.
departure_time

Timestamp

Opcional. O horário de partida. Se você não definir esse valor, ele será definido como o horário em que você fez a solicitação. Se você definir esse valor para um horário que já passou, a solicitação vai falhar.
route_modifiers

RouteModifiers

Opcional. Um conjunto de condições a serem satisfeitas que afetam a forma como as rotas são calculadas.
route_objective

RouteObjective

Obrigatório. Um objetivo de rota para otimizar.
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 Suporte a idiomas para conferir a lista de idiomas disponíveis. Quando você não fornece esse valor, o idioma de exibição é inferido com base no local da solicitação de rota.
units

Units

Opcional. Especifica as unidades de medida dos campos de exibição. Isso inclui o campo instruction em NavigationInstruction. As unidades de medida usadas para a rota, o trecho, a distância e a duração da etapa não são afetadas por esse valor. Se você não fornecer esse valor, as unidades de exibição serão inferidas com base no local da solicitação.

ComputeCustomRoutesResponse

Mensagem de resposta ComputeCustomRoutes.

Campos
routes[]

CustomRoute

As "melhores" rotas para o objetivo de 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 realiza dois tipos de substituições:

  1. Se não for possível calcular o trajeto usando o routing_preference solicitado pelo cliente, o sistema vai usar outro modo de roteamento. Nesse caso, fallback_routing_mode e routing_mode_fallback_reason são usados para comunicar o modo de roteamento substituto usado e o motivo da substituição.

  2. Se não for possível calcular a "melhor" rota para o objetivo especificado pelo cliente, o sistema poderá usar outro objetivo. O fallback_route_objective é usado para comunicar o objetivo da rota alternativa.

Campos
routing_mode

FallbackRoutingMode

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

FallbackReason

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

FallbackRouteObjective

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

FallbackRouteObjective

RouteObjective usado para a resposta.

Tipos enumerados
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED Objetivo da rota de fallback não especificado.
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA Se o cliente solicitar RateCard e definir "include_tolls" como "true", e o Google não tiver dados de preços de pedágios para o trajeto, a API vai usar RateCard sem considerar o preço do pedágio.

ComputeRouteMatrixRequest

Mensagem de solicitação ComputeRouteMatrix

Campos
origins[]

RouteMatrixOrigin

Obrigatório. Matriz de origens que determina as linhas da matriz de resposta. Há várias restrições de tamanho para a cardinalidade de origens e destinos:

  • O número de elementos (origens × destinos) não pode ser maior que 625 em nenhum caso.
  • O número de elementos (origens × destinos) não pode ser maior que 100 se routing_preference estiver definido como TRAFFIC_AWARE_OPTIMAL.
  • O número de pontos de parada (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 uma latência muito longa, um erro será retornado. Você só pode especificar essa opção quando travel_mode for DRIVE ou TWO_WHEELER. Caso contrário, a solicitação vai falhar.
departure_time

Timestamp

Opcional. O horário de partida. Se você não definir esse valor, o padrão será o horário em que você fez a solicitação. Se você definir esse valor para um horário que já passou, a solicitação vai falhar.

ComputeRoutesRequest

Mensagem de solicitação ComputeRoutes.

Campos
origin

Waypoint

Obrigatório. Ponto de parada de origem.
destination

Waypoint

Obrigatório. Ponto de parada de destino.
intermediates[]

Waypoint

Opcional. Um conjunto de waypoints ao longo do trajeto (excluindo os pontos finais), para parar ou passar por eles. É possível usar até 25 waypoints intermediários.
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 uma latência muito longa, um erro será retornado. Você só pode especificar essa opção quando travel_mode for 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 preferida para a polilinha.
departure_time

Timestamp

Opcional. O horário de partida. Se você não definir esse valor, ele será definido como o horário em que você fez a solicitação. Se você definir esse valor para um horário que já passou, a solicitação vai falhar.
compute_alternative_routes

bool

Opcional. Especifica se é necessário calcular rotas alternativas além do trajeto. Nenhuma rota alternativa é retornada para solicitações com waypoints intermediários.
route_modifiers

RouteModifiers

Opcional. Um conjunto de condições a serem satisfeitas que afetam a forma como as rotas são calculadas.
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 Suporte a idiomas para conferir a lista de idiomas disponíveis. Quando você não fornece esse valor, o idioma de exibição é inferido com base no local da solicitação de rota.
units

Units

Opcional. Especifica as unidades de medida dos campos de exibição. Isso inclui o campo instruction em NavigationInstruction. As unidades de medida usadas para a rota, o trecho, a distância e a duração da etapa não são afetadas por esse valor. Se você não fornecer esse valor, as unidades de exibição serão inferidas com base no local da solicitação.
optimize_waypoint_order

bool

Se "optimizeWaypointOrder" estiver definido como "true", será feita uma tentativa de reordenar os pontos de parada intermediários especificados para minimizar o custo geral da rota. Se algum dos waypoints intermediários for um waypoint de passagem, a solicitação vai 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 vai falhar. Se optimize_waypoint_order for definido como "false", ComputeRoutesResponse.optimized_intermediate_waypoint_index vai estar vazio.

ComputeRoutesResponse

ComputeRoutes a mensagem de resposta.

Campos
routes[]

Route

Contém uma matriz de rotas calculadas (até três) quando você especifica compute_alternatives_routes e apenas uma rota quando não especifica. Quando essa matriz contém várias entradas, a primeira é a rota mais recomendada. Se a matriz estiver vazia, significa que não foi possível encontrar um trajeto.
fallback_info

FallbackInfo

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

CustomRoute

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

Campos
route

Route

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

string

Token de rota codificado em base64 e otimizado para a Web que pode ser transmitido ao NavSDK. Isso permite que o NavSDK reconstrua a rota durante a navegação e, em caso de novo trajeto, respeite a intenção original quando RoutesPreferred ComputeCustomRoutes é chamado. Os clientes precisam 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, significa que o servidor usou um modo de roteamento diferente do seu modo preferido como substituto.

Campos
routing_mode

FallbackRoutingMode

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

FallbackReason

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

FallbackReason

Motivos para usar a resposta alternativa.

Tipos enumerados
FALLBACK_REASON_UNSPECIFIED Nenhum motivo de substituição especificado.
SERVER_ERROR Ocorreu um erro no servidor ao calcular trajetos com seu modo de navegação preferido, mas conseguimos retornar um resultado calculado por um modo alternativo.
LATENCY_EXCEEDED Não foi possível concluir o cálculo com seu modo de trajeto preferido a tempo, mas conseguimos retornar um resultado calculado por um modo alternativo.

FallbackRoutingMode

Modo de roteamento real usado para a resposta substituta retornada.

Tipos enumerados
FALLBACK_ROUTING_MODE_UNSPECIFIED Não utilizado.
FALLBACK_TRAFFIC_UNAWARE Indica que o modo de roteamento TRAFFIC_UNAWARE foi usado para calcular a resposta.
FALLBACK_TRAFFIC_AWARE Indica que o modo de roteamento TRAFFIC_AWARE 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 ponto de referência.
heading

Int32Value

A direção da bússola associada à direção do fluxo de tráfego. Esse valor especifica o lado da via a ser usado para embarque e desembarque. Os valores de direção podem variar de 0 a 360, em que 0 especifica uma direção para o norte, 90 especifica uma direção para o leste e assim por diante. Você pode usar esse campo apenas para os modos de viagem DRIVE e TWO_WHEELER.

Maneuver

Um conjunto de valores que especificam a ação de navegação a ser realizada na etapa atual (por exemplo, vire à esquerda, entre ou siga em frente).

Tipos enumerados
MANEUVER_UNSPECIFIED Não utilizado.
TURN_SLIGHT_LEFT Vire um pouco para a esquerda.
TURN_SHARP_LEFT Vire bruscamente à esquerda.
UTURN_LEFT Faça uma inversão de marcha à esquerda.
TURN_LEFT Vire à esquerda.
TURN_SLIGHT_RIGHT Vire um pouco para a direita.
TURN_SHARP_RIGHT Vire à direita.
UTURN_RIGHT Faça uma conversão à direita em U.
TURN_RIGHT Vire à direita.
STRAIGHT Vá em frente.
RAMP_LEFT Pegue a rampa à esquerda.
RAMP_RIGHT Pegue a rampa à direita.
MERGE Entre no trânsito.
FORK_LEFT Pegue a bifurcação à esquerda.
FORK_RIGHT Pegue o garfo da direita.
FERRY Pegue a balsa.
FERRY_TRAIN Pegue o trem que leva ao ferry.
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.
DESTINATION Usado para indicar a chegada a um destino.
Campos
maneuver

Maneuver

Encapsula as instruções de navegação da etapa atual (por exemplo, vire à esquerda, entre ou siga em frente). Esse campo determina qual ícone será mostrado.
instructions

string

Instruções para navegar nesta etapa.

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 string da polilinha usando o algoritmo de codificação de polilinha.
geo_json_linestring

Struct

Especifica uma polilinha usando o formato LineString do GeoJSON.

PolylineEncoding

Especifica o tipo preferido de polilinha a ser retornado.

Tipos enumerados
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 polilinhas.
GEO_JSON_LINESTRING Especifica uma polilinha usando o formato LineString do GeoJSON.

PolylineQuality

Um conjunto de valores que especificam a qualidade da polilinha.

Tipos enumerados
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 de um tamanho de resposta maior. Use esse valor quando precisar de mais precisão.
OVERVIEW Especifica uma polilinha de visão geral, que é composta usando um pequeno número de pontos. Use esse valor ao mostrar uma visão geral da rota. Usar essa opção tem uma latência de solicitação menor em comparação com a opção HIGH_QUALITY.

Trajeto

Encapsula um trajeto, que consiste em uma série de segmentos de via conectados que unem pontos de partida, chegada e intermediários.

Campos
legs[]

RouteLeg

Uma coleção de trechos (segmentos de caminho entre waypoints) que compõem o trajeto. Cada trecho corresponde à viagem entre dois waypoints não via. Por exemplo, um trajeto sem waypoints intermediários tem apenas um trecho. Um trajeto que inclui um waypoint intermediário 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 para intermediates e destination.
distance_meters

int32

A distância de viagem da rota, em metros.
duration

Duration

O tempo necessário para percorrer o trajeto. Se você definir routing_preference como TRAFFIC_UNAWARE, esse valor será o mesmo que 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 pelo trajeto sem considerar as condições de trânsito.
polyline

Polyline

A polilinha da rota geral. Essa polilinha é a combinação de todas as legs.
description

string

Uma descrição da rota.
warnings[]

string

Uma matriz de avisos a serem mostrados ao exibir a rota.
viewport

Viewport

A caixa delimitadora da janela de visualização da polilinha.
travel_advisory

RouteTravelAdvisory

Informações adicionais sobre a rota.
optimized_intermediate_waypoint_index[]

int32

Se ComputeRoutesRequest.optimize_waypoint_order for definido como verdadeiro, esse campo vai conter a ordenação otimizada dos pontos de parada intermediários. Caso contrário, ele vai ficar vazio. Por exemplo, suponha que a entrada seja: Origem: Los Angeles; Intermediárias: Dallas, Bangor, Phoenix; Destino: Nova York; e a ordem otimizada dos pontos de parada intermediários seja: Phoenix, Dallas, Bangor. Então, esse campo contém os valores [2, 0, 1]. O índice começa com 0 para o primeiro ponto de parada intermediário.

RouteLeg

Encapsula um segmento entre pontos de referência não via.

Campos
distance_meters

int32

A distância de viagem do trecho da rota, em metros.
duration

Duration

O tempo necessário para navegar pelo trecho. Se route_preference for definido como TRAFFIC_UNAWARE, esse valor será igual a static_duration. Se o 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 pelo trecho, calculada sem considerar as condições de trânsito.
polyline

Polyline

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

Location

O local de início deste trecho. Isso pode ser diferente do origin fornecido. Por exemplo, quando o origin fornecido não está perto de uma via, esse é um ponto na via.
end_location

Location

O local de término deste trecho. Isso pode ser diferente do destination fornecido. Por exemplo, quando o destination fornecido não está perto de uma via, esse é um ponto na via.
steps[]

RouteLegStep

Uma matriz de etapas que indicam segmentos dentro desse trecho. Cada etapa representa uma instrução de navegação.
travel_advisory

RouteLegTravelAdvisory

Encapsula as informações adicionais que o usuário precisa receber, como possível restrição de zona de tráfego etc. em um trecho da rota.

RouteLegStep

Encapsula um segmento de um RouteLeg. Uma etapa corresponde a uma única instrução de navegação. Os trechos de rota são compostos de etapas.

Campos
distance_meters

int32

A distância percorrida nesta etapa, em metros. Em algumas circunstâncias, esse campo pode não ter um valor.
static_duration

Duration

A duração da viagem nessa etapa sem considerar as condições de trânsito. Em algumas circunstâncias, esse 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 de término desta etapa.
navigation_instruction

NavigationInstruction

Instruções de navegação.
travel_advisory

RouteLegStepTravelAdvisory

Encapsula as informações adicionais que o usuário precisa receber, como uma possível restrição de zona de tráfego em uma etapa do trajeto.

RouteLegStepTravelAdvisory

Encapsula as informações adicionais que o usuário precisa receber, como uma possível restrição de zona de tráfego em uma etapa do trajeto.

Campos
speed_reading_intervals[]

SpeedReadingInterval

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

RouteLegTravelAdvisory

Encapsula as informações adicionais que o usuário precisa receber, como possível restrição de zona de tráfego etc. em um trecho da rota.

Campos
toll_info

TollInfo

Encapsula informações sobre pedágios no RouteLeg específico. Esse campo só é preenchido se esperamos que haja pedágios no RouteLeg. Se esse campo estiver definido, mas o subcampo estimated_price não estiver preenchido, esperamos que a via tenha pedágios, mas não sabemos um preço estimado. Se esse campo não existir, não haverá pedágio na RouteLeg.
speed_reading_intervals[]

SpeedReadingInterval

Intervalos de leitura rápida que detalham a densidade do tráfego. Aplicável em caso de preferências de roteamento TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Os intervalos cobrem toda a polilinha do RouteLeg sem sobreposição. O ponto inicial de um intervalo especificado é igual ao ponto final 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 de destino

RouteMatrixElement

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

Campos
origin_index

int32

Índice de base zero da origem na solicitação.
destination_index

int32

Índice de base zero do destino na solicitação.
status

Status

Código de status do erro para este elemento.
condition

RouteMatrixElementCondition

Indica se a rota foi encontrada ou não. Independente do status.
distance_meters

int32

A distância de viagem da rota, em metros.
duration

Duration

O tempo necessário para percorrer o trajeto. Se você definir routing_preference como TRAFFIC_UNAWARE, esse valor será o mesmo que 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 pelo trajeto sem considerar as condições de trânsito.
travel_advisory

RouteTravelAdvisory

Informações adicionais sobre a rota. Por exemplo, informações de restrição e de pedágio
fallback_info

FallbackInfo

Em alguns casos, quando o servidor não consegue calcular o trajeto com as preferências especificadas para um determinado par de origem/destino, ele pode usar um modo de cálculo diferente. Quando o modo de substituição é usado, esse campo contém informações detalhadas sobre a resposta de substituição. Caso contrário, esse campo não será definido.

RouteMatrixElementCondition

A condição da rota que está sendo retornada.

Tipos enumerados
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Usado somente quando o status do elemento não é OK.
ROUTE_EXISTS Uma rota foi encontrada, e as informações correspondentes foram preenchidas para o elemento.
ROUTE_NOT_FOUND Nenhum trajeto foi encontrado. Os campos que contêm informações de 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 partida
route_modifiers

RouteModifiers

Opcional. Modificadores para cada rota que usa isso como origem

RouteModifiers

Encapsula um conjunto de condições opcionais a serem satisfeitas ao calcular as rotas.

Campos
avoid_tolls

bool

Quando definido como "true", evita vias com pedágio sempre que possível, preferência a rotas sem pedágios. Aplicável apenas aos modos de viagem DRIVE e TWO_WHEELER.
avoid_highways

bool

Quando definido como "true", evita rodovias sempre que possível, preferência a rotas que não as incluem. Aplicável apenas aos modos de viagem DRIVE e TWO_WHEELER.
avoid_ferries

bool

Quando definido como "true", evita balsas quando razoável, preferência a rotas que não as incluem. Aplicável apenas aos modos de viagem DRIVE e TWO_WHEELER.
avoid_indoor

bool

Quando definido como verdadeiro, evita a navegação em ambientes internos sempre que possível, preferência a rotas que não contêm navegação em ambientes internos. 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 tags de pedágio. Se as tags de pedágio forem fornecidas, a API tentará retornar o preço delas. Se os tags de pedágio não forem informados, a API vai tratá-los como desconhecidos e tentará retornar o preço em dinheiro. Aplicável apenas aos modos de viagem DRIVE e TWO_WHEELER.

RouteObjective

Encapsula um objetivo de otimização por ComputeCustomRoutes.

Campos
Campo de união objective. O objetivo da rota. objective pode ser apenas de um dos tipos a seguir:
rate_card

RateCard

O objetivo RateCard.

RateCard

Encapsula um objetivo de rota 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 do pedágio deve ser incluído no custo geral.

MonetaryCost

Encapsula o custo usado na tabela de preços.

Campos
value

double

Obrigatório. O valor do custo na moeda local inferido da solicitação.

RouteTravelAdvisory

Encapsula as informações adicionais que o usuário precisa receber, como uma possível restrição de zona de tráfego etc.

Campos
toll_info

TollInfo

Encapsula informações sobre pedágios no trajeto. Esse campo só é preenchido se esperamos que haja pedágios na rota. Se esse campo estiver definido, mas o subcampo estimated_price não estiver preenchido, esperamos que a via tenha pedágios, mas não sabemos um preço estimado. Se esse campo não estiver definido, esperamos que não haja pedágio na rota.
speed_reading_intervals[]

SpeedReadingInterval

Intervalos de leitura rápida que detalham a densidade do tráfego. Aplicável em caso de preferências de roteamento TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Os intervalos cobrem toda a polilinha do trajeto sem sobreposição. O ponto inicial de um intervalo especificado é igual ao ponto final 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 usado para especificar o meio de transporte.

Tipos enumerados
TRAVEL_MODE_UNSPECIFIED Nenhum meio de transporte especificado. O valor padrão é DRIVE.
DRIVE Viajar de carro de passeio.
BICYCLE Viajar de bicicleta.
WALK Viajar a pé.
TWO_WHEELER Veículo motorizado de duas rodas. Por exemplo, moto. Isso é diferente do modo de viagem BICYCLE, que abrange o modo movido a força humana.
TAXI

Viajar de táxi licenciado, que pode permitir que o veículo circule em faixas designadas para táxis em algumas áreas.

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

RoutingPreference

Um conjunto de valores que especificam fatores a serem considerados ao calcular o trajeto.

Tipos enumerados
ROUTING_PREFERENCE_UNSPECIFIED Nenhuma preferência de roteamento especificada. O padrão é TRAFFIC_AWARE.
TRAFFIC_UNAWARE Calcula 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 relevantes. Usar esse valor produz a menor latência. Observação: para RouteTravelMode DRIVE e TWO_WHEELER, as opções de trajeto e duração se baseiam na rede viária e nas condições médias de trânsito (independente da hora), não nas condições de trânsito atuais. Assim, os trajetos podem incluir vias que estão temporariamente interditadas. Os resultados das solicitações variam em função de mudanças na rede viária, atualizações nas condições de trânsito e da natureza distribuída do serviço. Eles também variam entre trajetos quase equivalentes a qualquer momento ou frequência.
TRAFFIC_AWARE Calcula rotas considerando as condições de trânsito. Ao contrário do 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. Usar esse valor produz a maior latência.

SpeedReadingInterval

Indicador de densidade de tráfego em um segmento contíguo de uma polilinha ou 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 dele usando as seguintes categorias.

Campos
start_polyline_point_index

int32

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

int32

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

Speed

Velocidade do trânsito neste intervalo.

Velocidade

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

Tipos enumerados
SPEED_UNSPECIFIED Valor padrão. Esse valor não é usado.
NORMAL Velocidade normal, sem lentidão detectada.
SLOW Foi detectada uma lentidão, mas não um congestionamento.
TRAFFIC_JAM Congestionamento 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 Route ou RouteLeg correspondente. Essa lista contém um valor monetário para cada moeda que deve ser cobrada pelas praças de pedágio. Normalmente, essa lista contém apenas um item para rotas com pedágios em uma moeda. Para viagens internacionais, essa lista pode conter vários itens para refletir os pedágios em diferentes moedas.

TollPass

Lista de pedágios no mundo todo que aceitamos.

Tipos enumerados
TOLL_PASS_UNSPECIFIED Não utilizado. Se esse valor for usado, a solicitação vai falhar.
AU_ETOLL_TAG Um dos muitos provedores de tag de pedágio de Sydney. https://www.myetoll.com.au
AU_EWAY_TAG Um dos muitos provedores de tag de pedágio de Sydney. https://www.tollpay.com.au/
AU_LINKT Tag de pedágio em toda a Austrália. Confira mais detalhes em https://www.linkt.com.au/.
AR_TELEPASE Tag de pedágio da Argentina. Confira mais detalhes em https://telepase.com.ar
BR_AUTO_EXPRESO Tag de pedágio do Brasil. Confira mais detalhes em https://www.autoexpreso.com
BR_CONECTCAR Tag de pedágio do Brasil. Confira mais detalhes em https://conectcar.com.
BR_MOVE_MAIS Tag de pedágio do Brasil. Confira mais detalhes em https://movemais.com.
BR_PASSA_RAPIDO Tag de pedágio do Brasil. Confira mais detalhes em https://pasorapido.gob.do/
BR_SEM_PARAR Tag de pedágio do Brasil. Confira mais detalhes em https://www.semparar.com.br.
BR_TAGGY Tag de pedágio do Brasil. Confira mais detalhes em https://taggy.com.br.
BR_VELOE Tag de pedágio do Brasil. Confira mais detalhes em https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Travessia da fronteira do Canadá para os Estados Unidos.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Travessia da fronteira do Canadá para os Estados Unidos.
CA_US_BLUE_WATER_EDGE_PASS Travessia da fronteira de Ontário, Canadá, para Michigan, Estados Unidos.
CA_US_CONNEXION Travessia da fronteira de Ontário, Canadá, para Michigan, Estados Unidos.
CA_US_NEXUS_CARD Travessia da fronteira do Canadá para os Estados Unidos.
ID_E_TOLL Indonésia. Cartão eletrônico fornecido por vários bancos usado para pagar pedágios. Todos os e-cards via bancos são cobrados da mesma forma, então só é necessário um valor de enumeração. 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 Índia, isenção de placa estadual de HP.
JP_ETC ETC do Japão. Sistema eletrônico sem fio para coletar pedágios. https://www.go-etc.jp/ (em japonês)
JP_ETC2 ETC2.0 do Japão. Nova versão do ETC com mais desconto e comunicação bidirecional entre dispositivos em veículos e antenas na estrada. https://www.go-etc.jp/etc2/index.html
MX_IAVE 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 México http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE México
MX_TAG_TELEVIA Empresa de tag de pedágio do México. Uma das muitas que operam na Cidade do México. Confira mais detalhes em https://www.televia.com.mx (link em espanhol).
MX_TELEVIA Empresa de tag de pedágio do México. Uma das muitas que operam na Cidade do México. https://www.televia.com.mx (em espanhol)
MX_VIAPASS Tag de pedágio do México. Confira mais detalhes em https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, EUA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, EUA.
US_CA_FASTRAK CA, EUA.
US_CA_FASTRAK_CAV_STICKER Indica que o motorista tem um passe FasTrak além do adesivo de veículo antipoluição (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 DE, EUA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, EUA.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, EUA.
US_FL_EPASS FL, EUA.
US_FL_GIBA_TOLL_PASS FL, EUA.
US_FL_LEEWAY FL, EUA.
US_FL_SUNPASS FL, EUA.
US_FL_SUNPASS_PRO FL, EUA.
US_IL_EZPASSIL IL, EUA.
US_IL_IPASS IL, EUA.
US_IN_EZPASSIN IN, EUA.
US_KS_BESTPASS_HORIZON KS, EUA.
US_KS_KTAG KS, EUA.
US_KS_NATIONALPASS KS, EUA.
US_KS_PREPASS_ELITEPASS KS, EUA.
US_LA_GEAUXPASS Los Angeles, EUA.
US_LA_TOLL_TAG Los Angeles, EUA.
US_MA_EZPASSMA MA, EUA.
US_MD_EZPASSMD MD, EUA.
US_ME_EZPASSME ME, 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. Descontinuado porque esse tipo de cartão não existe mais.
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 NC, EUA.
US_NC_PEACH_PASS NC, EUA.
US_NC_QUICK_PASS NC, EUA.
US_NH_EZPASSNH NH, EUA.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, EUA.
US_NJ_EZPASSNJ NJ, EUA.
US_NY_EXPRESSPASS NY, EUA.
US_NY_EZPASSNY NY, EUA.
US_OH_EZPASSOH OH, EUA.
US_PA_EZPASSPA PA, EUA.
US_RI_EZPASSRI RI, EUA.
US_SC_PALPASS SC, EUA.
US_TX_AVI_TAG TX, EUA.
US_TX_BANCPASS TX, EUA.
US_TX_DEL_RIO_PASS TX, EUA.
US_TX_EFAST_PASS TX, EUA.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, EUA.
US_TX_EPTOLL TX, EUA.
US_TX_EZ_CROSS TX, EUA.
US_TX_EZTAG TX, EUA.
US_TX_FUEGO_TAG TX, EUA.
US_TX_LAREDO_TRADE_TAG TX, EUA.
US_TX_PLUSPASS TX, EUA.
US_TX_TOLLTAG TX, EUA.
US_TX_TXTAG TX, EUA.
US_TX_XPRESS_CARD TX, EUA.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, EUA.
US_VA_EZPASSVA VA, EUA.
US_WA_BREEZEBY WA, EUA.
US_WA_GOOD_TO_GO WA, 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.

Unidades

Um conjunto de valores que especificam a unidade de medida usada na exibição.

Tipos enumerados
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 descrevem o tipo de emissão do veículo. Válido apenas para o modo de viagem de CARRO.

Tipos enumerados
VEHICLE_EMISSION_TYPE_UNSPECIFIED Nenhum tipo de emissão especificado. O padrão é GASOLINE.
GASOLINE Veículo a gasolina.
ELECTRIC Veículo movido a eletricidade.
HYBRID Veículo híbrido (como gasolina + elétrico).

VehicleInfo

Encapsula 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 ao DRIVE RouteTravelMode.

Ponto de referência

Encapsula um ponto de referência. Os waypoints marcam o início e o fim de um trajeto e incluem paradas intermediárias ao longo dele.

Campos
via

bool

Marca este waypoint como um marco, e não um ponto de parada. Para cada ponto de parada não via na solicitação, a resposta adiciona uma entrada à matriz legs para fornecer os detalhes das paradas nesse trecho da viagem. Defina esse valor como "true" quando quiser que a rota passe por esse ponto de parada sem parar. Os waypoints intermediários não fazem com que uma entrada seja adicionada à matriz legs, mas direcionam a jornada pelo waypoint. Só é possível definir esse valor em pontos de parada intermediários. A solicitação falha se você definir esse campo em waypoints de terminal. Se ComputeRoutesRequest.optimize_waypoint_order for definido como "true", esse campo não poderá ser definido como "true". Caso contrário, a solicitação vai falhar.
vehicle_stopover

bool

Indica que o ponto de parada é para veículos pararem, com a intenção de embarcar ou desembarcar. Quando você define esse valor, a rota calculada não inclui pontos de parada não via em vias inadequadas para embarque e desembarque. Essa opção funciona apenas para os modos de viagem DRIVE e TWO_WHEELER e quando o location_type é location.
side_of_road

bool

Indica que o local deste waypoint tem uma preferência para que o veículo pare em um determinado lado da via. Quando você define esse valor, o trajeto passa pelo local para que o veículo possa parar na lateral da via em que o local está mais próximo do centro da via. Essa opção funciona apenas para os modos de viagem "CARRO" e "DUAS_RODAS".
Campo de união location_type. Diferentes maneiras de representar um local. location_type pode ser apenas de um dos tipos a seguir:
location

Location

Um ponto especificado usando coordenadas geográficas, incluindo um título opcional.
place_id

string

O ID de lugar do PDI associado ao ponto de referência.