Použití geografických hranic k filtrování výsledků z rozhraní API Bingu pro místní obchodní vyhledávání
Upozornění
30. října 2020 se rozhraní API Vyhledávání Bingu přesunula ze služeb Azure AI na Vyhledávání Bingu Services. Tato dokumentace je k dispozici pouze pro referenci. Aktualizovanou dokumentaci najdete v dokumentaci k rozhraní API bingu pro vyhledávání. Pokyny k vytváření nových prostředků Azure pro vyhledávání Bingem najdete v tématu Vytvoření prostředku Vyhledávání Bingu prostřednictvím Azure Marketplace.
Rozhraní API Bingu pro místní obchodní vyhledávání umožňuje nastavit hranice pro konkrétní geografickou oblast, kterou chcete prohledávat, pomocí localCircularView parametrů dotazu nebo localMapView . Ujistěte se, že v dotazech používáte jenom jeden parametr.
Pokud hledaný termín obsahuje explicitní zeměpisné umístění, rozhraní API pro místní firmy Bingu ho automaticky použije k nastavení hranic pro výsledky hledání. Pokud je sailing in San Diegonapříklad hledaný termín , San Diego použije se jako umístění a všechna ostatní zadaná umístění v parametrech dotazu nebo uživatelských hlavičce budou ignorována.
Pokud se ve hledaném termínu nezjistí zeměpisná poloha a pomocí parametrů dotazu se žádná zeměpisná poloha nezadá, pokusí se rozhraní API Bingu pro místní obchodní vyhledávání určit umístění z hlaviček nebo X-Search-Location požadavkůX-Search-ClientIP. Pokud není zadána žádná hlavička, rozhraní API určí polohu buď z IP adresy klienta požadavku, nebo ze souřadnic GPS pro mobilní zařízení.
localCircularView
Parametr localCircularView vytvoří kruhovou geografickou oblast kolem sady souřadnic zeměpisné šířky/délky definované poloměrem. Při použití tohoto parametru budou odpovědi z rozhraní API Bingu pro místní obchodní vyhledávání zahrnovat pouze umístění v tomto kruhu, na rozdíl od parametru localMapView , který může zahrnovat umístění mírně mimo vyhledávací oblast.
Pokud chcete zadat kruhovou geografickou vyhledávací oblast, vyberte zeměpisnou šířku a délku, která bude sloužit jako střed kruhu, a poloměr v metrech. Tento parametr se pak dá připojit k řetězci dotazu, například: q=Restaurants&localCircularView=47.6421,-122.13715,5000.
Dokončit dotaz:
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
Parametr localMapView určuje obdélníkovou geografickou oblast, která se má prohledávat, a pomocí dvou sad souřadnic určí její jihovýchodní a severozápadní roh. Při použití tohoto parametru můžou odpovědi z rozhraní API Bingu pro místní obchodní vyhledávání zahrnovat umístění v zadané oblasti a přímo mimo tuto oblast, na rozdíl od parametru localCircularView , který zahrnuje pouze umístění v oblasti hledání.
Pokud chcete zadat obdélníkovou vyhledávací oblast, vyberte dvě sady souřadnic zeměpisné šířky a délky, které budou sloužit jako jihovýchodní a severozápadní roh hranice. Nezapomeňte nejprve definovat jihovýchodní souřadnice, jako v následujícím příkladu: localMapView=47.619987,-122.181671,47.6421,-122.13715.
Dokončit dotaz:
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