- Solicitação HTTP
- Corpo da solicitação
- Corpo da resposta
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Trajeto
- RouteLabel
- RouteLeg
- Polilinhas
- RouteLegStep
- NavigationInstruction
- Manobra
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Janela de visualização
- RouteLocalizedValues
- GeocodingResults
- GeocodedWaypoint
Retorna o trajeto principal juntamente com trajetos alternativos opcionais, dado 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 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 do 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 de caractere curinga (*
) nem da especificação da máscara de campo no nível superior (routes
), porque:
- Selecionar apenas os campos necessários ajuda o servidor a economizar ciclos de computação, permitindo retornar o resultado com uma latência menor.
- A seleção apenas dos campos necessários no 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 mais tempo de computação. Se você selecionar todos os campos ou todos no nível superior, poderá observar uma queda no desempenho, porque todos os novos campos adicionados serão incluídos automaticamente na resposta.
- A seleção apenas dos campos necessários resulta em um tamanho de resposta menor e, portanto, em maior capacidade de 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 ( |
Campos | |
---|---|
origin |
Obrigatório. Ponto de referência de origem. |
destination |
Obrigatório. Ponto de referência de destino. |
intermediates[] |
Opcional. Um conjunto de pontos de referência ao longo do trajeto (exceto pontos terminais), para passar ou parar. São permitidos até 25 waypoints intermediários. |
travelMode |
Opcional. Especifica o meio de transporte. |
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 trajeto resultar em um erro ou em uma latência extra longa, um erro será retornado. Só é possível especificar essa opção quando |
polylineQuality |
Opcional. Especifica sua preferência para a qualidade da polilinha. |
polylineEncoding |
Opcional. Especifica a codificação preferencial para a polilinha. |
departureTime |
Opcional. O horário de partida. Se você não definir esse valor, o padrão será a hora em que você fez a solicitação. OBSERVAÇÃO: só será possível especificar um Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
arrivalTime |
Opcional. O horário de chegada. OBSERVAÇÃO: só pode ser definido quando Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
computeAlternativeRoutes |
Opcional. Especifica se rotas alternativas devem ser calculadas além do trajeto. Nenhum trajeto alternativo é retornado para solicitações que têm waypoints intermediários. |
routeModifiers |
Opcional. Um conjunto de condições a serem atendidas que afetam a forma como os trajetos são calculados. |
languageCode |
Opcional. O código de idioma BCP-47, como "en-US" ou "sr-Latn". Para saber mais, consulte Identificador de localidade Unicode. Para acessar a lista de idiomas compatíveis, consulte Suporte a idiomas. Quando você não fornece esse valor, o idioma de exibição é inferido com base no local da solicitação de rota. |
regionCode |
Opcional. O código regional, 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 |
Opcional. Especifica as unidades de medida para os campos de exibição. Esses campos incluem o campo |
optimizeWaypointOrder |
Opcional. Se for definido como verdadeiro, o serviço tentará minimizar o custo total do trajeto reorganizando os waypoints intermediários especificados. A solicitação falhará se qualquer um dos waypoints intermediários for um waypoint |
requestedReferenceRoutes[] |
Opcional. Especifica quais rotas de referência devem ser calculadas como parte da solicitação, além da rota padrão. Um trajeto de referência é aquele que tem um objetivo de cálculo de trajeto diferente do padrão. Por exemplo, um cálculo de rota de referência |
extraComputations[] |
Opcional. Uma lista de cálculos extras que podem ser usados para concluir a solicitação. Observação: esses cálculos extras podem retornar campos extras na resposta. Esses campos extras também precisam ser especificados na máscara de campo a ser retornada na resposta. |
trafficModel |
Opcional. Especifica as premissas a serem usadas no cálculo do tempo no trânsito. Essa configuração afeta o valor retornado no campo de duração nos |
transitPreferences |
Opcional. Especifica as preferências que influenciam o trajeto retornado para |
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 ( |
Campos | |
---|---|
routes[] |
Contém uma matriz de rotas computadas (até três) quando você especifica |
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 outra maneira de cálculo. Quando o modo substituto é usado, esse campo contém informações detalhadas sobre a resposta de fallback. Caso contrário, o campo não será definido. |
geocodingResults |
Contém informações de resposta de geocodificação para waypoints especificados como endereços. |
PolylineQuality
Um conjunto de valores que especifica a qualidade da polilinha.
Enums | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Nenhuma preferência de qualidade da polilinha especificada. O valor padrão é OVERVIEW . |
HIGH_QUALITY |
Especifica uma polilinha de alta qualidade, que é composta usando 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 usando um pequeno número de pontos. Use esse valor ao exibir uma visão geral do trajeto. O uso dessa opção tem uma latência de solicitação menor em comparação com a opção HIGH_QUALITY . |
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 GeoJSON LineString |
ReferenceRoute
Uma rota de referência com suporte no ComputeRoutesRequest.
Enums | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Não utilizado. As solicitações que contêm esse valor falham. |
FUEL_EFFICIENT |
Trajeto com baixo consumo de combustível. Os trajetos rotulados com esse valor são determinados como otimizados para parâmetros como o consumo de combustível. |
ExtraComputation
Computações extras a serem realizadas ao concluir a solicitação.
Enums | |
---|---|
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 estimado de combustível para os trajetos. |
TRAFFIC_ON_POLYLINE |
Polilinhas com informações de trânsito para os trajetos. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions apresentada como uma string de texto HTML formatada. Este conteúdo deve ser lido no estado em que se encontra, apenas para exibição. Não a analise de forma programática. |
Rota
Contém um trajeto, que consiste em uma série de segmentos de estrada conectados que juntam waypoints iniciais, finais e intermediários.
Representação JSON |
---|
{ "routeLabels": [ enum ( |
Campos | |
---|---|
routeLabels[] |
Rótulos do |
legs[] |
Uma coleção de trechos (segmentos de caminho entre waypoints) que compõem o trajeto. Cada trecho corresponde à viagem entre dois |
distanceMeters |
A distância de viagem do trajeto, em metros. |
duration |
O tempo necessário para navegar no trajeto. Se você definir Uma duração em segundos com até nove dígitos fracionários, terminando em " |
staticDuration |
A duração do percurso no trajeto sem considerar as condições de trânsito. Uma duração em segundos com até nove dígitos fracionários, terminando em " |
polyline |
A polilinha do trajeto geral. Esta é a polilinha combinada de todos os |
description |
Uma descrição do trajeto. |
warnings[] |
Uma matriz de avisos a serem mostrados ao exibir a rota. |
viewport |
A caixa delimitadora da janela de visualização da polilinha. |
travelAdvisory |
Outras informações sobre o trajeto. |
optimizedIntermediateWaypointIndex[] |
Se você definir |
localizedValues |
Representações de texto das propriedades do |
routeToken |
Um token de rota seguro para a Web e codificado em base64 que pode ser transmitido para o SDK do Navigation, permitindo que ele reconstrua a rota durante a navegação e, no caso de um novo trajeto, respeite a intenção original quando você criou a rota chamando v2.computeRoutes. Os clientes precisam tratar esse token como um blob opaco. Ele não é destinado para leitura ou modificação. OBSERVAÇÃO: |
RouteLabel
Rótulos do
que são úteis para identificar propriedades específicas do trajeto a serem comparadas.Route
Enums | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
Padrão: não usado. |
DEFAULT_ROUTE |
A "melhor" rota padrão retornada para o cálculo da rota. |
DEFAULT_ROUTE_ALTERNATE |
Uma alternativa à "melhor" rota padrão. Trajetos como esse serão retornados quando for especificado. |
FUEL_EFFICIENT |
Trajeto com baixo consumo de combustível. Os trajetos identificados com esse valor são otimizados para parâmetros Eco, como o consumo de combustível. |
RouteLeg
Contém um trecho entre waypoints diferentes de via
.
Representação JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Campos | |
---|---|
distanceMeters |
A distância de viagem do trecho do trajeto, em metros. |
duration |
O tempo necessário para navegar pelo trecho. Se Uma duração em segundos com até nove dígitos fracionários, terminando em " |
staticDuration |
A duração do percurso pelo trecho, calculada sem considerar as condições de trânsito. Uma duração em segundos com até nove dígitos fracionários, terminando em " |
polyline |
A polilinha geral deste trecho que inclui cada polilinha de |
startLocation |
O local de início deste trecho. Esse local pode ser diferente do |
endLocation |
O local de término deste trecho. Esse local pode ser diferente do |
steps[] |
Uma matriz de etapas que denotam segmentos neste trecho. Cada etapa representa uma instrução de navegação. |
travelAdvisory |
Contém as informações adicionais sobre as quais o usuário deve ser informado, como possíveis restrições de zona de trânsito, em um trecho do trajeto. |
localizedValues |
Representações de texto das propriedades do |
stepsOverview |
Informações gerais sobre as etapas neste |
Polilinha
Encapsula uma polilinha codificada.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união polyline_type . Encapsula o tipo de polilinha. O padrão é encryption_polyline. polyline_type pode ser apenas de um dos tipos a seguir: |
|
encodedPolyline |
A codificação de string da polilinha usando o algoritmo de codificação de polilinha |
geoJsonLinestring |
Especifica uma polilinha usando o formato GeoJSON LineString. |
RouteLegStep
Contém um segmento de uma
. Uma etapa corresponde a uma única instrução de navegação. Os trechos do trajeto são compostos de degraus.RouteLeg
Representação JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Campos | |
---|---|
distanceMeters |
A distância de viagem desta etapa, em metros. Em algumas circunstâncias, esse campo pode não ter um valor. |
staticDuration |
A duração do percurso nessa etapa sem considerar as condições de trânsito. Em algumas circunstâncias, esse campo pode não ter um valor. Uma duração em segundos com até nove dígitos fracionários, terminando em " |
polyline |
A polilinha associada a esta etapa. |
startLocation |
O local de início desta etapa. |
endLocation |
O local final desta etapa. |
navigationInstruction |
Instruções de navegação. |
travelAdvisory |
Contém as informações adicionais sobre as quais o usuário deve ser informado, como possíveis restrições de zona de tráfego, em uma etapa do trecho. |
localizedValues |
Representações de texto das propriedades do |
transitDetails |
Detalhes relacionados a esta etapa, se o meio de transporte for |
travelMode |
O meio de transporte usado nesta etapa. |
Maneuver
Um conjunto de valores que especificam a ação de navegação a ser realizada para a etapa atual (por exemplo, virar à esquerda, mesclar ou reta).
Enums | |
---|---|
MANEUVER_UNSPECIFIED |
Não utilizado. |
TURN_SLIGHT_LEFT |
Vire levemente para a esquerda. |
TURN_SHARP_LEFT |
Vire acentuado para a esquerda. |
UTURN_LEFT |
Faça uma curva em retorno à esquerda. |
TURN_LEFT |
Vire à esquerda. |
TURN_SLIGHT_RIGHT |
Vire levemente para a direita. |
TURN_SHARP_RIGHT |
Vire acentuado para a direita. |
UTURN_RIGHT |
Faça uma curva em 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 o garfo certo. |
FERRY |
Pegue o barco. |
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. |
RouteLegStepTravelAdvisory
Contém as informações adicionais sobre as quais o usuário deve ser informado, como possíveis restrições de zona de tráfego em uma etapa do trecho.
Representação JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
Campos | |
---|---|
speedReadingIntervals[] |
OBSERVAÇÃO: esse campo não está preenchido no momento. |
RouteLegStepLocalizedValues
Representações de texto de determinadas propriedades.
Representação JSON |
---|
{ "distance": { object ( |
Campos | |
---|---|
distance |
Distância do percurso representada em formato de texto. |
staticDuration |
Duração sem considerar as condições de trânsito, representada em formato de texto. |
RouteLegStepTransitDetails
Outras informações sobre o RouteLegStep
relacionadas aos trajetos do TRANSIT
.
Representação JSON |
---|
{ "stopDetails": { object ( |
Campos | |
---|---|
stopDetails |
Informações sobre as paradas de chegada e partida da etapa. |
localizedValues |
Representações de texto das propriedades do |
headsign |
Especifica a direção de deslocamento nessa linha, conforme marcada no veículo ou no ponto de partida. Muitas vezes, a direção é a estação terminal. |
headway |
Especifica o horário esperado como uma duração entre as partidas da mesma parada, nesse horário. Por exemplo, com um valor de 600 em segundos sobre intervalo, espera-se uma espera de 10 minutos caso perca o ônibus. Uma duração em segundos com até nove dígitos fracionários, terminando em " |
transitLine |
Informações sobre a linha de transporte público usada nesta etapa. |
stopCount |
O número de paradas desde a partida até o ponto de chegada. Essa contagem inclui a parada de chegada, mas exclui a de partida. Por exemplo, se o trajeto sair da parada A, passar pelas paradas B e C e chegar na parada D, o stopCount retornará 3. |
tripShortText |
O texto que aparece nos horários e placas de sinalização para identificar uma viagem de transporte público aos passageiros. O texto precisa identificar exclusivamente uma viagem em um dia de serviço. Por exemplo, "538" é o |
TransitStopDetails
Detalhes sobre as paradas de transporte público do RouteLegStep
.
Representação JSON |
---|
{ "arrivalStop": { object ( |
Campos | |
---|---|
arrivalStop |
Informações sobre o ponto de chegada da etapa. |
arrivalTime |
O horário previsto de chegada para a etapa. Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
departureStop |
Informações sobre o ponto de partida da etapa. |
departureTime |
O horário estimado de partida da etapa. Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
TransitStop
Informações sobre uma parada de transporte público.
Representação JSON |
---|
{
"name": string,
"location": {
object ( |
Campos | |
---|---|
name |
O nome da parada de transporte público. |
location |
O local da parada expresso em coordenadas de latitude/longitude. |
TransitDetailsLocalizedValues
Descrições localizadas de valores para RouteTransitDetails
.
Representação JSON |
---|
{ "arrivalTime": { object ( |
Campos | |
---|---|
arrivalTime |
Tempo na representação de texto formatada com um fuso horário correspondente. |
departureTime |
Tempo na representação de texto formatada com um fuso horário correspondente. |
LocalizedTime
Descrição localizada do tempo.
Representação JSON |
---|
{
"time": {
object ( |
Campos | |
---|---|
time |
O horário especificado como uma string em um determinado fuso horário. |
timeZone |
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 ( |
Campos | |
---|---|
agencies[] |
A (ou agências) de transporte público que opera essa linha de transporte público. |
name |
O nome completo dessa linha de transporte público. Por exemplo, "8 Avenue Local". |
uri |
o URI dessa linha de transporte público, conforme fornecido pela empresa de transporte público. |
color |
A cor normalmente usada na sinalização dessa linha. Representado em hexadecimal. |
iconUri |
URI do ícone associado a essa linha. |
nameShort |
O nome curto desta linha de transporte público. Normalmente, esse nome será um número de linha, como "M7" ou "355". |
textColor |
A cor normalmente usada no texto da sinalização dessa linha. Representado em hexadecimal. |
vehicle |
O tipo de veículo que opera nesta 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 |
O nome dessa empresa de transporte público. |
phoneNumber |
O número de telefone formatado da empresa de transporte público específico da localidade. |
uri |
O URI da empresa de transporte público. |
TransitVehicle
Informações sobre um veículo usado em trajetos de transporte público.
Representação JSON |
---|
{ "name": { object ( |
Campos | |
---|---|
name |
O nome deste veículo, em maiúsculas. |
type |
O tipo de veículo usado. |
iconUri |
O URI de um ícone associado a esse tipo de veículo. |
localIconUri |
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 os trajetos de transporte público.
Enums | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
Não utilizado. |
BUS |
Ônibus |
CABLE_CAR |
Um veículo que opera por meio de um cabo, normalmente terrestre. Bondes aéreos podem ser do tipo GONDOLA_LIFT . |
COMMUTER_TRAIN |
Trem metropolitano. |
FERRY |
Balsa. |
FUNICULAR |
Um veículo puxado por cabo em declives acentuados. Um funicular geralmente consiste em dois vagões que funcionam como contrapesos um para o outro. |
GONDOLA_LIFT |
Um bonde aéreo. |
HEAVY_RAIL |
Vagões pesados. |
HIGH_SPEED_TRAIN |
Trem de alta velocidade. |
INTERCITY_BUS |
Ônibus intermunicipal. |
LONG_DISTANCE_TRAIN |
Trem de longa distância. |
METRO_RAIL |
Trilho para veículos leves. |
MONORAIL |
Monotrilho. |
OTHER |
Todos os outros veículos |
RAIL |
Trem |
SHARE_TAXI |
Um transporte compartilhado é um veículo que pode deixar e coletar passageiros em qualquer ponto de sua rota. |
SUBWAY |
Veículo leve subterrâneo. |
TRAM |
Veículo leve acima do chão. |
TROLLEYBUS |
Ônibus elétrico. |
RouteLegTravelAdvisory
Contém as informações adicionais sobre as quais o usuário deve ser informado em uma etapa do trecho, como possíveis restrições de zona de tráfego.
Representação JSON |
---|
{ "tollInfo": { object ( |
Campos | |
---|---|
tollInfo |
Contém informações sobre pedágios no |
speedReadingIntervals[] |
Intervalos de leitura de velocidade que detalham a densidade do tráfego. Aplicável no caso de preferências de trajeto Exemplo:
|
RouteLegLocalizedValues
Representações de texto de determinadas propriedades.
Representação JSON |
---|
{ "distance": { object ( |
Campos | |
---|---|
distance |
Distância do percurso representada em formato de texto. |
duration |
Duração que considera as condições de trânsito representadas no formato de texto. Observação: se você não tiver solicitado informações de tráfego, esse valor será o mesmo que StaticDuration. |
staticDuration |
Duração sem considerar as condições de trânsito, representada em formato de texto. |
StepsOverview
Fornece informações gerais sobre uma lista de RouteLegStep
s.
Representação JSON |
---|
{
"multiModalSegments": [
{
object ( |
Campos | |
---|---|
multiModalSegments[] |
Informações resumidas sobre diferentes segmentos multimodais de |
MultiModalSegment
Fornece informações resumidas sobre diferentes segmentos multimodais do RouteLeg.steps
. Um segmento multimodal é definido como uma ou mais RouteLegStep
contíguas que têm a mesma RouteTravelMode
. Esse campo não será preenchido se RouteLeg
não tiver segmentos multimodais nas etapas.
Representação JSON |
---|
{ "navigationInstruction": { object ( |
Campos | |
---|---|
navigationInstruction |
NavigationInstrução para o segmento multimodal. |
travelMode |
O meio de transporte do segmento multimodal. |
stepStartIndex |
O índice |
stepEndIndex |
O índice |
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 seu limite. Os limites de latitude devem variar de -90 a 90 graus, inclusive, e os limites de longitude devem variar de -180 a 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 ehigh.longitude
= 180 graus, a janela de visualização incluirá todas as longitudes.Se
low.longitude
= 180 graus ehigh.longitude
= -180 graus, o intervalo de longitude ficará 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 erro.
Por exemplo, esta janela de visualização abrange 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 ( |
Campos | |
---|---|
low |
Obrigatório. O ponto inferior da janela de visualização. |
high |
Obrigatório. O ponto alto da janela de visualização. |
RouteLocalizedValues
Representações de texto de determinadas propriedades.
Representação JSON |
---|
{ "distance": { object ( |
Campos | |
---|---|
distance |
Distância do percurso representada em formato de texto. |
duration |
Duração que considera as condições de trânsito, representada em formato de texto. Observação: se você não solicitou informações de tráfego, esse valor será igual a |
staticDuration |
Duração sem considerar as condições de trânsito, representada em formato de texto. |
transitFare |
Tarifa de transporte público representada em formato de texto. |
GeocodingResults
Contém
para waypoints de origem, destino e intermediários. Preenchido apenas para waypoints de endereços.GeocodedWaypoints
Representação JSON |
---|
{ "origin": { object ( |
Campos | |
---|---|
origin |
Ponto de referência geocodificado de origem. |
destination |
Ponto de referência geocodificado de destino. |
intermediates[] |
Uma lista de waypoints geocodificados intermediários, cada um contendo um campo de índice que corresponde à posição baseada em zero do waypoint na ordem em que foram especificadas na solicitação. |
GeocodedWaypoint
Detalhes sobre os locais usados como waypoints. Preenchido apenas para waypoints de endereços. Inclui detalhes sobre os resultados de geocodificação com o objetivo de determinar para o que o endereço foi geocodificado.
Representação JSON |
---|
{
"geocoderStatus": {
object ( |
Campos | |
---|---|
geocoderStatus |
Indica o código de status resultante da operação de geocodificação. |
type[] |
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 |
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 |
O ID de local desse resultado. |
intermediateWaypointRequestIndex |
O índice do waypoint intermediário correspondente na solicitação. Preenchido apenas se o waypoint correspondente for intermediário. |