Method: computeRoutes

Retorna o trajeto principal e os trajetos alternativos 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. É 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 parâmetros de URL e cabeçalhos disponíveis). O valor é uma lista separada por vírgulas de caminhos de campo. Consulte a 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çã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 com caractere 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, o que nos permite retornar o resultado com uma latência menor.
  • Selecionar apenas os campos necessários no job de produção garante uma 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á haver uma degradação no desempenho, porque qualquer novo campo que adicionarmos será incluído automaticamente na resposta.
  • Selecionar apenas os campos necessários resulta em uma resposta menor e, portanto, em uma maior capacidade de processamento da rede.

Solicitação HTTP

POST https://routes.googleapis.com/directions/v2:computeRoutes

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
Campos
origin

object (Waypoint)

Obrigatório. Waypoint de origem.

destination

object (Waypoint)

Obrigatório. Waypoint de destino.

intermediates[]

object (Waypoint)

Opcional. Um conjunto de waypoints ao longo do trajeto (exceto pontos de terminal) para parar ou passar. Até 25 waypoints intermediários são aceitos.

travelMode

enum (RouteTravelMode)

Opcional. Especifica o meio de transporte.

routingPreference

enum (RoutingPreference)

Opcional. Especifica como calcular o trajeto. O servidor tenta usar a preferência de trajeto selecionada para calcular o trajeto. Se a preferência de roteamento resultar em um erro ou em uma latência muito longa, um erro será retornado. Só é possível especificar essa opção quando travelMode é DRIVE ou TWO_WHEELER. Caso contrário, a solicitação falha.

polylineQuality

enum (PolylineQuality)

Opcional. Especifica sua preferência para a qualidade da polilinha.

polylineEncoding

enum (PolylineEncoding)

Opcional. Especifica a codificação preferencial para a polilinha.

departureTime

string (Timestamp format)

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. OBSERVAÇÃO: só é possível especificar um departureTime no passado quando RouteTravelMode está definido como TRANSIT. As viagens de transporte público ficam disponíveis por até 7 dias no passado ou 100 dias no futuro.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

arrivalTime

string (Timestamp format)

Opcional. O horário de chegada. OBSERVAÇÃO: este campo é ignorado quando as solicitações especificam um RouteTravelMode diferente de TRANSIT. É possível especificar departureTime ou arrivalTime, mas não ambos. As viagens de transporte público ficam disponíveis por até 7 dias no passado ou 100 dias no futuro.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

computeAlternativeRoutes

boolean

Opcional. Especifica se é necessário calcular rotas alternativas além da rota. Nenhuma rota alternativa é retornada para solicitações que têm waypoints intermediários.

routeModifiers

object (RouteModifiers)

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

languageCode

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 ao idioma para ver 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 trajeto.

regionCode

string

Opcional. O código da 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ódigo de país.

units

enum (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 a rota, o trecho, a distância da etapa e a 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 com base no local da primeira origem.

optimizeWaypointOrder

boolean

Opcional. Se definido como verdadeiro, o serviço tenta minimizar o custo geral do trajeto reordenando os pontos intermediários especificados. A solicitação vai falhar se algum dos waypoints intermediários for do tipo via. Use ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index para encontrar a nova ordem. Se ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index não for solicitado no cabeçalho X-Goog-FieldMask, a solicitação vai falhar. Se optimizeWaypointOrder for definido como falso, ComputeRoutesResponse.optimized_intermediate_waypoint_index ficará vazio.

requestedReferenceRoutes[]

enum (ReferenceRoute)

Opcional. Especifica quais trajetos de referência serão calculados como parte da solicitação, além do trajeto padrão. Uma rota de referência é uma rota com um objetivo de cálculo diferente da rota padrão. Por exemplo, um cálculo de trajeto de referência do FUEL_EFFICIENT considera vários parâmetros que geram um trajeto econômico ideal. Ao usar esse recurso, procure routeLabels nas rotas resultantes.

extraComputations[]

enum (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 para serem retornados na resposta.

trafficModel

enum (TrafficModel)

Opcional. Especifica as premissas que serão usadas no cálculo do tempo no trânsito. Essa configuração afeta o valor retornado no campo "Duration" em Route e 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.

transitPreferences

object (TransitPreferences)

Opcional. Especifica as preferências que influenciam o trajeto retornado para rotas TRANSIT. OBSERVAÇÃO: só é possível especificar um transitPreferences quando RouteTravelMode está definido como TRANSIT.

Corpo da resposta

v2.computeRoutes, a mensagem de resposta.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
Campos
routes[]

object (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 nenhum trajeto.

fallbackInfo

object (FallbackInfo)

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

geocodingResults

object (GeocodingResults)

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

PolylineQuality

Um conjunto de valores que especificam a qualidade da polilinha.

Tipos enumerados
POLYLINE_QUALITY_UNSPECIFIED Nenhuma preferência de qualidade de polilinha foi especificada. O valor padrão é OVERVIEW.
HIGH_QUALITY Especifica uma polilinha de alta qualidade, que é composta por mais pontos do que OVERVIEW, mas aumenta o tamanho da resposta. Use esse valor quando precisar de mais precisão.
OVERVIEW Especifica uma polilinha de visão geral, que é composta por um pequeno número de pontos. Use esse valor ao mostrar uma visão geral do trajeto. Essa opção tem uma latência de solicitação menor em comparação com a opção HIGH_QUALITY.

PolylineEncoding

Especifica o tipo preferencial de polilinha a ser retornado.

Tipos enumerados
POLYLINE_ENCODING_UNSPECIFIED Nenhuma preferência de tipo de polilinha foi 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.

ReferenceRoute

Um trajeto de referência compatível no ComputeRoutesRequest.

Tipos enumerados
REFERENCE_ROUTE_UNSPECIFIED Não utilizado. As solicitações que contêm esse valor falham.
FUEL_EFFICIENT Trajeto econômico.
SHORTER_DISTANCE

Trajeto com menor distância de viagem. Este é um recurso experimental.

Para solicitações de DRIVE, esse recurso prioriza distâncias mais curtas em vez do conforto ao dirigir. Por exemplo, ele pode preferir vias locais em vez de rodovias, pegar estradas de terra, passar por estacionamentos etc. Esse recurso não retorna nenhuma manobra que o Google Maps saiba que é ilegal.

Para solicitações BICYCLE e TWO_WHEELER, esse recurso retorna rotas semelhantes às retornadas quando você não especifica requestedReferenceRoutes.

Esse recurso não é compatível com outros meios de transporte, waypoints intermediários ou optimizeWaypointOrder. Essas solicitações vão falhar. No entanto, é possível usá-lo com qualquer routingPreference.

ExtraComputation

Cálculos extras a serem realizados ao concluir a solicitação. Outros valores podem ser adicionados no futuro.

Tipos enumerados
EXTRA_COMPUTATION_UNSPECIFIED Não utilizado. As solicitações que contiverem esse valor vão falhar.
TOLLS Informações sobre pedágios para os trajetos.
FUEL_CONSUMPTION Consumo de combustível estimado para os trajetos.
TRAFFIC_ON_POLYLINE Polilinhas com informações de trânsito para os trajetos.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstruction apresentado como uma string de texto HTML formatada. O conteúdo precisa ser lido no estado em que se encontra e serve apenas para exibição. Não faça a análise programática dele.
FLYOVER_INFO_ON_POLYLINE Informações de sobrevoo para os trajetos. A máscara de campo routes.polyline_details.flyover_info precisa ser especificada para retornar essas informações. No momento, esses dados só serão preenchidos para algumas áreas metropolitanas na Índia. Este recurso é experimental, e a SKU/cobrança está sujeita a mudanças.
NARROW_ROAD_INFO_ON_POLYLINE Informações sobre vias estreitas nos trajetos. A máscara de campo routes.polyline_details.narrow_road_info precisa ser especificada para retornar essas informações. No momento, esses dados só serão preenchidos para algumas áreas metropolitanas na Índia. Este recurso é experimental, e a SKU/cobrança está sujeita a mudanças.
TUNNEL_INFO_ON_POLYLINE Informações do túnel para as rotas. A máscara de campo routes.polyline_details.tunnel_info precisa ser especificada para retornar essas informações.
BRIDGE_INFO_ON_POLYLINE Informações sobre pontes para os trajetos. A máscara de campo routes.polyline_details.bridge_info precisa ser especificada para retornar essas informações.
SKYWAY_INFO_ON_POLYLINE Informações sobre passarelas para os trajetos. A máscara de campo routes.polyline_details.skyway_info precisa ser especificada para retornar essas informações.

Trajeto

Contém um trajeto, que consiste em uma série de segmentos de via conectados que unem os pontos de passagem inicial, final e intermediários.

Representação JSON
{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
Campos
routeLabels[]

enum (RouteLabel)

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

legs[]

object (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 para intermediates e para destination.

distanceMeters

integer

A distância do trajeto em metros.

duration

string (Duration format)

O tempo necessário para percorrer o trajeto. Se você definir routingPreference como TRAFFIC_UNAWARE, esse valor será o mesmo que staticDuration. Se você definir routingPreference como TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, esse valor será calculado considerando as condições de trânsito.

Quando routingPreference é definido como TRAFFIC_AWARE_OPTIMAL, a duração é calculada usando as velocidades de veículos de passageiros ou de caminhões (durações mais longas). As velocidades de caminhão são usadas se uma das seguintes condições for verdadeira:

Em todos os outros casos, as velocidades de veículos de passageiros são usadas, mesmo que outras dimensões ou pesos de veículos sejam especificados em vehicleInfo.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

staticDuration

string (Duration format)

A duração da viagem pelo trajeto sem considerar as condições de trânsito.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

polyline

object (Polyline)

A polilinha geral do trajeto. Essa polilinha é a combinação de todas as legs.

description

string

Uma descrição da rota.

warnings[]

string

Uma matriz de avisos que aparecem ao mostrar o trajeto.

viewport

object (Viewport)

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

travelAdvisory

object (RouteTravelAdvisory)

Mais informações sobre o trajeto.

optimizedIntermediateWaypointIndex[]

integer

Se você definir optimizeWaypointOrder como verdadeiro, esse campo vai conter a ordem otimizada dos waypoints intermediários. Caso contrário, esse campo fica vazio. Por exemplo, se você fornecer uma entrada de Origem: LA; Pontos intermediários: Dallas, Bangor, Phoenix; Destino: Nova York; e a ordem otimizada dos pontos intermediários for Phoenix, Dallas, Bangor, esse campo vai conter os valores [2, 0, 1]. O índice começa com 0 para o primeiro waypoint intermediário fornecido na entrada.

localizedValues

object (RouteLocalizedValues)

Representações de texto das propriedades do Route.

routeToken

string

Um token opaco que pode ser transmitido ao SDK Navigation para reconstruir o trajeto durante a navegação e, em caso de novo trajeto, respeitar a intenção original de quando o trajeto foi criado. Trate esse token como um blob opaco. Não compare o valor dele entre as solicitações, porque ele pode mudar mesmo que o serviço retorne exatamente o mesmo trajeto.

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 intermediários.

polylineDetails

object (PolylineDetails)

Contém informações sobre detalhes ao longo da polilinha.

RouteLabel

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

Tipos enumerados
ROUTE_LABEL_UNSPECIFIED Padrão: não usado.
DEFAULT_ROUTE O "melhor" trajeto padrão retornado para o cálculo do trajeto.
DEFAULT_ROUTE_ALTERNATE Uma alternativa ao trajeto "melhor" padrão. Rotas como essa serão retornadas quando computeAlternativeRoutes for especificado.
FUEL_EFFICIENT Trajeto econômico. As rotas com esse valor são otimizadas para parâmetros ecológicos, como consumo de combustível.
SHORTER_DISTANCE Trajeto com menor distância de viagem. Este é um recurso experimental.

RouteLeg

Contém um segmento entre waypoints que não são via.

Representação JSON
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
Campos
distanceMeters

integer

A distância do trecho do trajeto, em metros.

duration

string (Duration format)

O tempo necessário para navegar pelo trecho. Se routingPreference for definido como TRAFFIC_UNAWARE, esse valor será o mesmo que staticDuration. Se o routingPreference for TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, esse valor será calculado considerando as condições de trânsito.

Quando routingPreference é definido como TRAFFIC_AWARE_OPTIMAL, a duração é calculada usando as velocidades de veículos de passageiros ou de caminhões (durações mais longas). As velocidades de caminhão são usadas se uma das seguintes condições for verdadeira:

Em todos os outros casos, as velocidades de veículos de passageiros são usadas, mesmo que outras dimensões ou pesos de veículos sejam especificados em vehicleInfo.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

staticDuration

string (Duration format)

A duração da viagem pelo trecho, calculada sem considerar as condições de trânsito.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

polyline

object (Polyline)

A polilinha geral desse trecho, que inclui a polilinha de cada step.

startLocation

object (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, esse é um ponto na via.

endLocation

object (Location)

O local de término deste trecho. Esse local 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[]

object (RouteLegStep)

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

travelAdvisory

object (RouteLegTravelAdvisory)

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

localizedValues

object (RouteLegLocalizedValues)

Representações de texto das propriedades do RouteLeg.

stepsOverview

object (StepsOverview)

Informações gerais sobre as etapas neste RouteLeg. Esse campo é preenchido apenas para rotas de roteamento transitivo.

Polilinha

Encapsula uma polilinha codificada.

Representação JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of mutually exclusive fields.
}
Campos
Encapsula o tipo de polilinha. O padrão é encoded_polyline. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
encodedPolyline

string

A codificação de string da polilinha usando o algoritmo de codificação de polilinhas.

geoJsonLinestring

object (Struct format)

Especifica uma polilinha usando o formato LineString do GeoJSON.

Fim dos campos mutuamente exclusivos.

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

Representação JSON
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
Campos
distanceMeters

integer

A distância do trajeto desta etapa, em metros. Em algumas circunstâncias, esse campo pode não ter um valor.

staticDuration

string (Duration format)

A duração da viagem por essa etapa sem considerar as condições de trânsito. Em algumas circunstâncias, esse campo pode não ter um valor.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

polyline

object (Polyline)

A polilinha associada a esta etapa.

startLocation

object (Location)

O local de início desta etapa.

endLocation

object (Location)

O local final desta etapa.

navigationInstruction

object (NavigationInstruction)

Instruções de navegação.

travelAdvisory

object (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 do trecho.

localizedValues

object (RouteLegStepLocalizedValues)

Representações de texto das propriedades do RouteLegStep.

transitDetails

object (RouteLegStepTransitDetails)

Detalhes referentes a esta etapa se o meio de transporte for TRANSIT.

travelMode

enum (RouteTravelMode)

O modo de viagem usado para esta etapa.

Maneuver

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

Tipos enumerados
MANEUVER_UNSPECIFIED Não utilizado.
TURN_SLIGHT_LEFT Vire um pouco para a esquerda.
TURN_SHARP_LEFT Faça uma curva acentuada à esquerda.
UTURN_LEFT Faça um retorno à esquerda.
TURN_LEFT Vire à esquerda.
TURN_SLIGHT_RIGHT Vire um pouco para a direita.
TURN_SHARP_RIGHT Faça uma curva acentuada à direita.
UTURN_RIGHT Faça um retorno à direita.
TURN_RIGHT Vire à direita.
STRAIGHT Siga 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 a bifurcação à direita.
FERRY Pegue a balsa.
FERRY_TRAIN Pegue o trem que leva à 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.
DESTINATION Usado para indicar a chegada a um destino.

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

Representação JSON
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Campos
speedReadingIntervals[]

object (SpeedReadingInterval)

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

RouteLegStepLocalizedValues

Representações de texto de determinadas propriedades.

Representação JSON
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Campos
distance

object (LocalizedText)

Distância do trajeto representada em formato de texto.

staticDuration

object (LocalizedText)

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

RouteLegStepTransitDetails

Informações adicionais para o RouteLegStep relacionadas às rotas TRANSIT.

Representação JSON
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
Campos
stopDetails

object (TransitStopDetails)

Informações sobre as paradas de chegada e partida da etapa.

localizedValues

object (TransitDetailsLocalizedValues)

Representações de texto das propriedades do RouteLegStepTransitDetails.

headsign

string

Especifica a direção de deslocamento nessa linha, conforme marcada no veículo ou no ponto de partida. A direção costuma ser a estação terminal.

headway

string (Duration format)

Especifica o tempo esperado como uma duração entre as partidas da mesma parada nesse horário. Por exemplo, se o valor de headway_seconds for 600, aguarde 10 minutos caso perca o ônibus.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

transitLine

object (TransitLine)

Informações sobre a linha de transporte público usada nesta etapa.

stopCount

integer

O número de paradas entre a partida e a chegada. Essa contagem inclui a parada de chegada, mas exclui a de partida. Por exemplo, se o trajeto sai da parada A, passa pelas paradas B e C e chega à parada D, stopCount retorna 3.

tripShortText

string

O texto que aparece nos horários e nas placas para identificar uma viagem de transporte público para os passageiros. O texto precisa identificar exclusivamente uma viagem em um dia de serviço. Por exemplo, "538" é o tripShortText do trem da Amtrak que sai de San Jose, CA, às 15h10 nos dias úteis, com destino a Sacramento, CA.

TransitStopDetails

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

Representação JSON
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
Campos
arrivalStop

object (TransitStop)

Informações sobre a parada de chegada da etapa.

arrivalTime

string (Timestamp format)

O horário previsto de chegada para a etapa.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

departureStop

object (TransitStop)

Informações sobre a parada de partida da etapa.

departureTime

string (Timestamp format)

O horário estimado de partida da etapa.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

TransitStop

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

Representação JSON
{
  "name": string,
  "location": {
    object (Location)
  }
}
Campos
name

string

O nome da parada de transporte público.

location

object (Location)

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

TransitDetailsLocalizedValues

Descrições localizadas de valores para RouteTransitDetails.

Representação JSON
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
Campos
arrivalTime

object (LocalizedTime)

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

departureTime

object (LocalizedTime)

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

LocalizedTime

Descrição localizada do horário.

Representação JSON
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
Campos
time

object (LocalizedText)

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

timeZone

string

Contém o fuso horário. O valor é o nome do fuso horário conforme definido no banco de dados de fusos horários da IANA, por exemplo, "America/New_York".

TransitLine

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

Representação JSON
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
Campos
agencies[]

object (TransitAgency)

A empresa (ou empresas) de transporte público que opera essa linha.

name

string

O nome completo da linha de transporte público, por exemplo, "8 Avenue Local".

uri

string

O URI dessa 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 em hexadecimal.

iconUri

string

O URI do ícone associado a essa linha.

nameShort

string

O nome curto da linha de transporte público. Normalmente, esse nome é o número da linha, como "M7" ou "355".

textColor

string

A cor usada com frequência no texto da sinalização dessa linha. Representado em hexadecimal.

vehicle

object (TransitVehicle)

O tipo de veículo que opera nessa linha de transporte público.

TransitAgency

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

Representação JSON
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
Campos
name

string

O nome da empresa de transporte público.

phoneNumber

string

O número de telefone da empresa de transporte público no formato internacional.

uri

string

O URI da empresa de transporte público.

TransitVehicle

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

Representação JSON
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
Campos
name

object (LocalizedText)

O nome do veículo, em letras maiúsculas.

type

enum (TransitVehicleType)

O tipo de veículo usado.

iconUri

string

O URI de um ícone associado a esse tipo de veículo.

localIconUri

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 para rotas de transporte público.

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

RouteLegTravelAdvisory

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

Representação JSON
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Campos
tollInfo

object (TollInfo)

Contém informações sobre pedágios no RouteLeg específico. Esse campo só será preenchido se houver pedágios no RouteLeg e se TOLLS estiver incluído no ComputeRoutesRequest.extra_computations da solicitação. Se esse campo estiver definido, mas o subcampo estimatedPrice não estiver preenchido, esperamos que a via tenha pedágios, mas não sabemos o preço estimado. Se tollInfo não existir, não haverá pedágio no RouteLeg.

speedReadingIntervals[]

object (SpeedReadingInterval)

Intervalos de leitura de velocidade que indicam a densidade do tráfego. Esse campo só é preenchido para solicitações quando elas têm um valor TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference, e TRAFFIC_ON_POLYLINE está incluído em ComputeRoutesRequest.extra_computations. Os intervalos cobrem toda a polilinha do 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
speedReadingIntervals: [A,C), [C,D), [D,G).

RouteLegLocalizedValues

Representações de texto de determinadas propriedades.

Representação JSON
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Campos
distance

object (LocalizedText)

Distância de viagem representada em formato de texto.

duration

object (LocalizedText)

Duração, representada em formato de texto e localizada para a região da consulta. Considera as condições de trânsito. Observação: se você não solicitou informações de trânsito, esse valor é igual ao de staticDuration.

staticDuration

object (LocalizedText)

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

StepsOverview

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

Representação JSON
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
Campos
multiModalSegments[]

object (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 um ou mais RouteLegStep contíguos que têm o mesmo RouteTravelMode. Esse campo não será preenchido se o RouteLeg não tiver segmentos multimodais nas etapas.

Representação JSON
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
Campos
navigationInstruction

object (NavigationInstruction)

NavigationInstruction para o segmento multimodal.

travelMode

enum (RouteTravelMode)

O meio de transporte do segmento multimodal.

stepStartIndex

integer

O índice RouteLegStep correspondente que é o início de um segmento multimodal.

stepEndIndex

integer

O índice RouteLegStep correspondente que é o fim de um segmento multimodal.

Janela de visualização

Uma janela de visualização de latitude e longitude, representada como dois pontos low e high diagonalmente opostos. Uma janela de visualização é considerada uma região fechada, ou seja, inclui o limite. Os limites de latitude precisam estar entre -90 e 90 graus, e os de longitude, entre -180 e 180 graus. Vários casos incluem:

  • Se low = high, a janela de visualização consiste nesse único ponto.

  • Se low.longitude > high.longitude, o intervalo de longitude será invertido (a janela de visualização cruza a linha de longitude de 180 graus).

  • Se low.longitude = -180 graus e high.longitude = 180 graus, a janela de visualização inclui todas as longitudes.

  • Se low.longitude = 180 graus e high.longitude = -180 graus, o intervalo de longitude fica vazio.

  • Se low.latitude > high.latitude, o intervalo de latitude estará vazio.

low e high precisam ser preenchidos, e a caixa representada não pode estar vazia (conforme especificado pelas definições acima). Uma janela de visualização vazia vai resultar em um erro.

Por exemplo, esta janela de visualização inclui totalmente a cidade de Nova York:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Representação JSON
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Campos
low

object (LatLng)

Obrigatório. O ponto mais baixo da janela de visualização.

high

object (LatLng)

Obrigatório. O ponto mais alto da janela de visualização.

RouteLocalizedValues

Representações de texto de determinadas propriedades.

Representação JSON
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
Campos
distance

object (LocalizedText)

Distância de viagem representada em formato de texto.

duration

object (LocalizedText)

Duração, representada em formato de texto e localizada para a região da consulta. Considera as condições de trânsito. Observação: se você não solicitou informações de trânsito, esse valor é igual a staticDuration.

staticDuration

object (LocalizedText)

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

transitFare

object (LocalizedText)

Tarifa de transporte público representada em formato de texto.

PolylineDetails

Detalhes correspondentes a um determinado índice ou segmento contíguo de uma polilinha. Dada uma polilinha com os pontos P_0, P_1, ... , P_N (índice baseado em zero), o PolylineDetails define um intervalo e os metadados associados.

Representação JSON
{
  "tunnelInfo": [
    {
      object (TunnelInfo)
    }
  ],
  "restrictionInfo": [
    {
      object (RestrictionInfo)
    }
  ],
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ],
  "bridgeInfo": [
    {
      object (BridgeInfo)
    }
  ],
  "skywayInfo": [
    {
      object (SkywayInfo)
    }
  ]
}
Campos
tunnelInfo[]

object (TunnelInfo)

Detalhes do túnel ao longo da polilinha. Esse campo será preenchido se a solicitação especificar o modificador de trajeto avoidTunnels e o trajeto resultante não conseguir evitá-los OU se TUNNEL_INFO_ON_POLYLINE for especificado em extraComputations e o trajeto tiver túneis.

restrictionInfo[]

object (RestrictionInfo)

Detalhes da restrição ao longo da polilinha. Esse campo só é preenchido se uma solicitação especificar o modificador de rota vehicleInfo e a rota resultante tiver uma restrição aplicável. Caso contrário, esse campo não será usado.

flyoverInfo[]

object (FlyoverInfo)

Detalhes do sobrevoo ao longo da polilinha.

narrowRoadInfo[]

object (NarrowRoadInfo)

Detalhes de vias estreitas ao longo da polilinha.

bridgeInfo[]

object (BridgeInfo)

Detalhes da ponte ao longo da polilinha.

skywayInfo[]

object (SkywayInfo)

Detalhes da passarela ao longo da polilinha.

TunnelInfo

Encapsula informações sobre túneis ao longo da polilinha.

Representação JSON
{
  "tunnelPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Campos
tunnelPresence

enum (RoadFeatureState)

Indica se há um túnel em um determinado trecho da polilinha.

polylinePointIndex

object (PolylinePointIndex)

O local das informações relacionadas ao túnel ao longo da polilinha.

RoadFeatureState

Encapsula os estados dos elementos da via ao longo de um trecho de polilinha.

Tipos enumerados
ROAD_FEATURE_STATE_UNSPECIFIED O estado do elemento da via não foi calculado (valor padrão).
EXISTS O elemento de via existe.
DOES_NOT_EXIST O recurso de via não existe.

PolylinePointIndex

Encapsula os índices de início e fim de um detalhe de polilinha. Para instâncias em que os dados correspondem a um único ponto, startIndex e endIndex serão iguais.

Representação JSON
{
  "startIndex": integer,
  "endIndex": integer
}
Campos
startIndex

integer

O índice inicial desse detalhe na polilinha.

endIndex

integer

O índice final desse detalhe na polilinha.

RestrictionInfo

Encapsula informações sobre várias restrições ao longo da polilinha.

Representação JSON
{
  "restrictionPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "restrictedHeightMm": string,
  "restrictedWeightKg": string,
  "hazardousGoods": boolean,
  "trucksProhibited": boolean
  // End of mutually exclusive fields.
}
Campos
restrictionPresence

enum (RoadFeatureState)

Apenas saída. Indica se há uma restrição para um determinado trecho da polilinha.

polylinePointIndex

object (PolylinePointIndex)

O local das informações relacionadas à restrição ao longo da polilinha.

Encapsula os tipos de restrições que podem ser aplicadas a um determinado trecho da polilinha. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
restrictedHeightMm

string (int64 format)

O limite de altura, em milímetros. Esse campo é preenchido quando a altura restrita impede a passagem ou resulta em uma altura livre baixa para o veículo especificado.

restrictedWeightKg

string (int64 format)

O limite de peso, em quilogramas. Esse campo é preenchido quando a restrição de peso impede a passagem ou está próxima do peso do veículo especificado.

hazardousGoods

boolean

Esse campo é definido como verdadeiro quando o transporte de produtos perigosos é restrito.

trucksProhibited

boolean

Esse campo é definido como verdadeiro quando caminhões são proibidos.

Fim dos campos mutuamente exclusivos.

FlyoverInfo

Encapsula informações sobre sobrevoos ao longo da polilinha.

Representação JSON
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Campos
flyoverPresence

enum (RoadFeatureState)

Apenas saída. Indica se há um viaduto em um determinado trecho da polilinha.

polylinePointIndex

object (PolylinePointIndex)

O local das informações relacionadas ao sobrevoo ao longo da polilinha.

NarrowRoadInfo

Encapsula informações sobre vias estreitas ao longo da polilinha.

Representação JSON
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Campos
narrowRoadPresence

enum (RoadFeatureState)

Apenas saída. Indica se há uma via estreita em um determinado trecho da polilinha.

polylinePointIndex

object (PolylinePointIndex)

O local das informações relacionadas à via estreita ao longo da polilinha.

BridgeInfo

Encapsula informações sobre pontes ao longo da polilinha.

Representação JSON
{
  "bridgePresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Campos
bridgePresence

enum (RoadFeatureState)

Indica se há uma ponte em um determinado trecho da polilinha.

polylinePointIndex

object (PolylinePointIndex)

O local das informações relacionadas à ponte ao longo da polilinha.

SkywayInfo

Encapsula informações sobre passarelas ao longo da polilinha.

Representação JSON
{
  "skywayPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Campos
skywayPresence

enum (RoadFeatureState)

Indica se há uma passarela em um determinado trecho da polilinha.

polylinePointIndex

object (PolylinePointIndex)

O local das informações relacionadas à passarela ao longo da polilinha.

GeocodingResults

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

Representação JSON
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
Campos
origin

object (GeocodedWaypoint)

Waypoint geocodificado de origem.

destination

object (GeocodedWaypoint)

Waypoint geocodificado de destino.

intermediates[]

object (GeocodedWaypoint)

Uma lista de waypoints geocodificados intermediários, cada um com um campo de índice que corresponde à posição baseada em zero do waypoint na ordem em que foram especificados na solicitação.

GeocodedWaypoint

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

Representação JSON
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
Campos
geocoderStatus

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

partialMatch

boolean

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.

placeId

string

O ID de lugar do resultado.

intermediateWaypointRequestIndex

integer

O índice do ponto intermediário correspondente na solicitação. Preenchido apenas se o waypoint correspondente for intermediário.