Utilizar limites geográficos para filtrar os resultados da API de Pesquisa de Empresas Locais do Bing
Aviso
A 30 de outubro de 2020, as APIs de Pesquisa do Bing passaram dos serviços de IA do Azure para os Serviços Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, veja 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, veja Criar um recurso de Pesquisa do Bing através do Azure Marketplace.
A API de Pesquisa de Empresas Locais do Bing permite-lhe definir limites na área geográfica específica que pretende procurar com os localCircularView parâmetros ou localMapView consulta. Certifique-se de que utiliza apenas um parâmetro nas suas consultas.
Se um termo de pesquisa contiver uma localização geográfica explícita, a API de Negócios Locais do Bing irá utilizá-la automaticamente para definir limites para os resultados da pesquisa. Por exemplo, se o termo de pesquisa for sailing in San Diego, San Diego será utilizado como a localização e quaisquer outras localizações especificadas nos parâmetros de consulta ou cabeçalhos de utilizador serão ignoradas.
Se não for detetada uma localização geográfica no termo de pesquisa e não for especificada nenhuma localização geográfica através dos parâmetros de consulta, a API de Pesquisa empresarial local do Bing tentará determinar a localização a partir dos cabeçalhos ou X-Search-Location do X-Search-ClientIP pedido. Se nenhum dos cabeçalhos for especificado, a API determinará a localização do IP do cliente do pedido ou as coordenadas gps para dispositivos móveis.
localCircularView
O localCircularView parâmetro cria uma área geográfica circular em torno de um conjunto de coordenadas de latitude/longitude, definidas por um raio. Ao utilizar este parâmetro, as respostas da API de Pesquisa de Empresas Locais do Bing incluirão apenas localizações neste círculo, ao contrário do localMapView parâmetro que pode incluir localizações 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. Em seguida, este parâmetro pode ser anexado a uma cadeia de consulta, por exemplo: q=Restaurants&localCircularView=47.6421,-122.13715,5000.
Consulta completa:
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 localMapView parâmetro especifica uma área geográfica retangular a procurar, utilizando dois conjuntos de coordenadas para especificar os respetivos cantos sudeste e noroeste. Ao utilizar este parâmetro, as respostas da API de Pesquisa de Empresas Locais do Bing podem incluir localizações dentro e fora da área especificada, ao contrário do localCircularView parâmetro, que inclui apenas localizações 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 que define primeiro as coordenadas sudeste, como no exemplo seguinte: localMapView=47.619987,-122.181671,47.6421,-122.13715.
Consulta completa:
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