Visão geral da pesquisa no trajeto

Os recursos de pesquisa ao longo da rota estão disponíveis nas seguintes APIs Places (New):

• Somente na Pesquisa por texto (novo):pesquise lugares ao longo de um trajeto de viagem predefinido.
• Pesquisa por texto (novo) e pesquisa nas proximidades (novo): calculam o resumo do trajeto de um local de origem especificado para cada lugar nos resultados da pesquisa.
• Pesquisa de texto (nova) apenas:calcule o resumo do trajeto para cada lugar ao longo de um trajeto de viagem predefinido.

Pesquisar no trajeto

Você usa a API Routes para calcular o trajeto da viagem entre dois locais. A API Routes pode calcular um trajeto para um carro, uma bicicleta, um veículo de duas rodas, um sistema de transporte público ou a pé.

Observação:as rotas do sistema de transporte público não são compatíveis com a API Places.

Com a Pesquisa de texto (nova), é possível usar essa rota calculada para fazer uma pesquisa ao longo de um trajeto. Com essa opção, você transmite a rota pré-calculada da API Routes para a solicitação de pesquisa de texto (nova). A resposta contém lugares que correspondem aos critérios de pesquisa e também estão localizados perto da rota especificada.

Pesquisar ao longo de um trajeto é semelhante a usar as opções de solicitação locationRestriction ou locationBias para influenciar os resultados da pesquisa. locationRestriction retorna resultados da pesquisa que estão dentro dos limites da janela de visualização, enquanto locationBias pode retornar resultados da 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 Pesquisa de texto também permite influenciar os resultados da pesquisa para incluir aqueles com tempos de desvio mínimos da origem ao destino do trajeto. É possível influenciar os resultados da pesquisa usando locationBias ou locationRestriction em combinação com a polilinha.

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

Quando você pesquisa ao longo do trajeto, a pesquisa é tendenciosa 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 trajeto

A Pesquisa de texto (novo) e a Pesquisa nas proximidades (novo) podem calcular o resumo do trajeto, ou seja, a duração e a distância, até cada lugar na resposta com base no local de origem do trajeto especificado na solicitação. Quando você especifica a origem do trajeto, 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 trajeto 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 da viagem e a distância da origem do trajeto até o lugar, se disponível.

Observação:esta é apenas uma estimativa das informações de roteamento. Para receber os detalhes reais da rota, incluindo instruções passo a passo, use a API Routes.

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

Observação:TRAFFIC_AWARE e TRAFFIC_OPTIMAL se aplicam apenas aos modos de viagem DRIVE e TWO_WHEELER. Se uma das preferências de trajeto for especificada com um modo de viagem não compatível, o cálculo do resumo do trajeto vai usar a opção TRAFFIC_UNAWARE por padrão. Se TWO_WHEELER for especificado em uma região sem suporte, a API vai retornar um resumo de rotas vazio.

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

Sobre rotas, trechos e waypoints

Vários componentes formam um trajeto, conforme calculado pela API Routes:

Uma rota consiste nos seguintes componentes:

• Ponto de parada: para calcular um trajeto, especifique pelo menos os locais de origem e destino. Você define esses locais como pontos de referência na rota. 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 todos os waypoints intermediários, até o waypoint de destino. Um trajeto consiste em um ou mais trechos.

  Ao transmitir uma rota para a Pesquisa de texto, você transmite a polilinha codificada da rota, conforme retornado 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 ponto de referência em um trajeto para o próximo ponto de referência no trajeto. Cada trecho consiste em uma ou mais etapas discretas.

  Uma rota contém um trecho separado para o caminho de cada waypoint até o próximo. Por exemplo, se a rota tiver um único ponto de parada de origem e um único ponto de parada de destino, ela terá um único trecho.

  Para cada ponto de referência adicional que você adiciona à rota após a origem e o destino, chamado de ponto de referência intermediário, a API adiciona um trecho separado.

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

Calcular o resumo do roteamento com uma pesquisa no trajeto

É possível combinar cálculos de resumo do trajeto com pesquisa ao longo de um trajeto. Nesse caso, a Pesquisa de texto (novo) retorna a duração e a distância da viagem até cada lugar na resposta e, em seguida, de cada lugar até o destino final da rota. Essa conta fornece uma duração e uma distância de viagem se você desviar da rota especificada para viajar até um lugar nos resultados da pesquisa e depois continuar até o destino final.

Por exemplo, considere a seguinte rota da origem ao destino, calculada pela API Routes. Transmita essa rota para a API Text Search (New) junto com seus critérios de pesquisa.

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

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

Com base nas informações da resposta, é possível calcular a duração e a distância do desvio, em que:

• \(t_{OD}\) é a duração da viagem da origem ao destino e \(s_{OD}\) é a distância da viagem da origem ao destino.
• \(t_{OA}\) é a duração da viagem da origem até A; \(s_{OA}\) é a distância da viagem da origem até A
• \(t_{AD}\) é a duração da viagem de A até o destino; \(s_{AD}\) é a distância da viagem de A até o 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 ponto A):

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