Geografische grenzen gebruiken om resultaten van de Bing Local Business Search-API te filteren
Waarschuwing
Op 30 oktober 2020 zijn de Zoeken in Bing API's verplaatst van Azure AI-services naar Zoeken in Bing Services. Deze documentatie is alleen bedoeld ter referentie. Zie de bing-documentatie voor zoeken-API voor bijgewerkte documentatie. Zie Een Zoeken in Bing-resource maken via de Azure Marketplace voor instructies over het maken van nieuwe Azure-resources voor Bing Search.
Met de Bing Local Business Search-API kunt u grenzen instellen voor het specifieke geografische gebied dat u wilt doorzoeken met behulp van de localCircularView queryparameters of localMapView . Zorg ervoor dat u slechts één parameter in uw query's gebruikt.
Als een zoekterm een expliciete geografische locatie bevat, gebruikt de Bing Local Business-API deze automatisch om grenzen voor de zoekresultaten in te stellen. Als de zoekterm bijvoorbeeld is sailing in San Diego, San Diego wordt gebruikt als de locatie en worden eventuele andere opgegeven locaties in de queryparameters of gebruikersheaders genegeerd.
Als er geen geografische locatie wordt gedetecteerd in de zoekterm en er geen geografische locatie wordt opgegeven met behulp van de queryparameters, probeert de Bing Local Business Search-API de locatie te bepalen op basis van de aanvraag X-Search-ClientIP of X-Search-Location headers. Als geen van beide headers is opgegeven, bepaalt de API de locatie van het client-IP-adres van de aanvraag of GPS-coördinaten voor mobiele apparaten.
localCircularView
De localCircularView parameter maakt een cirkelvormig geografisch gebied rond een set breedtegraad-/lengtegraadcoördinaten, gedefinieerd door een straal. Wanneer u deze parameter gebruikt, bevatten antwoorden van de Bing Local Business Search-API alleen locaties binnen deze cirkel, in tegenstelling tot de localMapView parameter die mogelijk locaties buiten het zoekgebied bevat.
Als u een cirkelvormig geografisch zoekgebied wilt opgeven, kiest u een breedtegraad en lengtegraad die als het midden van de cirkel moeten fungeren en een straal in meters. Deze parameter kan vervolgens worden toegevoegd aan een querytekenreeks, bijvoorbeeld: q=Restaurants&localCircularView=47.6421,-122.13715,5000.
Query voltooien:
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
Met de localMapView parameter wordt een rechthoekig geografisch gebied opgegeven dat moet worden gezocht, waarbij twee sets coördinaten worden gebruikt om de zuidoost- en noordwesthoeken op te geven. Wanneer u deze parameter gebruikt, kunnen antwoorden van de Bing Local Business Search-API locaties binnen en net buiten het opgegeven gebied bevatten, in tegenstelling tot de localCircularView parameter, die alleen locaties binnen het zoekgebied bevat.
Als u een rechthoekig zoekgebied wilt opgeven, kiest u twee sets breedtegraad-/lengtegraadcoördinaten om te fungeren als de zuidoost- en noordwesthoek van de grens. Zorg ervoor dat u eerst de zuidoostcoördinaten definieert, zoals in het volgende voorbeeld: localMapView=47.619987,-122.181671,47.6421,-122.13715.
Query voltooien:
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