Route

Encapsula um trajeto, que é composto por uma série de segmentos de estrada conectados que une waypoints iniciais, finais e intermediários.

Representação JSON
{
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ]
}
Campos
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 diferentes do via. Por exemplo, um trajeto sem waypoints intermediários tem apenas um trecho. Um trajeto que inclui um waypoint intermediário que não seja via tem dois trechos. Um trajeto que inclui um waypoint intermediário via tem um trecho. A ordem dos trechos corresponde à ordem dos waypoints entre origin e intermediates e destination.

distanceMeters

integer

A distância de viagem do trajeto, em metros.

duration

string (Duration format)

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

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

staticDuration

string (Duration format)

A duração do percurso no 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 do trajeto geral. Essa polilinha será a polilinha combinada de todos os legs.

description

string

Uma descrição do trajeto.

warnings[]

string

Uma matriz de avisos a serem exibidos ao exibir o trajeto.

viewport

object (Viewport)

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

travelAdvisory

object (RouteTravelAdvisory)

Informações adicionais sobre o trajeto.

optimizedIntermediateWaypointIndex[]

integer

Se ComputeRoutesRequest.optimize_waypoint_order estiver definido como verdadeiro, esse campo conterá a ordem otimizada dos waypoints intermediários. Caso contrário, o campo ficará vazio. Por exemplo, suponha que a entrada seja Origem: LA; Intermediários: Dallas, Bangor, Phoenix; Destino: Nova York; e a ordem otimizada dos waypoints intermediários seja: Phoenix, Dallas, Bangor. Este campo contém os valores [2, 0, 1]. O índice começa com 0 para o primeiro waypoint intermediário.

RouteLeg

Encapsula um segmento entre waypoints diferentes de 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)
  }
}
Campos
distanceMeters

integer

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

duration

string (Duration format)

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

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

staticDuration

string (Duration format)

A duração do percurso em um 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 deste trecho. Isso inclui a polilinha de cada step.

startLocation

object (Location)

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

endLocation

object (Location)

O local de término deste trecho. Ele 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 denotam segmentos neste trecho. Cada etapa representa uma instrução de navegação.

travelAdvisory

object (RouteLegTravelAdvisory)

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

Polilinha

Encapsula uma polilinha codificada.

Representação JSON
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
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

string

Codificação de string da polilinha usando o algoritmo de codificação de polilinha

geoJsonLinestring

object (Struct format)

Especifica uma polilinha usando o formato GeoJSON LineString

RouteLegStep

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

Representação JSON
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  }
}
Campos
distanceMeters

integer

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

staticDuration

string (Duration format)

A duração do percurso nesta 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)

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

RouteLegStepTravelAdvisory

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

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

object (SpeedReadingInterval)

Intervalos de leitura de velocidade que detalham a densidade do tráfego. Aplicável em caso de preferências de trajeto TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Os intervalos abrangem toda a polilinha do RouteLegStep sem sobreposição. O ponto inicial de um intervalo especificado é igual ao ponto final do intervalo anterior.

Exemplos

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

RouteLegTravelAdvisory

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

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

object (TollInfo)

Encapsula informações sobre pedágios no RouteLeg específico. Esse campo só será preenchido se houver pedágios no RouteLeg. Se este campo for definido, mas o subcampo "estimatedPrice" não estiver preenchido, é esperado que a estrada contenha pedágios, mas não saibamos um preço estimado. Se esse campo não existir, não haverá pedágio no RouteLeg.

speedReadingIntervals[]

object (SpeedReadingInterval)

Intervalos de leitura de velocidade que detalham a densidade do tráfego. Aplicável em caso de preferências de trajeto TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Os intervalos abrangem toda a polilinha do RouteLg sem sobreposição. O ponto inicial de um intervalo especificado é igual ao ponto final do intervalo anterior.

Exemplos

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