Udostępnij za pośrednictwem

Używanie granic geograficznych do filtrowania wyników z interfejsu API wyszukiwania lokalnego firmy Bing

  • Artykuł

Ostrzeżenie

30 października 2020 r. interfejsy API Wyszukiwanie Bing zostały przeniesione z usług Azure AI do usług Wyszukiwanie Bing Services. Ta dokumentacja jest dostarczana tylko do celów referencyjnych. Aby uzyskać zaktualizowaną dokumentację, zobacz dokumentację interfejsu API wyszukiwania Bing. Aby uzyskać instrukcje dotyczące tworzenia nowych zasobów platformy Azure na potrzeby wyszukiwania Bing, zobacz Tworzenie zasobu Wyszukiwanie Bing za pomocą Azure Marketplace.

Interfejs API wyszukiwania lokalnego firmy Bing umożliwia ustawianie granic w określonym obszarze geograficznym, który chcesz wyszukiwać przy użyciu localCircularView parametrów zapytania lub localMapView . Pamiętaj, aby używać tylko jednego parametru w zapytaniach.

Jeśli termin wyszukiwania zawiera jawną lokalizację geograficzną, interfejs API lokalnej firmy Bing będzie automatycznie używać go do ustawiania granic dla wyników wyszukiwania. Jeśli na przykład termin wyszukiwania to sailing in San Diego, San Diego zostanie użyty jako lokalizacja, a wszystkie inne określone lokalizacje w parametrach zapytania lub nagłówkach użytkownika zostaną zignorowane.

Jeśli lokalizacja geograficzna nie zostanie wykryta w okresie wyszukiwania, a żadna lokalizacja geograficzna nie zostanie określona przy użyciu parametrów zapytania, interfejs API wyszukiwania lokalnego firmy Bing podejmie próbę określenia lokalizacji z nagłówków lub X-Search-Location żądańX-Search-ClientIP. Jeśli żaden nagłówek nie zostanie określony, interfejs API określi lokalizację z adresu IP klienta żądania lub współrzędne GPS dla urządzeń przenośnych.

localCircularView

Parametr localCircularView tworzy okrągły obszar geograficzny wokół zestawu współrzędnych szerokości/długości geograficznej zdefiniowanych przez promień. W przypadku korzystania z tego parametru odpowiedzi z interfejsu API wyszukiwania lokalnego firmy Bing będą zawierać tylko lokalizacje w tym okręgu, w przeciwieństwie do parametru localMapView , który może zawierać lokalizacje nieco poza obszarem wyszukiwania.

Aby określić okrągły obszar wyszukiwania geograficznego, wybierz szerokość geograficzną i długość geograficzną, która będzie służyć jako środek okręgu i promień w metrach. Ten parametr można następnie dołączyć do ciągu zapytania, na przykład: q=Restaurants&localCircularView=47.6421,-122.13715,5000.

Ukończone zapytanie:

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 określa prostokątny obszar geograficzny do wyszukania, używając dwóch zestawów współrzędnych w celu określenia jego południowo-wschodnich i północno-zachodnich zakątków. W przypadku korzystania z tego parametru odpowiedzi z interfejsu API wyszukiwania lokalnego firmy Bing mogą zawierać lokalizacje w określonym obszarze i tuż poza określonym obszarem, w przeciwieństwie do parametru localCircularView , który zawiera tylko lokalizacje w obszarze wyszukiwania.

Aby określić prostokątny obszar wyszukiwania, wybierz dwa zestawy współrzędnych szerokości/długości geograficznej, które będą służyć jako południowo-wschodnie i północno-zachodnie rogi granicy. Najpierw zdefiniuj współrzędne południowo-wschodniej, jak w poniższym przykładzie: localMapView=47.619987,-122.181671,47.6421,-122.13715.

Ukończone zapytanie:

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

Następne kroki