Поделиться через

Фильтрация результатов из API Bing Local Business Search с помощью географических границ

  • Статья

Предупреждение

30 октября 2020 г. API-интерфейсы Поиск Bing перемещены из служб ИИ Azure в службы Поиск Bing. Эта документация приводится только для справки. Обновленную информацию см. в документации по API Поиска Bing. Инструкции по созданию ресурсов Azure для Поиска Bing приведены в статье Создание ресурса для Поиска Bing с помощью Azure Marketplace.

API Bing Local Business Search позволяет задать границы в определенной географической области, в которой вам нужно выполнить поиск с помощью параметров запроса localCircularView или localMapView. Укажите только один параметр в запросах.

Если условие поиска содержит прямое географическое местоположение, API Bing Local Business Search будет автоматически использовать его для задания границ для представления результатов поиска. Например, если условие поиска — sailing in San Diego, то San Diego будет использоваться как расположение, а другие определенные расположения в параметрах запроса или пользовательских заголовках будут игнорироваться.

Если географическое расположение не обнаружено в условии поиска и не указано с помощью параметров запроса, API Bing Local Business Search попытается определить расположение в заголовках X-Search-ClientIP или X-Search-Location запроса. Если заголовок не указан, API определит расположение по IP-адресу клиента запроса или координатам GPS для мобильных устройств.

localCircularView

Параметр localCircularView создает круглую географическую область вокруг набора координат широты и долготы, определяемых радиусом. При использовании этого параметра ответы от API Bing Local Business Search будут включать только расположения в пределах этого круга, в отличие от параметра localMapView, который может содержать расположения, немного выходящие за пределы области поиска.

Чтобы задать круглую географическую область поиска, выберите широту и долготу в качестве центра круга и радиус в метрах. Этот параметр можно затем добавить в строку запроса, например: q=Restaurants&localCircularView=47.6421,-122.13715,5000.

Завершение запроса:

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

Параметр localMapView указывает прямоугольную географическую область поиска с помощью двух наборов координат для указания его юго-восточного и северо-западного углов. При использовании этого параметра ответы от API Bing Local Business Search могут включать расположения в пределах указанной области и возле нее, в отличие от параметра localCircularView, который может содержать только расположения в пределах области поиска.

Чтобы задать прямоугольную область поиска, выберите два набора координат широты и долготы в качестве юго-восточного и северо-западного углов границы. Сначала определите юго-восточные координаты, как показано в следующем примере: localMapView=47.619987,-122.181671,47.6421,-122.13715.

Завершение запроса:

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

Дальнейшие действия