Use limites geográficos para filtrar resultados da API de pesquisa do Bing Local Business
Aviso
Em 30 de outubro de 2020, as APIs de Pesquisa do Bing foram migradas dos serviços de IA do Azure para os Serviços de Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter a documentação atualizada, consulte a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a Pesquisa do Bing, consulte Criar um recurso de Pesquisa do Bing por meio do Azure Marketplace.
A API da Pesquisa de empresa local do Bing permite que você defina limites na área geográfica específica que deseja pesquisar usando os parâmetros de consulta localCircularView ou localMapView. Certifique-se de usar apenas um parâmetro em suas consultas.
Se um termo de pesquisa contiver um local geográfico explícito, a API do Bing Local Business o usará automaticamente para definir limites para os resultados da pesquisa. Por exemplo, se o termo de pesquisa for sailing in San Diego, San Diego será usado como o local e todos os outros locais especificados nos parâmetros de consulta ou cabeçalhos de usuários serão ignorados.
Se uma localização geográfica não for detectada no termo de pesquisa e nenhuma localização geográfica for especificada usando os parâmetros de consulta, a API da Pesquisa de empresa local do Bing tentará determinar o local dos cabeçalhos X-Search-ClientIP ou X-Search-Location da solicitação. Se nenhum cabeçalho for especificado, a API determinará a localização do IP do cliente da solicitação ou das coordenadas de GPS para dispositivos móveis.
localCircularView
O parâmetro localCircularView cria uma área geográfica circular em torno de um conjunto de coordenadas de latitude / longitude, definidas por um raio. Ao usar esse parâmetro, as respostas da API da Pesquisa de empresa local do Bing incluirão apenas locais dentro desse círculo, ao contrário do parâmetro localMapView, que pode incluir locais ligeiramente fora da área de pesquisa.
Para especificar uma área de pesquisa geográfica circular, escolha uma latitude e longitude para servir como o centro do círculo e um raio em metros. Este parâmetro pode então ser anexado a uma cadeia de caracteres de consulta, por exemplo: q=Restaurants&localCircularView=47.6421,-122.13715,5000.
Consulta concluída:
https://api.cognitive.microsoft.com/bing/v7.0/localbusinesses/search?q=restaurant&localCircularView=47.6421,-122.13715,5000&appid=0123456789ABCDEF&mkt=en-us&form=monitr
localMapView
O parâmetro localMapView especifica uma área geográfica retangular para pesquisa, usando dois conjuntos de coordenadas para especificar seus cantos sudeste e noroeste. Ao usar esse parâmetro, as respostas da API da Pesquisa de empresa local do Bing podem incluir locais dentro e fora da área especificada, ao contrário do parâmetro localCircularView, que inclui apenas locais na área de pesquisa.
Para especificar uma área de pesquisa retangular, escolha dois conjuntos de coordenadas de latitude / longitude para servir como os cantos sudeste e noroeste do limite. Certifique-se de definir as coordenadas Sudeste em primeiro lugar, como no exemplo a seguir: localMapView=47.619987,-122.181671,47.6421,-122.13715.
Consulta concluída:
https://api.cognitive.microsoft.com/bing/v7.0/localbusinesses/search?q=restaurant&localMapView=47.619987,-122.181671,47.6421,-122.13715&appid=0123456789ABCDEF&mkt=en-us&form=monitr