搜尋 Bing 當地商家搜尋 API 的類別

發行項
11/01/2018

警告

從 2020 年 10 月 30 日開始，Bing 搜尋 API 已從 Azure AI 服務移至 Bing 搜尋服務。本文件僅供參考之用。如需更新的文件，請參閱 Bing 搜尋 API 文件。如需針對 Bing 搜尋建立新 Azure 資源的指示，請參閱透過 Azure Marketplace 建立 Bing 搜尋資源。

Bing 當地商家搜尋 API 可讓您搜尋各種類別的當地商家實體，且優先考慮接近使用者的位置。您可以在搜尋中包含這些搜尋，以及 localCircularView 和 localMapView 參數。

最上層類別

下列類型定義了主要的搜尋類別。可以使用指派給 localCategories 參數的逗號分隔清單指定多個類別。 

EatDrink
SeeDo
Shop
HotelsAndMotels
BanksAndCreditUnions
停車
Hospitals

子類別

子類別的傳遞方式與 localCategories 相同。子類別會是更特定的類別。它們是從屬的，如果您在相同的逗號分隔清單中指定類別 C 和該類別其中一個子類別 S，您將收到與單獨指定 C 相同的結果。

Eat Drink

啤酒廠和啤酒廠、雞尾酒廳、非洲餐廳、美國餐廳、貝果、燒烤餐廳、酒館、運動酒吧、酒吧、酒吧燒烤和酒吧、自助餐廳、比利時餐廳、英國餐廳、咖啡館、加勒比海餐廳、中餐館、咖啡和茶、熟食店、外賣服務、餐廳、折扣店、甜甜圈、快餐、法國餐廳、冷凍優格、德國餐廳、超市、希臘餐廳、雜貨店、夏威夷餐廳、匈牙利餐廳、冰淇淋和冷凍甜點、印度餐廳、意大利餐廳、日本餐廳、果汁、韓國餐廳、酒類商店、墨西哥餐廳、中東餐廳、比薩、波蘭餐廳、葡萄牙餐廳、椒鹽捲餅、餐廳、俄羅斯和烏克蘭餐廳、三明治、海鮮餐廳、西班牙餐廳、牛排餐廳、壽司餐廳、外賣、泰國餐廳、土耳其餐廳、素食和蔬食餐廳、越南餐廳

See Do

遊樂園、景點、狂歡節、賭場、地標和歷史遺址、迷你高爾夫球場、電影院、博物館、公園、觀光旅遊、旅遊訊息、動物園

Shop

古董店、書店、CD 和唱片店、兒童服裝店、雪茄和香煙店、漫畫書店、百貨商店、折扣商店、跳蚤市場和市集、家具店、家居裝飾品店、珠寶和手錶店、廚具店、酒類商店、商場和購物中心、男裝商店、音樂商店、暢貨中心、寵物商店、寵物用品商店、學校和辦公用品商店、鞋店、體育用品商店、玩具和遊戲商店、維生素和營養品商店、女裝商店

當地類別搜尋的範例

下列範例根據 localCategories 參數取得結果：

https://api.cognitive.microsoft.com/localbusinesses/v7.0/search?&q=&mkt=en-US&localcategories=HotelsAndMotels

https://api.cognitive.microsoft.com/localbusinesses/v7.0/search?&q=&mkt=en-US&localcategories=EatDrink

https://api.cognitive.microsoft.com/localbusinesses/v7.0/search?&q=&mkt=en-US&localcategories=Shop

https://api.cognitive.microsoft.com/localbusinesses/v7.0/search?&q=&mkt=en-US&localcategories=Hospitals

下列查詢會將從 Bing 當地商家搜尋 API 傳回的 'hospital' 結果數目限制為前三個：

https://api.cognitive.microsoft.com/localbusinesses/v7.0/search?&q=&mkt=en-US&localCategories=Hospitals&count=3&offset=0

下列範例 JSON 回應包括大西雅圖地區的三家醫院：

BingAPIs-TraceId: 68AFB51807C6485CAB8AAF20E232EFFF
BingAPIs-SessionId: F89E7B8539B34BF58AAF811485E83B20
X-MSEdge-ClientID: 1C44E64DBFAA6BCA1270EADDBE7D6A22
BingAPIs-Market: en-US
X-MSEdge-Ref: Ref A: 68AFB51807C6485CAB8AAF20E232EFFF Ref B: CO1EDGE0108 Ref C: 2018-10-22T18:52:28Z

{
   "_type": "SearchResponse",
   "queryContext": {
      "originalQuery": ""
   },
   "places": {
      "readLink": "https:\/\/www.bingapis.com\/api\/v7\/places\/search?q=",
      "totalEstimatedMatches": 0,
      "value": [
         {
            "_type": "LocalBusiness",
            "id": "https:\/\/www.bingapis.com\/api\/v7\/#Places.0",
            "name": "Overlake Hospital Medical Center",
            "url": "http:\/\/www.overlakehospital.org\/",
            "entityPresentationInfo": {
               "entityScenario": "ListItem",
               "entityTypeHints": [
                  "Place",
                  "LocalBusiness"
               ]
            },
            "geo": {
               "latitude": 47.6204986572266,
               "longitude": -122.185829162598
            },
            "routablePoint": {
               "latitude": 47.6204986572266,
               "longitude": -122.185668945312
            },
            "address": {
               "streetAddress": "1035 116th Ave NE",
               "addressLocality": "Bellevue",
               "addressRegion": "WA",
               "postalCode": "98004",
               "addressCountry": "US",
               "neighborhood": "",
               "text": "1035 116th Ave NE, Bellevue, WA, 98004"
            },
            "telephone": "(425) 688-5000"
         },
         {
            "_type": "LocalBusiness",
            "id": "https:\/\/www.bingapis.com\/api\/v7\/#Places.1",
            "name": "Virginia Mason University Village Medical Center",
            "url": "https:\/\/virginiamason.org\/Seattle",
            "entityPresentationInfo": {
               "entityScenario": "ListItem",
               "entityTypeHints": [
                  "Place",
                  "LocalBusiness"
               ]
            },
            "geo": {
               "latitude": 47.6095390319824,
               "longitude": -122.327941894531
            },
            "routablePoint": {
               "latitude": 47.6093978881836,
               "longitude": -122.328277587891
            },
            "address": {
               "streetAddress": "1100 9th Ave",
               "addressLocality": "Seattle",
               "addressRegion": "WA",
               "postalCode": "98101",
               "addressCountry": "US",
               "neighborhood": "University District",
               "text": "1100 9th Ave, Seattle, WA, 98101"
            },
            "telephone": "(206) 223-6600"
         },
         {
            "_type": "LocalBusiness",
            "id": "https:\/\/www.bingapis.com\/api\/v7\/#Places.2",
            "name": "Seattle Children’s Hospital",
            "url": "http:\/\/www.seattlechildrens.org\/",
            "entityPresentationInfo": {
               "entityScenario": "ListItem",
               "entityTypeHints": [
                  "Place",
                  "LocalBusiness"
               ]
            },
            "geo": {
               "latitude": 47.6625061035156,
               "longitude": -122.283760070801
            },
            "routablePoint": {
               "latitude": 47.6631507873535,
               "longitude": -122.284614562988
            },
            "address": {
               "streetAddress": "4800 Sand Point Way NE",
               "addressLocality": "Seattle",
               "addressRegion": "WA",
               "postalCode": "98105",
               "addressCountry": "US",
               "neighborhood": "Laurelhurst",
               "text": "4800 Sand Point Way NE, Seattle, WA, 98105"
            },
            "telephone": "(206) 987-2000"
         }
      ],
      "searchAction": {

      }
   }
}

共用方式為