Visão geral da pesquisa no trajeto

Os recursos de pesquisa no trajeto estão disponíveis nas seguintes APIs Places (novo):

• Text Search (novo) apenas:pesquisa lugares ao longo de um trajeto de viagem predefinido.
• Text Search (novo) e Nearby Search (novo): calcula o resumo do roteamento de um local de origem especificado para cada lugar nos resultados da pesquisa.
• Text Search (novo) apenas: calcula o resumo do roteamento para cada lugar ao longo de um trajeto de viagem predefinido.

Pesquisar em um trajeto

Use a API Routes para calcular o trajeto de viagem entre dois locais. A API Routes pode calcular um trajeto para um carro, bicicleta, veículo de duas rodas, sistema de transporte público ou para caminhada.

Observação:os trajetos de transporte público não são compatíveis com a API Places.

A Text Search (novo) permite usar esse trajeto calculado para realizar uma pesquisa no trajeto. Com essa opção, você transmite o trajeto pré-calculado da API Routes para a solicitação da Text Search (novo). A resposta contém lugares que correspondem aos critérios de pesquisa e também estão localizados perto do trajeto especificado.

A pesquisa no trajeto é semelhante ao uso das opções de solicitação locationRestriction ou locationBias para influenciar os resultados da pesquisa. locationRestriction retorna resultados de pesquisa que estão dentro dos limites da janela de visualização, enquanto locationBias pode retornar resultados de pesquisa fora da janela de visualização. No entanto, embora as opções locationBias e locationRestriction permitam especificar uma região para influenciar os resultados da pesquisa, o recurso de pesquisa no trajeto da Text Search também permite influenciar os resultados da pesquisa para incluir aqueles com tempos de desvio mínimos da origem ao destino do trajeto. Você pode influenciar os resultados da pesquisa usando locationBias ou locationRestriction em combinação com a polilinha.

Por exemplo, considere o trajeto da origem, chamado de waypoint na API Routes, até o destino, conforme calculado pela API Routes:

Ao pesquisar no trajeto, a pesquisa é influenciada para retornar lugares próximos ao trajeto com tempos de desvio mínimos da origem ao destino. Neste exemplo, os pontos A, B e C são lugares retornados pela pesquisa.

Calcular o resumo do roteamento

A Text Search (novo) e a Nearby Search (novo) podem calcular o resumo do roteamento, ou seja, a duração e a distância, para cada lugar na resposta com base no local de origem do roteamento especificado na solicitação. Quando você especifica a origem do roteamento, a resposta não contém apenas uma lista de lugares que correspondem à pesquisa, mas também a duração e a distância da viagem da origem do roteamento até cada lugar.

Na imagem a seguir, os pontos A, B e C são lugares retornados na resposta da pesquisa:

Para cada lugar nos resultados, a resposta contém a duração e a distância da viagem da origem do roteamento até o lugar, se disponível.

Observação:essa é apenas uma estimativa das informações de roteamento. Para receber os detalhes reais do trajeto, incluindo instruções detalhadas, use a API Routes.

Por padrão, a duração e a distância da viagem são calculadas usando a TRAFFIC_UNAWARE opção na API Routes. Opcionalmente, você pode definir preferências de roteamento para considerar as condições de trânsito em tempo real TRAFFIC_AWARE_OPTIMALou as condições de trânsito em tempo real com latência reduzida TRAFFIC_AWAREdurante os cálculos.

Observação:TRAFFIC_AWARE e TRAFFIC_OPTIMAL só se aplicam aos modos de viagem DRIVE e TWO_WHEELER. Se qualquer preferência de roteamento for especificada com um modo de viagem não compatível, o cálculo do resumo do roteamento será padrão para usar a opção TRAFFIC_UNAWARE. Se TWO_WHEELER for especificado em uma região não compatível, a API retornará um resumo de roteamento vazio.

Quando você define a TRAFFIC_AWARE preferência de roteamento, os trajetos são calculados considerando as condições de trânsito. Como resultado, o trajeto e os detalhes do trajeto refletem com mais precisão as condições reais. Como esse aumento na qualidade de dados ocorre às custas da latência da resposta, as otimizações de desempenho são aplicadas para reduzir grande parte da latência. Quando você define a TRAFFIC_AWARE_OPTIMAL preferência de roteamento, os trajetos são calculados considerando as condições de trânsito, mas nenhuma otimização de desempenho é aplicada. Nesse modo, o servidor realiza uma pesquisa mais exaustiva da rede viária para encontrar o trajeto ideal.

Sobre trajetos, trechos e waypoints

Vários componentes compõem um trajeto, conforme calculado pela API Routes:

Um trajeto consiste nos seguintes componentes:

• Waypoint: para calcular um trajeto, especifique pelo menos os locais de origem e destino. Você define esses locais como waypoints no trajeto. Waypoints intermediários são locais entre a origem e o destino que você quer que o trajeto passe.

• Trajeto: toda a viagem do waypoint de origem, passando por waypoints intermediários, até o waypoint de destino. Um trajeto consiste em um ou mais trechos.

  Ao transmitir um trajeto para a Text Search, você transmite a polilinha codificada do trajeto conforme retornada pela API Routes. Uma polilinha codificada é uma lista codificada de pontos de latitude e longitude que permite representar a polilinha do trajeto como uma string.

• Trecho: o caminho de um waypoint em um trajeto para o próximo waypoint no trajeto. Cada trecho consiste em uma ou mais etapas discretas.

  Um trajeto contém um trecho separado para o caminho de cada waypoint para o próximo. Por exemplo, se o trajeto contiver um único waypoint de origem e um único waypoint de destino, ele conterá um único trecho.

  Para cada waypoint adicional que você adicionar ao trajeto após a origem e destino, chamado de waypoint intermediário, a API adiciona um trecho separado.

Para mais informações sobre trajetos e como calculá-los, consulte a API Routes.

Calcular o resumo do roteamento com uma pesquisa no trajeto

Você pode combinar cálculos de resumo do roteamento com pesquisa no trajeto. Nesse caso, Text Search (novo) retorna a duração da viagem e a distância para cada lugar na resposta e, em seguida, de cada lugar para o destino final do trajeto. Pense nesse cálculo como uma duração e distância de viagem se você desviar do trajeto especificado para viajar até um lugar nos resultados da pesquisa e, em seguida, continuar até o destino final.

Por exemplo, considere o trajeto a seguir da origem ao destino, conforme calculado pela API Routes. Transmita esse trajeto para a API Text Search (novo) junto com os critérios de pesquisa.

Neste exemplo, o local A é um lugar retornado nos resultados da pesquisa da Text Search (novo). Para cada lugar na resposta, a pesquisa inclui a duração e a distância necessárias para desviar até esse lugar como uma viagem de dois trechos:

• O primeiro trecho contém a duração e a distância da viagem da origem do trajeto até o lugar. Neste exemplo, da origem ao lugar A.
• O segundo trecho contém a duração e a distância da viagem do lugar até o destino do trajeto. Neste exemplo, de A ao destino.

Com as informações na resposta, você pode calcular a duração e a distância do desvio, em que:

• \(t_{OD}\) é a duração da viagem da origem ao destino, \(s_{OD}\) é a distância da viagem da origem ao destino
• \(t_{OA}\) é a duração da viagem da origem a A; \(s_{OA}\) é a distância da viagem da origem a A
• \(t_{AD}\) é a duração da viagem de A ao destino; \(s_{AD}\) é a distância da viagem de A ao destino

A duração do desvio é a diferença de duração entre a viagem original (da origem ao destino) e a nova viagem (da origem ao destino pelo A):

$$ t_{detour} = t_{OA} + t_{AD} - t_{OD} $$

A distância do desvio é a diferença de distância entre a viagem original (da origem ao destino) e a nova viagem (da origem ao destino pelo A):

$$ s_{detour} = s_{OA} + s_{AD} - s_{OD} $$