必应当地企业搜索 API 的搜索类别
警告
2020 年 10 月 30 日，必应搜索 API 从 Azure AI 服务迁移到必应搜索服务。 本文档仅供参考。 有关更新的文档，请参阅必应搜索 API 文档。 关于为必应搜索创建新的 Azure 资源的说明，请参阅通过 Azure 市场创建必应搜索资源。
使用必应当地企业搜索 API，可以在各种类别中搜索本地业务实体，并优先得到靠近用户位置的结果。 可以在搜索中包括这些搜索以及 localCircularView 和 localMapView参数。
顶级类别
以下类型定义了主要搜索类别。 可以使用分配给 localCategories 参数的逗号分隔列表指定多个类别。
- EatDrink
- SeeDo
- 商店
- HotelsAndMotels
- BanksAndCreditUnions
- Parking
- Hospitals
子类别
子类别的传递方式与 localCategories 相同。 子类别是更具体的类别。 从以下角度来说，它们是从属的：如果在以逗号分隔的同一列表中指定了类别 C 及其子类别之一 S，则会像单独指定了 C 一样收到相同的结果。
Eat Drink
BreweriesAndBrewPubs, CocktailLounges, AfricanRestaurants, AmericanRestaurants, Bagels, BarbecueRestaurants, Taverns, SportsBars, Bars, BarsGrillsAndPubs, BuffetRestaurants| BelgianRestaurants, BritishRestaurants, CafeRestaurants, CaribbeanRestaurants, ChineseRestaurants, CoffeeAndTea, Delicatessens, DeliveryService, Diners, DiscountStores, Donuts, FastFood, FrenchRestaurants, FrozenYogurt, GermanRestaurants, Supermarkets, GreekRestaurants, Grocers, HawaiianRestaurants, HungarianRestaurants, IceCreamAndFrozenDesserts, IndianRestaurants, ItalianRestaurants, JapaneseRestaurants, Juices, KoreanRestaurants, LiquorStores, MexicanRestaurants, MiddleEasternRestaurants, Pizza, PolishRestaurants, PortugueseRestaurants, Pretzels, Restaurants, RussianAndUkrainianRestaurants, Sandwiches, SeafoodRestaurants, SpanishRestaurants, SteakHouseRestaurants, SushiRestaurants, TakeAway, ThaiRestaurants, TurkishRestaurants, VegetarianAndVeganRestaurants, VietnameseRestaurants
See Do
AmusementParks, Attractions, Carnivals, Casinos, LandmarksAndHistoricalSites, MiniatureGolfCourses, MovieTheaters, Museums, Parks, SightseeingTours, TouristInformation, Zoos
商店
AntiqueStores, Bookstores, CDAndRecordStores, ChildrensClothingStores, CigarAndTobaccoShops, ComicBookStores, DepartmentStores, DiscountStores, FleaMarketsAndBazaars, FurnitureStores, HomeImprovementStores, JewelryAndWatchesStores, KitchenwareStores, LiquorStores, MallsAndShoppingCenters, MensClothingStores, MusicStores, OutletStores, PetShops, PetSupplyStores, SchoolAndOfficeSupplyStores, ShoeStores, SportingGoodsStores, ToyAndGameStores, VitaminAndSupplementStores, WomensClothingStores
Examples of Local Categories search
下面的示例根据 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
以下查询将“医院”结果的数量限制为从必应当地企业搜索 API 返回的前三个结果：
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": {
}
}
}