使用地理界限來篩選 Bing 當地商家搜尋 API 的結果
警告
2020 年 10 月 30 日，Bing 搜尋 API 已從 Azure AI 服務移至Bing 搜尋服務。 本文件僅供參考之用。 如需更新的文件，請參閱 Bing 搜尋 API 文件。 如需針對 Bing 搜尋建立新 Azure 資源的指示，請參閱透過 Azure Marketplace 建立 Bing 搜尋資源。
Bing 當地商家搜尋 API 可讓您透過使用 localCircularView 或 localMapView 查詢參數，在要搜尋的特定地理區域上設定界限。 請務必僅在查詢中使用一個參數。
如果搜尋字詞包含明確的地理位置，Bing 當地商家搜尋 API 將自動使用它來設定搜尋結果的界限。 例如，如果搜尋字詞為 sailing in San Diego，則 San Diego 將作為位置使用，並且將忽略查詢參數或使用者標頭中的任何其他指定位置。
如果未在搜尋詞彙中偵測到地理位置，並且未使用查詢參數指定地理位置，則 Bing 當地商家搜尋 API 將嘗試從要求的 X-Search-ClientIP 或 X-Search-Location 標頭中判斷位置。 如果未指定標頭，則 API 將根據要求的用戶端 IP 或行動裝置的 GPS 座標判斷位置。
localCircularView
localCircularView 參數會圍繞由半徑定義的一組緯度/經度座標建立圓形地理區域。 使用此參數時，Bing 當地商家搜尋 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 參數指定要搜尋的矩形地理區域，使用兩組座標指定其東南部及西北部的邊角。 使用此參數時，Bing 當地商家搜尋 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