Bing Yerel İş Arama API'sinden sonuçları filtrelemek için coğrafi sınırları kullanma
Uyarı
30 Ekim 2020'de Bing Arama API'leri Azure yapay zeka hizmetlerinden Bing Arama Hizmetlerine taşındı. Bu belgeler yalnızca başvuru için sağlanır. Güncelleştirilmiş belgeler için Bing arama API'sinin belgelerine bakın. Bing araması için yeni Azure kaynakları oluşturma yönergeleri için bkz. Azure Market aracılığıyla Bing Arama kaynağı oluşturma.
Bing Yerel İş Arama API'si, veya localMapView sorgu parametrelerini kullanarak aramak istediğiniz belirli coğrafi alanda sınırlar belirlemenizi localCircularView sağlar. Sorgularınızda yalnızca bir parametre kullandığınızdan emin olun.
Bir arama terimi açık bir coğrafi konum içeriyorsa, Bing Yerel İşletme API'si arama sonuçları için sınırlar ayarlamak için bunu otomatik olarak kullanır. Örneğin, arama terimi ise sailing in San DiegoSan Diego konum olarak kullanılır ve sorgu parametrelerinde veya kullanıcı üst bilgilerinde belirtilen diğer konumlar yoksayılır.
Arama teriminde coğrafi konum algılanmazsa ve sorgu parametreleri kullanılarak coğrafi konum belirtilmezse, Bing Yerel İş Arama API'si isteğin X-Search-ClientIP veya X-Search-Location üst bilgilerinin konumunu belirlemeye çalışır. Üst bilgi belirtilmezse API, isteğin istemci IP'sinden veya mobil cihazlar için GPS koordinatlarından konum belirler.
localCircularView
parametresi, localCircularView bir yarıçap tarafından tanımlanan enlem/boylam koordinatları kümesinin çevresinde dairesel bir coğrafi alan oluşturur. Bu parametreyi kullanırken, Bing Yerel İş Arama API'sinden gelen yanıtlar, arama alanının biraz dışındaki konumları içerebilen parametresinden localMapView farklı olarak yalnızca bu daire içindeki konumları içerir.
Dairesel bir coğrafi arama alanı belirtmek için dairenin merkezi olarak kullanılacak enlem ve boylam ve metre olarak bir yarıçap seçin. Bu parametre daha sonra bir sorgu dizesine eklenebilir, örneğin: q=Restaurants&localCircularView=47.6421,-122.13715,5000.
Sorguyu tamamlama:
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 parametresi, güneydoğu ve kuzeybatı köşelerini belirtmek için iki koordinat kümesi kullanarak aranacak dikdörtgen bir coğrafi alan belirtir. Bu parametreyi kullanırken, Bing Yerel İş Arama API'sinden gelen yanıtlar, yalnızca arama alanındaki konumları içeren parametresinden localCircularView farklı olarak belirtilen alanın içindeki ve dışındaki konumları içerebilir.
Dikdörtgen bir arama alanı belirtmek için, sınırın güneydoğu ve kuzeybatı köşeleri olarak görev yapmak üzere iki enlem/boylam koordinatı kümesi seçin. Aşağıdaki örnekte olduğu gibi önce güneydoğu koordinatlarını tanımladığınızdan emin olun: localMapView=47.619987,-122.181671,47.6421,-122.13715.
Sorguyu tamamlama:
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