- Solicitação HTTP
- Corpo da solicitação
- Corpo da resposta
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- RouteTokenOptions
- RouteTokenBehavior
- Rota
- RouteLabel
- RouteLeg
- RouteLegStep
- NavigationInstruction
- Manobra
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Janela de visualização
- RouteLocalizedValues
- RouteTokenUpdateFidelity
- PolylineDetails
- AltitudeInfo
- PolylinePointIndex
- IncidentInfo
- IncidentType
- SegmentInfo
- FerryInfo
- RoadFeatureState
- HighwayInfo
- TollInfo (em inglês)
- TunnelInfo (em inglês)
- VignetteInfo
- HovInfo (em inglês)
- RestrictionInfo
- PredictedSpeedInfo
- PredictedSpeedInterval
- GeocodingResults
- GeocodedWaypoint (em inglês)
Retorna o trajeto principal, juntamente com trajetos alternativos opcionais, considerando um conjunto de pontos de referência terminais e intermediários.
OBSERVAÇÃO: esse método exige a especificação de uma máscara de campo de resposta na entrada. É possível fornecer a máscara de campo de resposta usando o parâmetro de URL $fields
ou fields
, ou um cabeçalho HTTP/gRPC X-Goog-FieldMask
. Consulte os cabeçalhos e parâmetros de URL disponíveis. O valor é uma lista separada por vírgulas de caminhos de campo. Consulte a documentação detalhada sobre como construir os caminhos de campo.
Por exemplo, neste método:
- Máscara de campo de todos os campos disponíveis (para inspeção manual):
X-Goog-FieldMask: *
- Máscara de campo da duração, distância e polilinha no nível do trajeto (um exemplo de configuração de produção):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
O Google não recomenda o uso da máscara de campo de resposta curinga (*
) ou a especificação da máscara de campo no nível superior (routes
) pelos seguintes motivos:
- Selecionar apenas os campos necessários ajuda nosso servidor a salvar ciclos de computação, o que nos permite retornar o resultado com uma latência menor.
- Selecionar apenas os campos necessários para o job de produção garante um desempenho de latência estável. Podemos adicionar mais campos de resposta no futuro, e esses novos campos podem exigir tempo de computação extra. Se você selecionar todos os campos ou todos os campos no nível superior, poderá haver uma queda no desempenho, porque qualquer campo novo adicionado será automaticamente incluído na resposta.
- Selecionar apenas os campos necessários resulta em uma resposta menor e, portanto, em maior capacidade de rede.
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 da origem. |
destination |
Obrigatório. Ponto de referência do destino. |
intermediates[] |
Opcional. Um conjunto de waypoints ao longo do trajeto (excluindo pontos de terminal), para parada ou passagem. Até 25 waypoints intermediários são permitidos. |
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 roteamento resultar em um erro ou em uma latência extralonga, um erro será retornado. Só é possível especificar essa opção quando |
polylineQuality |
Opcional. Especifica sua preferência pela qualidade da polilinha. |
polylineEncoding |
Opcional. Especifica a codificação preferencial para a polilinha. |
departureTime |
Opcional. A hora de partida. Se você não definir esse valor, ele será usado como padrão para o horário em que a solicitação foi feita. OBSERVAÇÃO: só é possível especificar um Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
arrivalTime |
Opcional. O horário de chegada. OBSERVAÇÃO: só poderá ser definido quando Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
computeAlternativeRoutes |
Opcional. Especifica se é necessário calcular rotas alternativas além da rota. 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. Consulte Compatibilidade de idiomas para ver a lista de idiomas compatíveis. Quando você não fornece esse valor, o idioma de exibição é inferido com base no local da solicitação de trajeto. |
regionCode |
Opcional. O código de 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ódigos de país. |
units |
Opcional. Especifica as unidades de medida para os campos de exibição. Esses campos incluem o campo |
optimizeWaypointOrder |
Opcional. Se definida como verdadeira, o serviço tentará minimizar o custo total do trajeto reordenando os waypoints intermediários especificados. A solicitação falhará se algum dos waypoints intermediários for um |
requestedReferenceRoutes[] |
Opcional. Especifica quais rotas de referência serão calculadas como parte da solicitação, além da rota padrão. Um trajeto de referência tem um objetivo de cálculo diferente do trajeto padrão. Por exemplo, um cálculo de trajeto de referência de |
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. |
routeToken |
Opcional. Obsoleto: use |
routeTokenOptions |
Opcional. Os tokens de rota permitem que uma solicitação dependa de uma rota selecionada anteriormente. |
trafficModel |
Opcional. Especifica as suposições a serem usadas no cálculo do tempo no trânsito. Essa configuração afeta o valor retornado no campo de duração no |
transitPreferences |
Opcional. Especifica preferências que influenciam o trajeto retornado para rotas |
navigationSessionId |
Opcional. O ID da sessão de navegação gerado pelo cliente e usado para associar essa solicitação de rota aos registros de navegação do cliente para análise. Precisa ser um UUID em conformidade com RFC 4122 gerado aleatoriamente e exclusivo para uma sessão de navegação específica. |
Corpo da resposta
v2.computeRoute 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 computar os resultados da rota com todas as preferências de entrada, ele pode optar por usar uma forma de computação diferente. Quando o modo substituto é usado, esse campo contém informações detalhadas sobre a resposta substituta. Caso contrário, este campo não será definido. |
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.
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 do aumento do tamanho da resposta. Use esse valor quando precisar de mais precisão. |
OVERVIEW |
Especifica uma polilinha de visão geral, composta por um pequeno número de pontos. Use este valor para exibir uma visão geral do trajeto. O uso dessa opção tem uma latência de solicitação menor em comparação com o uso da opção HIGH_QUALITY . |
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 polilinha. |
GEO_JSON_LINESTRING |
Especifica uma polilinha usando o formato LineString GeoJSON |
ReferenceRoute
Uma rota de referência compatível no ComputeRoutesRequest.
Tipos enumerados | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Não utilizado. Solicitações com esse valor falham. |
FUEL_EFFICIENT |
Trajeto de baixo consumo de combustível. Os trajetos identificados com esse valor são determinados como otimizados para parâmetros como o consumo de combustível. |
ExtraComputation
Cálculos extras a serem executados ao concluir a solicitação.
Tipos enumerados | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Não utilizado. As solicitações que tiverem esse valor falharão. |
TOLLS |
Informações sobre pedágios dos trajetos. |
FUEL_CONSUMPTION |
Consumo estimado de combustível para os trajetos. |
TRAFFIC_ON_POLYLINE |
Polilinhas com base no trânsito nos trajetos |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions apresentado 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 o analise programaticamente. |
PREDICTED_SPEED_ON_POLYLINE_20KPH_BUCKETS |
Velocidade prevista de buckets de 20 km/h. Resultados nos seguintes : [0, 10) km/h, [10, 30) km/h, ... [110, 130) km/h, [130, inf) km/h. |
PREDICTED_SPEED_ON_POLYLINE_10KPH_BUCKETS |
Velocidade prevista de buckets de 10 km/h. Resulta nos seguintes : [0, 10) km/h, [10, 20) km/h, ... [120, 130) km/h, [130, inf) km/h. |
RouteTokenOptions
Opções relacionadas a tokens de rota.
Representação JSON |
---|
{
"routeToken": string,
"routeTokenBehavior": enum ( |
Campos | |
---|---|
routeToken |
Opcional. Se definido, uma rota "semelhante" à associada ao token será gerada, se possível. Você ainda deve fornecer os parâmetros de consulta originais (por exemplo, origem, destino etc.). |
routeTokenBehavior |
Opcional. Uma indicação de como tratar |
RouteTokenBehavior
Os modos compatíveis para tokens de rota.
Tipos enumerados | |
---|---|
ROUTE_TOKEN_BEHAVIOR_UNSPECIFIED |
Tratado como GET_ROUTE_UPDATES para fins de compatibilidade. |
GET_ROUTE_UPDATES |
Se |origin| estiver na rota representada por routeToken , uma das rotas resultantes será a representada por routeToken . Os trajetos restantes não estão relacionados. As atualizações são mais eficientes quando a |origin| está próxima do início da routeToken , ou seja, o usuário não se moveu para longe de onde routeToken foi gerado. |
GET_SIMILAR_ROUTES |
A rota representada por routeToken não é incluída na resposta, mas as outras rotas têm semelhança com routeToken como fator de ponderação na classificação. |
Rota
Contém um trajeto, que consiste em uma série de segmentos de estrada conectados que unem waypoints iniciais, finais e intermediários.
Representação JSON |
---|
{ "routeLabels": [ enum ( |
Campos | |
---|---|
routeLabels[] |
Rótulos do |
legs[] |
Um conjunto 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 Duração em segundos com até nove dígitos fracionários, terminando em " |
staticDuration |
A duração da viagem no trajeto sem considerar as condições de trânsito. Duração em segundos com até nove dígitos fracionários, terminando em " |
polyline |
A polilinha geral do trajeto. Esta é uma polilinha combinada de todas as |
description |
Uma descrição do trajeto. |
warnings[] |
Uma matriz de avisos a serem mostrados durante a exibição do trajeto. |
viewport |
A caixa delimitadora da janela de visualização da polilinha. |
travelAdvisory |
Informações adicionais sobre o trajeto. |
optimizedIntermediateWaypointIndex[] |
Se você definir |
localizedValues |
Representações de texto das propriedades da |
routeToken |
Um token de rota seguro para a Web e codificado em base64 que pode ser transmitido ao SDK do Navigation. Ele permite que esse SDK reconstrua a rota durante a navegação e, em caso de reencaminhamento, honra a intenção original de quando você criou a rota chamando v2.computeRoutes. Os clientes devem tratar esse token como um blob opaco. Não compare seu valor entre solicitações. Esse token pode ser alterado mesmo que a mesma rota seja retornada. OBSERVAÇÃO: |
routeTokenUpdateFidelity |
Para |
polylineDetails |
Contém informações sobre detalhes ao longo da polilinha. |
RouteLabel
Rótulos do
que são úteis para identificar propriedades específicas do trajeto e comparar com outras.Route
Tipos enumerados | |
---|---|
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. Rotas como essa serão retornadas quando for especificado. |
FUEL_EFFICIENT |
Trajeto de baixo consumo de combustível. Os trajetos identificados com esse valor são determinados como otimizados para parâmetros econômicos, como 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 no trecho. Se o Duração em segundos com até nove dígitos fracionários, terminando em " |
staticDuration |
A duração da viagem ao longo do trecho, calculada sem levar em consideração as condições de trânsito. Duração em segundos com até nove dígitos fracionários, terminando em " |
polyline |
A polilinha geral deste trecho que inclui a polilinha de cada |
startLocation |
O local de início deste trecho. Esse local pode ser diferente do |
endLocation |
O local final deste trecho. Esse local pode ser diferente do |
steps[] |
Uma matriz de etapas denotando 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 de trajeto. |
localizedValues |
Representações de texto das propriedades da |
stepsOverview |
Informações gerais sobre as etapas descritas neste |
RouteLegStep
Contém um segmento de um
. Uma etapa corresponde a uma única instrução de navegação. Os trechos do trajeto são compostos por 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 da viagem por esta etapa sem levar em consideração 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 " |
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 de trecho. |
localizedValues |
Representações de texto das propriedades da |
transitDetails |
Detalhes referentes a esta etapa, se o meio de transporte for |
travelMode |
O meio de transporte usado nesta etapa. |
Maneuver
Um conjunto de valores que especifica a ação de navegação a ser realizada na etapa atual (por exemplo, virar à esquerda, mesclar ou reto).
Tipos enumerados | |
---|---|
MANEUVER_UNSPECIFIED |
Não utilizado. |
TURN_SLIGHT_LEFT |
Vire levemente para a esquerda. |
TURN_SHARP_LEFT |
Vire acentuada para a esquerda. |
UTURN_LEFT |
Faça uma curva à esquerda. |
TURN_LEFT |
Vire à esquerda. |
TURN_SLIGHT_RIGHT |
Vire levemente para a direita. |
TURN_SHARP_RIGHT |
Vire acentuada para a direita. |
UTURN_RIGHT |
Faça uma curva para a direita. |
TURN_RIGHT |
Vire à direita. |
STRAIGHT |
Vá direto. |
RAMP_LEFT |
Pegue a rampa da esquerda. |
RAMP_RIGHT |
Pegue a rampa da direita. |
MERGE |
Entre no tráfego. |
FORK_LEFT |
Pegue a bifurcação da esquerda. |
FORK_RIGHT |
Pegue a bifurcação da direita. |
FERRY |
Pegue a balsa. |
FERRY_TRAIN |
Pegue o trem que leva até a balsa. |
ROUNDABOUT_LEFT |
Vire à esquerda na rotatória. |
ROUNDABOUT_RIGHT |
Vire à direita na rotatória. |
DEPART |
Manobra inicial. |
NAME_CHANGE |
Usado para indicar uma mudança no nome da rua. |
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 de trecho.
Representação JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
Campos | |
---|---|
speedReadingIntervals[] |
OBSERVAÇÃO: este campo não está preenchido no momento. |
RouteLegStepLocalizedValues
Representações de texto de determinadas propriedades.
Representação JSON |
---|
{ "distance": { object ( |
Campos | |
---|---|
distance |
Distância de viagem representada em forma de texto. |
staticDuration |
Duração sem considerar as condições de trânsito, representada em forma de texto. |
RouteLegStepTransitDetails
Outras informações para o RouteLegStep
relacionadas aos trajetos 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 da |
headsign |
Especifica a direção de deslocamento nessa linha, conforme marcada no veículo ou no ponto de partida. Geralmente, a direção é a estação terminal. |
headway |
Especifica o horário esperado como uma duração entre as partidas no mesmo ponto, nesse horário. Por exemplo, se o intervalo for igual a 600 segundos, aguarde 10 minutos caso perca o ônibus. 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 da partida até a parada de chegada. Essa contagem inclui a parada de chegada, mas exclui a parada de partida. Por exemplo, se o seu trajeto sai da parada A, passa pelas paradas B e C e chega à parada D, a stopCount retorna 3. |
tripShortText |
O texto que aparece em horários e placas para identificar uma viagem de transporte público para os passageiros. O texto deve identificar exclusivamente uma viagem no dia do 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 a parada de chegada para a etapa. |
arrivalTime |
O horário previsto de chegada para a etapa. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
departureStop |
Informações sobre a parada de partida da etapa. |
departureTime |
O horário estimado de partida da etapa. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", 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 |
Horário na representação de texto formatada com um fuso horário correspondente. |
departureTime |
Horário 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 empresa de transporte público que opera essa linha. |
name |
O nome completo dessa linha de transporte público, por exemplo, "8 Avenue Local". |
uri |
o URI da linha de transporte público, conforme fornecido pela empresa de transporte público. |
color |
A cor usada com frequência na sinalização dessa linha. Representado no formato hexadecimal. |
iconUri |
URI do ícone associado a essa linha. |
nameShort |
O nome curto desta linha de transporte público. Normalmente, o nome é um número de linha, como "M7" ou "355". |
textColor |
A cor usada com frequência no texto da sinalização dessa linha. Representado no formato hexadecimal. |
vehicle |
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 |
O nome desta empresa de transporte público. |
phoneNumber |
O número de telefone formatado específico da localidade da empresa de transporte público. |
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 letras maiúsculas. |
type |
O tipo de veículo usado. |
iconUri |
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 dos trajetos 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 sobre as quais o usuário precisa ser informado em uma etapa de 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 de tráfego. Aplicável no caso das preferências de roteamento Exemplo:
|
RouteLegLocalizedValues
Representações de texto de determinadas propriedades.
Representação JSON |
---|
{ "distance": { object ( |
Campos | |
---|---|
distance |
Distância de viagem representada em forma de texto. |
duration |
Duração considerando as condições de trânsito representadas em forma de texto. Observação: se você não solicitou informações de tráfego, esse valor será igual ao de "staticDuration". |
staticDuration |
Duração sem considerar as condições de trânsito, representada em forma 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 do |
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 o mesmo RouteTravelMode
. Esse campo não será preenchido se o RouteLeg
não tiver segmentos multimodais nas etapas.
Representação JSON |
---|
{ "navigationInstruction": { object ( |
Campos | |
---|---|
navigationInstruction |
NavigationInstruções 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 diagonalmente opostos low
e high
. Uma janela de visualização é considerada uma região fechada, ou seja, inclui seus limites. Os limites de latitude devem variar entre -90 e 90 graus, e os limites de longitude devem variar entre -180 e 180 graus. Os vários casos incluem:
Se
low
=high
, a janela de visualização consistirá nesse único ponto.Se
low.longitude
>high.longitude
, o intervalo de longitude é invertido (a janela de visualização cruza a linha de 180 graus de longitude).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 está vazio.Se
low.latitude
>high.latitude
, o intervalo de latitude estará vazio.
Tanto low
quanto high
precisam ser preenchidos, e a caixa representada não pode ficar vazia (conforme especificado pelas definições acima). Uma janela de visualização vazia resultará em erro.
Por exemplo, esta janela de visualização abrange totalmente 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 baixo 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 de viagem representada em forma de texto. |
duration |
Duração considerando as condições de trânsito, representada em forma 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 forma de texto. |
transitFare |
Tarifa de transporte público representada em formato de texto. |
RouteTokenUpdateFidelity
Para solicitações que usam routeTokenBehavior
GET_ROUTE_UPDATES
, identifica rotas construídas a partir do routeToken associado. (Não relacionado ao routeToken
nesta mensagem).
Tipos enumerados | |
---|---|
ROUTE_TOKEN_UPDATE_FIDELITY_UNSPECIFIED |
Esta rota não foi gerada com base em um token de rota. |
APPROXIMATE |
Essa rota é reconstruída a partir de um token de rota e é logicamente equivalente, mas a geometria da rota não é idêntica. |
IDENTICAL |
Essa rota é geométricamente idêntica a um token de rota. |
PolylineDetails
Detalhes correspondentes a um determinado índice ou segmento contíguo de uma polilinha. Dada uma polilinha com pontos P_0, P_1, ... e P_N (índice baseado em zero), o PolylineDetails
define um intervalo e os metadados associados.
Representação JSON |
---|
{ "altitudeInfo": [ { object ( |
Campos | |
---|---|
altitudeInfo[] |
Detalhes de altitude ao longo da polilinha. |
incidentInfo[] |
Detalhes do incidente na polilinha. |
segmentInfo[] |
Detalhes do segmento ao longo da polilinha. |
ferryInfo[] |
Detalhes do balsa ao longo da polilinha. Esse campo só será preenchido se uma solicitação especificar o modificador de rota |
highwayInfo[] |
Detalhes da rodovia ao longo da polilinha. Esse campo só será preenchido se uma solicitação especificar o modificador de rota |
tollInfo[] |
Detalhes dos pedágios na polilinha. Esse campo só será preenchido se uma solicitação especificar o modificador de rota |
tunnelInfo[] |
Detalhes do túnel ao longo da polilinha. Esse campo só será preenchido se uma solicitação especificar o modificador de rota |
vignetteInfo[] |
Detalhes da vinheta ao longo da polilinha. Esse campo só será preenchido se uma solicitação especificar o modificador de rota |
hovInfo[] |
Detalhes de hov ao longo da polilinha. Esse campo só é preenchido se uma solicitação especificar o modificador de trajeto |
restrictionInfo[] |
Detalhes da restrição ao longo da polilinha. Esse campo só será preenchido se uma solicitação especificar o modificador de trajeto |
predictedSpeeds[] |
Faixas de velocidade previstas na polilinha. |
AltitudeInfo
Agrupa informações sobre a altitude ao longo da polilinha.
Representação JSON |
---|
{
"polylinePointIndex": {
object ( |
Campos | |
---|---|
polylinePointIndex |
O local da medida de altitude ao longo da polilinha. |
altitudeMeters |
A altitude em metros em relação ao elipsoide WGS84. |
PolylinePointIndex
Agrupa os índices inicial e final para 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 |
O índice inicial desse detalhe na polilinha. |
endIndex |
O índice final desse detalhe na polilinha. |
IncidentInfo
Agrupa as informações sobre um incidente ao longo da polilinha.
Representação JSON |
---|
{ "incidentType": enum ( |
Campos | |
---|---|
incidentType |
O tipo de incidente. |
estimatedDelay |
Atraso estimado em relação ao tempo de travessia normal. Retornado apenas para INCIDENT_JAM. Duração em segundos com até nove dígitos fracionários, terminando em " |
polylinePointIndex |
A localização do incidente na polilinha. |
IncidentType
Os tipos de incidentes.
Tipos enumerados | |
---|---|
INCIDENT_TYPE_UNSPECIFIED |
Valor padrão. Esse valor não é usado. |
INCIDENT_ROAD_CLOSED |
Uma via interditada. |
INCIDENT_CRASH |
Uma falha. |
INCIDENT_CONSTRUCTION |
Construção. |
INCIDENT_JAM |
Congestionamento. |
SegmentInfo
Encapsula informações sobre segmentos ao longo da polilinha.
Representação JSON |
---|
{
"placeId": string,
"polylinePointIndex": {
object ( |
Campos | |
---|---|
placeId |
O ID de lugar desse trecho da via. |
polylinePointIndex |
A localização do trecho ao longo da polilinha. |
FerryInfo
Encapsula informações sobre balsas ao longo da polilinha.
Representação JSON |
---|
{ "ferryPresence": enum ( |
Campos | |
---|---|
ferryPresence |
Apenas saída. Indica se há uma balsa para um determinado trecho da polilinha. |
polylinePointIndex |
O local das informações relacionadas à balsa ao longo da polilinha. |
RoadFeatureState
Encapsula os estados dos elementos de estrada (por exemplo, rodovias, balsas etc.) ao longo de um trecho da polilinha.
Tipos enumerados | |
---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
O estado do elemento da via não foi calculado (valor padrão). |
EXISTS |
O elemento de estrada existe. |
DOES_NOT_EXIST |
O elemento da estrada não existe. |
HighwayInfo
Agrupa informações sobre as rodovias ao longo da polilinha.
Representação JSON |
---|
{ "highwayPresence": enum ( |
Campos | |
---|---|
highwayPresence |
Apenas saída. Indica se há uma rodovia para um determinado trecho da polilinha. |
polylinePointIndex |
A localização das informações relacionadas à rodovia ao longo da polilinha. |
TollInfo
Agrupa informações sobre pedágios ao longo da polilinha.
Representação JSON |
---|
{ "tollPresence": enum ( |
Campos | |
---|---|
tollPresence |
Apenas saída. Indica se existe um pedágio para um determinado trecho da polilinha. |
polylinePointIndex |
A localização das informações relacionadas aos pedágios na polilinha. |
TunnelInfo
Encapsula informações sobre túneis ao longo da polilinha.
Representação JSON |
---|
{ "tunnelPresence": enum ( |
Campos | |
---|---|
tunnelPresence |
Apenas saída. Indica se há um túnel para um determinado trecho da polilinha. |
polylinePointIndex |
O local das informações relacionadas ao túnel ao longo da polilinha. |
VignetteInfo
Encapsula informações sobre vinhetas ao longo da polilinha.
Representação JSON |
---|
{ "vignettePresence": enum ( |
Campos | |
---|---|
vignettePresence |
Apenas saída. Indica se há uma vinheta para um determinado trecho da polilinha. |
polylinePointIndex |
A localização das informações relacionadas à vinheta ao longo da polilinha. |
HovInfo
Agrupa informações sobre segmentos/faixas para veículos com alta ocupação ao longo da polilinha.
Representação JSON |
---|
{ "hovPresence": enum ( |
Campos | |
---|---|
hovPresence |
Apenas saída. Indica se há uma estrada/faixa para veículos com alta ocupação em um determinado trecho da polilinha. |
polylinePointIndex |
A localização das informações relacionadas a HOV na polilinha. |
RestrictionInfo
Encapsula informações sobre várias restrições ao longo da polilinha.
Representação JSON |
---|
{ "restrictionPresence": enum ( |
Campos | |
---|---|
restrictionPresence |
Apenas saída. Indica se há uma restrição para um determinado trecho da polilinha. |
polylinePointIndex |
O local das informações relacionadas à restrição ao longo da polilinha. |
Campo de união restriction . Agrupa os tipos de restrições que podem ser aplicadas a um determinado trecho da polilinha. restriction só pode ser de um dos seguintes tipos: |
|
restrictedHeightMm |
o limite de altura, em milímetros. Este campo é preenchido quando a altura restrita impede a passagem ou resulta em baixa liberação para o veículo especificado. |
PredictedSpeedInfo
Encapsula informações sobre as velocidades previstas ao longo da polilinha.
Representação JSON |
---|
{ "predictedSpeedInterval": { object ( |
Campos | |
---|---|
predictedSpeedInterval |
O intervalo de velocidades previstas nesta parte da polilinha. |
polylinePointIndex |
O local do intervalo de velocidade previsto ao longo da polilinha. |
PredictedSpeedInterval
Intervalo de velocidade flexível prevista, representando velocidades em [lowerBoundKphInclusive
, upperBoundKphExclusive
). Os intervalos retornados dependem de qual
foi especificado na solicitação.extraComputations
Representação JSON |
---|
{ "lowerBoundKphInclusive": integer, "upperBoundKphExclusive": integer } |
Campos | |
---|---|
lowerBoundKphInclusive |
Limite inferior inclusivo. |
upperBoundKphExclusive |
Limite superior exclusivo. Representa infinito quando não preenchido. |
GeocodingResults
Contém
para waypoints de origem, destino e intermediários. Preenchido apenas para waypoints do endereço.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 pontos de referência geocodificados intermediários, cada um contendo um campo de índice que corresponde à posição baseada em zero do ponto de referência, na ordem em que foram especificados na solicitação. |
GeocodedWaypoint
Detalhes sobre os locais usados como waypoints. Preenchido apenas para waypoints do endereço. Inclui detalhes sobre os resultados de geocodificação para fins de determinar para onde 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 lugar deste resultado. |
intermediateWaypointRequestIndex |
O índice do waypoint intermediário correspondente na solicitação. Preenchido apenas se o waypoint correspondente for um waypoint intermediário. |