使用地理边界筛选必应本地业务搜索 API 的结果
警告
2020 年 10 月 30 日,必应搜索 API 从 Azure AI 服务迁移到必应搜索服务。 本文档仅供参考。 有关更新的文档,请参阅必应搜索 API 文档。 关于为必应搜索创建新的 Azure 资源的说明,请参阅通过 Azure 市场创建必应搜索资源。
借助必应当地企业搜索 API,可以使用 localCircularView
或 localMapView
查询参数针对要搜索的特定地理区域设置边界。 请确保只在查询中使用一个参数。
如果搜索词包含显式的地理位置,则必应当地企业 API 将自动使用它来设置搜索结果的边界。 例如,如果搜索词为 sailing in San Diego
,则 San Diego
将用作位置,并忽略查询参数或用户标头中指定的其他任何位置。
如果在搜索词中未检测到地理位置,并且未使用查询参数指定任何地理位置,则必应当地企业搜索 API 将尝试从请求的 X-Search-ClientIP
或 X-Search-Location
标头确定位置。 如果未指定上述任一标头,该 API 将从请求的客户端 IP 或移动设备的 GPS 坐标来确定位置。
localCircularView
localCircularView
参数围绕一组纬度/经度坐标创建一个圆形地理区域,该区域按半径定义。 使用此参数时,必应当地企业搜索 API 的响应仅包含此圆内的位置;而 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 的响应可以包含指定区域内部以及靠近边界处的位置;而 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