Visão geral da pesquisa no trajeto

Os recursos de pesquisa ao longo do trajeto estão disponíveis nas seguintes APIs Places (novas):

• Somente Text Search (novo):pesquise lugares ao longo de um trajeto de viagem predefinido.
• Text Search (novo) e Nearby Search (novo): calcule o resumo do trajeto de um local de origem especificado para cada lugar nos resultados da pesquisa.
• Somente pesquisa de texto (nova):calcule o resumo do trajeto para cada lugar em um trajeto de viagem predefinido.

Pesquisar no trajeto

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

Observação:a API Places não oferece suporte a rotas de sistema de transporte público.

O Text Search (novo) permite usar essa rota calculada para realizar uma pesquisa ao longo de uma rota. Com essa opção, você transmite a rota pré-calculada da API Routes para a solicitação Text Search (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 uma rota é semelhante a usar as opções de solicitação locationRestriction ou locationBias para enviesar 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, enquanto as opções locationBias e locationRestriction permitem especificar uma região para influenciar os resultados da pesquisa, o recurso de pesquisa no trajeto na Pesquisa por texto também permite influenciar os resultados da pesquisa para incluir aqueles com tempos mínimos de desvio da origem do trajeto até o destino. É possível enviesar os resultados da pesquisa usando locationBias ou locationRestriction em combinação com a poligonal.

Por exemplo, considere a rota da origem, chamada de ponto de passagem na API Routes, até o destino, conforme calculado pela API Routes:

Quando você pesquisa ao longo do trajeto, a pesquisa é tendenciosa para retornar lugares próximos ao trajeto com o menor tempo de desvio da origem ao destino. Neste exemplo, os pontos A, B e C são lugares retornados pela pesquisa.

Calcular o resumo do roteamento

O Text Search (novo) e o Nearby Search (novo) podem calcular o resumo do trajeto, ou seja, a duração e a distância, para 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 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:essa é apenas uma estimativa das informações de roteamento. Para conferir os detalhes da rota, incluindo as instruções detalhadas, 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 as preferências de roteamento para considerar as condições de trânsito em tempo real TRAFFIC_AWARE_OPTIMAL ou as condições de trânsito em tempo real com latência reduzida TRAFFIC_AWARE durante os cálculos.

Observação:TRAFFIC_AWARE e TRAFFIC_OPTIMAL se aplicam apenas aos modos de deslocamento DRIVE e TWO_WHEELER. Se uma das preferências de roteamento for especificada com um modo de deslocamento não compatível, o cálculo do resumo do roteamento 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 roteamento 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 do mundo real. Como esse aumento na qualidade dos dados é feito à custa da latência de resposta, as 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 levando em conta as condições de trânsito, mas nenhuma otimização de desempenho é aplicada. Nesse modo, o servidor realiza uma pesquisa mais completa da rede de vias para encontrar a rota ideal.

Sobre rotas, trechos e waypoints

Vários componentes compõem uma rota, conforme calculado pela API Routes:

Uma rota consiste nos seguintes componentes:

• Waypoint: para calcular uma rota, especifique pelo menos os locais da origem e do destino. Você define esses locais como pontos de passagem na rota. Os waypoints intermediários são locais entre a origem e o destino que você quer que a rota passe.

• Trajeto: toda a viagem do waypoint de origem, passando por todos os waypoints intermediários, até o waypoint de destino. Uma rota 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 da rota como uma string.

• Trajeto: o caminho de um ponto de passagem em um trajeto até o próximo ponto de passagem no mesmo trajeto. Cada trecho consiste em um ou mais passos distintos.

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

  Para cada ponto de passagem adicional que você adicionar à rota depois da origem e do destino, chamado de ponto de passagem intermediário, a API vai adicionar uma etapa separada.

Para mais informações sobre rotas e cálculo de rotas, consulte a API Routes.

Calcular o resumo do trajeto com uma pesquisa no trajeto

É possível combinar os cálculos do resumo de roteamento com a pesquisa ao longo de um trajeto. Nesse caso, a Pesquisa de texto (nova) 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. Esse cálculo fornece a duração e a distância da viagem se você desviar da rota especificada para chegar a um lugar nos resultados da pesquisa e depois continuar até o destino final.

Por exemplo, considere a rota a seguir da origem para o destino, conforme calculado pela API Routes. Transmita essa rota para a API Text Search (New) com seus critérios de pesquisa.

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

• O primeiro trecho contém a duração e a distância da origem da rota até o lugar. Neste exemplo, da origem para o lugar A.
• A segunda etapa contém a duração e a distância da viagem do lugar até o destino da rota. Neste exemplo, de A ao 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, \(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 através de A):

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

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

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