Utiliser les limites géographiques pour filtrer les résultats de l’API Recherche d’entreprises locales Bing

Avertissement

Le 30 octobre 2020, les API Recherche Bing sont passées de Cognitive Services à Bing Search Services. Cette documentation est fournie à des fins de référence uniquement. Pour accéder à la documentation mise à jour, consultez la documentation de l’API Recherche Bing. Pour obtenir des instructions sur la création de nouvelles ressources Azure pour Recherche Bing, consultez Créer une ressource Recherche Bing à l’aide de Place de marché Azure.

L’API Recherche d’entreprises locales Bing vous permet de définir des limites sur la zone géographique dans laquelle vous effectuez une recherche à l’aide du paramètre de requête localCircularView ou localMapView. N’utilisez qu’un seul paramètre dans vos requêtes.

Si l’un des critères de recherche contient un emplacement géographique explicite, l’API Recherche d’entreprises locales Bing l’utilise automatiquement pour définir les limites des résultats de recherche. Par exemple, si le terme recherché est sailing in San Diego, San Diego sera utilisé comme emplacement ; tous les autres emplacements spécifiés dans les paramètres de requête et les en-têtes de l’utilisateur seront ignorés.

Si aucun emplacement géographique n’est détecté dans le critère de recherche ou spécifié à l’aide des paramètres de requête, l’API Recherche d’entreprises locales Bing tente de déterminer l’emplacement à partir des en-têtes X-Search-ClientIP et X-Search-Location de la demande. Si aucun de ces en-têtes n’est spécifié, l’API déterminera l’emplacement à partir de l’IP client de la demande, ou des coordonnées GPS pour les appareils mobiles.

localCircularView

Le paramètre localCircularView crée une zone géographique circulaire autour d’un ensemble de coordonnées latitude/longitude, définie par un rayon. Lorsque ce paramètre est utilisé, les réponses de l’API Recherche d’entreprises locales Bing ne comportent que des emplacements se trouvant dans ce cercle, à la différence du paramètre localMapView qui peut inclure des lieux proches de la zone de recherche.

Pour spécifier une zone de recherche géographique circulaire, choisissez une latitude et une longitude qui représenteront le centre du cercle, ainsi qu’un rayon en mètres. Ce paramètre peut ensuite être ajouté à la chaîne de requête, par exemple : q=Restaurants&localCircularView=47.6421,-122.13715,5000.

Requête complète :

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

Le paramètre localMapView spécifie une zone de recherche géographique rectangulaire à l’aide de deux jeux de coordonnées qui représentent son coin sud-est et son coin nord-ouest. Lorsque ce paramètre est utilisé, les réponses de l’API Recherche d’entreprises locales Bing peuvent comporter des emplacements se trouvant dans la zone spécifiée et légèrement en dehors, à la différence du paramètre localCircularView qui n’inclut que des lieux situés dans la zone de recherche.

Pour spécifier une zone de recherche rectangulaire, choisissez deux jeux de coordonnées latitude/longitude qui représenteront le coin sud-est et le coin nord-ouest de la limite. Commencez par définir les coordonnées sud-est, comme dans l’exemple suivant : localMapView=47.619987,-122.181671,47.6421,-122.13715.

Requête complète :

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

Étapes suivantes