Package google.maps.routes.v1

Waypoint

Obrigatório. Ponto de referência da origem.

Waypoint

Obrigatório. Ponto de referência do destino.

Waypoint

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.

RouteTravelMode

Opcional. Especifica o meio de transporte. No momento, somente o DRIVE é compatível.

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. No futuro, poderemos implementar um mecanismo substituto para usar uma opção diferente quando a opção preferida não fornecer um resultado válido. Só é possível especificar essa opção quando travel_mode é DRIVE ou TWO_WHEELER. Caso contrário, a solicitação vai falhar.

PolylineQuality

Opcional. Especifica sua preferência pela qualidade da polilinha.

PolylineEncoding

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

Timestamp

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. Se você definir esse valor para um horário que já ocorreu, a solicitação falhará.

RouteModifiers

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

RouteObjective

Obrigatório. Um objetivo de rota para otimização.

string

Opcional. O código de idioma BCP-47, como "pt-BR" ou "en-US". Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. 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.

Units

Opcional. Especifica as unidades de medida para os campos de exibição. Isso inclui o campo instruction em NavigationInstruction. As unidades de medida usadas para trajeto, trecho, distância do passo e 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 do local da solicitação.

CustomRoute

As "melhores" rotas para o objetivo da rota de entrada.

CustomRoute

O trajeto de referência mais rápido.

CustomRoute

A rota de referência mais curta.

FallbackInfo

Informações de fallback para rotas personalizadas.

FallbackRoutingMode

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

FallbackReason

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

FallbackRouteObjective

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

RouteMatrixOrigin

Obrigatório. Matriz de origens, que determina as linhas da matriz de resposta. Várias restrições de tamanho se aplicam à cardinalidade de origens e destinos:

• O número de elementos (origens × destinos) não pode ser maior que 625.
• Se o campo "route_preference" estiver definido como TRAFFIC_AWARE_OPTIMAL, o número de elementos (origens × destinos) não poderá ser maior que 100.
• O número de waypoints (origens + destinos) especificados como place_id não pode ser maior que 50.

RouteMatrixDestination

Obrigatório. Matriz de destinos, que determina as colunas da matriz de resposta.

RouteTravelMode

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. No futuro, poderemos implementar um mecanismo substituto para usar uma opção diferente quando a opção preferida não fornecer um resultado válido. Só é possível especificar essa opção quando travel_mode é DRIVE ou TWO_WHEELER. Caso contrário, a solicitação vai falhar.

Timestamp

Opcional. A hora de partida. Se você não definir esse valor, o padrão será o horário em que a solicitação foi feita. Se você definir esse valor para um horário que já ocorreu, a solicitação falhará.

Waypoint

Obrigatório. Ponto de referência da origem.

Waypoint

Obrigatório. Ponto de referência do destino.

Waypoint

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.

RouteTravelMode

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. No futuro, poderemos implementar um mecanismo substituto para usar uma opção diferente quando a opção preferida não fornecer um resultado válido. Só é possível especificar essa opção quando travel_mode é DRIVE ou TWO_WHEELER. Caso contrário, a solicitação vai falhar.

PolylineQuality

Opcional. Especifica sua preferência pela qualidade da polilinha.

PolylineEncoding

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

Timestamp

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. Se você definir esse valor para um horário que já ocorreu, a solicitação falhará.

bool

Especifica se é necessário calcular rotas alternativas além da rota.

RouteModifiers

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

string

Opcional. O código de idioma BCP-47, como "pt-BR" ou "en-US". Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. 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.

Units

Opcional. Especifica as unidades de medida para os campos de exibição. Isso inclui o campo instruction em NavigationInstruction. As unidades de medida usadas para trajeto, trecho, distância do passo e 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 do local da solicitação.

bool

Se OptimizeWaypointOrder for definido como true, será feita uma tentativa de reordenar os waypoints intermediários especificados para minimizar o custo total do trajeto. Se algum dos waypoints intermediários estiver percorrendo esse modo, a solicitação falhará. Use ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index para encontrar a nova ordem. Se routes.optimized_intermediate_waypoint_index não for solicitado no cabeçalho X-Goog-FieldMask, a solicitação falhará. Se OptimizeWaypointOrder for definido como falso, ComputeRoutesResponse.optimized_intermediate_waypoint_index vai estar vazio.

Route

Contém uma matriz de rotas calculadas (até três) quando você especifica compute_alternatives_routes e contém apenas uma rota quando você não especifica. Quando essa matriz contém várias entradas, a primeira é o trajeto mais recomendado. Se a matriz estiver vazia, isso significa que nenhum trajeto foi encontrado.

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.

Route

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

string

O token de rota codificado em base64 seguro para a Web que pode ser transmitido ao NavSDK, o que permite que o NavSDK reconstrua a rota durante a navegação e, no caso de reencaminhamento, respeite a intenção original quando o Routespreferred ComputeCustomRoutes é chamado. Os clientes devem tratar esse token como um blob opaco.

FallbackRoutingMode

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

FallbackReason

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

LatLng

As coordenadas geográficas do waypoint.

Int32Value

A orientação da bússola associada à direção do fluxo do tráfego. Esse valor é usado para especificar o lado da estrada a ser usado para embarque e desembarque. Os valores de cabeçalho podem variar de 0 a 360, em que 0 especifica uma orientação para o Norte, 90 especifica uma orientação para o Leste etc. Esse campo só pode ser usado para os modos de transporte DRIVE e TWO_WHEELER.

Maneuver

Agrupa as instruções de navegação para a etapa atual (por exemplo, virar à esquerda, mesclar, em frente etc.). Esse campo determina o ícone a ser exibido.

string

Instruções para fazer isso.

string

A codificação de strings da polilinha usando o algoritmo de codificação de polilinha

Struct

Especifica uma polilinha usando o formato LineString GeoJSON

RouteLeg

Um conjunto 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 é 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 a intermediates até destination.

int32

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

Duration

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

Duration

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

Polyline

A polilinha geral do trajeto. Esta será a polilinha combinada de todas as legs.

string

Uma descrição do trajeto.

string

Uma matriz de avisos a serem mostrados durante a exibição do trajeto.

Viewport

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

RouteTravelAdvisory

Informações adicionais sobre o trajeto.

int32

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

int32

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

Duration

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

Duration

A duração do percurso ao longo do trecho, calculada sem considerar as condições de trânsito.

Polyline

A polilinha geral deste trecho. Isso inclui a polilinha de cada step.

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, isso é um ponto na via.

Location

O local final deste trecho. Ele pode ser diferente do destination fornecido. Por exemplo, quando o destination fornecido não está perto de uma via, isso é um ponto na via.

RouteLegStep

Uma matriz de etapas denotando segmentos neste trecho. Cada etapa representa uma instrução de navegação.

RouteLegTravelAdvisory

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

int32

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

Duration

A duração da viagem por esta etapa sem levar em consideração as condições de trânsito. Em algumas circunstâncias, este campo pode não ter um valor.

Polyline

A polilinha associada a esta etapa.

Location

O local de início desta etapa.

Location

O local final desta etapa.

NavigationInstruction

Instruções de navegação.

RouteLegStepTravelAdvisory

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

SpeedReadingInterval

Intervalos de leitura de velocidade que detalham a densidade de tráfego. Aplicável no caso das preferências de roteamento TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Os intervalos cobrem toda a polilinha da RouteLegStep 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
speed_reading_intervals: [A,C), [C,D), [D,G).

TollInfo

Agrupa informações sobre pedágios no RouteLeg específico. Este campo só é preenchido quando há pedágios no RouteLeg. Se este campo estiver definido, mas o subcampo confirmar_preço não estiver preenchido, a estrada deve conter pedágios, mas não será possível saber um preço estimado. Se esse campo não existir, não haverá pedágio no RouteLeg.

SpeedReadingInterval

Intervalos de leitura de velocidade que detalham a densidade de tráfego. Aplicável no caso das preferências de roteamento TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Os intervalos cobrem toda a polilinha do RouteLg 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
speed_reading_intervals: [A,C), [C,D), [D,G).

Waypoint

Obrigatório. Ponto de referência do destino

int32

Índice baseado em zero da origem na solicitação.

int32

Índice baseado em zero do destino na solicitação.

Status

Código de status de erro para este elemento.

RouteMatrixElementCondition

Indica se o trajeto foi encontrado ou não. Independente do status.

int32

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

Duration

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

Duration

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

RouteTravelAdvisory

Informações adicionais sobre o trajeto. Por exemplo: informações de restrição e pedágios

FallbackInfo

Em alguns casos, quando o servidor não consegue computar a rota com as preferências informadas para esse par de origem/destino específico, ele pode voltar a usar um modo de cálculo 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.

Waypoint

Obrigatório. Ponto de referência da origem

RouteModifiers

Opcional. Modificadores para cada trajeto que usa esse nome como origem

bool

Especifica se é necessário evitar vias com pedágio onde for razoável. Será dada preferência aos trajetos que não contenham vias com pedágio. Aplicável apenas aos meios de transporte DRIVE e TWO_WHEELER.

bool

Especifica se é necessário evitar rodovias onde for razoável. Será dada preferência para trajetos que não contenham rodovias. Aplicável apenas aos meios de transporte DRIVE e TWO_WHEELER.

bool

Especifica se balsas devem ser evitadas quando for razoável. Será dada preferência aos trajetos que não contenham balsas. Aplicável apenas aos meios de transporte DRIVE e TWO_WHEELER.

bool

Especifica se é necessário evitar a navegação em ambientes fechados, quando razoável. Será dada preferência para trajetos que não contenham navegação interna. Aplicável apenas ao modo de viagem WALK.

VehicleInfo

Especifica as informações do veículo.

TollPass

Encapsula informações sobre passes de pedágio. Se os passes livres forem fornecidos, a API vai tentar retornar o preço do cartão. Se os passes livres não forem fornecidos, a API vai tratar o valor como desconhecido e tentar retornar o preço em dinheiro. Aplicável apenas aos meios de transporte DRIVE e TWO_WHEELER.

RateCard

O objetivo da tabela de preços.

MonetaryCost

Opcional. Custo por minuto.

MonetaryCost

Opcional. Custo por quilômetro.

bool

Opcional. Indica se o custo dos pedágios será incluído no custo geral.

double

Obrigatório. O valor de custo na moeda local inferido pela solicitação.

TollInfo

Agrupa informações sobre os pedágios do trajeto. Esse campo só é preenchido quando há pedágios no trajeto. Se este campo estiver definido, mas o subcampo confirmar_preço não estiver preenchido, a estrada deve conter pedágios, mas não será possível saber um preço estimado. Se esse campo não for definido, não haverá pedágio no trajeto.

SpeedReadingInterval

Intervalos de leitura de velocidade que detalham a densidade de tráfego. Aplicável no caso das preferências de roteamento TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Os intervalos abrangem toda a polilinha do trajeto 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
speed_reading_intervals: [A,C), [C,D), [D,G).

int32

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

int32

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

Speed

Velocidade do tráfego neste intervalo.

Money

O valor monetário dos pedágios para o trajeto ou trajeto correspondente. Esta lista contém uma quantia em dinheiro para cada moeda que deve ser cobrada pelas estações de pedágio. Normalmente, essa lista contém apenas um item para trajetos com pedágios em uma moeda. No caso de viagens internacionais, essa lista pode ter vários itens para refletir os pedágios em diferentes moedas.

VehicleEmissionType

Descreve o tipo de emissão do veículo. Aplicável apenas ao modo de viagem do DRIVE.

bool

Marca o ponto de referência como um marco em vez de um ponto de parada. Para cada waypoint que não é do ponto de referência na solicitação, a resposta anexa uma entrada à matriz legs para fornecer os detalhes das paradas nesse trecho da viagem. Defina esse valor como true quando quiser que o trajeto passe por esse waypoint sem parar. Os waypoints Via não fazem com que uma entrada seja adicionada à matriz legs, mas roteiam a jornada pelo waypoint. Esse valor só pode ser definido em waypoints intermediários. A solicitação falhará se você definir esse campo em waypoints do terminal. Se ComputeRoutesRequest.optimize_waypoint_order estiver definido como verdadeiro, este campo não poderá ser definido como verdadeiro. caso contrário, a solicitação vai falhar.

bool

Indica que o waypoint é destinado a veículos para parada, onde a intenção é embarcar ou desembarcar. Quando você definir esse valor, o trajeto calculado não incluirá waypoints que não sejam via em vias inadequadas para embarque e desembarque. Essa opção funciona apenas para os meios de transporte DRIVE e TWO_WHEELER e quando location_type é location.

bool

Indica que o local deste waypoint deve ter uma preferência quanto à parada do veículo em um lado específico da via. Quando você define esse valor, o trajeto passa pelo local para que o veículo possa parar no lado da via para a qual o local está direcionado do centro da estrada. Esta opção funciona apenas para "DRIVE" e 'TWO_WHEELER' meios de transporte e quando o campo 'location_type' é definido como "location".

Location

Um ponto especificado por meio de coordenadas geográficas, incluindo um cabeçalho opcional.

string

O ID de lugar do PDI associado ao waypoint.