Share via


Categorias de pesquisa para a API de pesquisa de empresa local do Bing

Aviso

Em 30 de outubro de 2020, as APIs de Pesquisa do Bing foram migradas dos serviços de IA do Azure para os Serviços de Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter a documentação atualizada, consulte a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a Pesquisa do Bing, consulte Criar um recurso de Pesquisa do Bing por meio do Azure Marketplace.

A API da Pesquisa de empresa local do Bing permite que você pesquise entidades comerciais locais em várias categorias, com prioridade para que os resultados fechem a localização de um usuário. Você pode incluir essas pesquisas em pesquisas juntamente com o localCircularView e localMapViewparâmetros.

Categorias de TopLevel

Os tipos a seguir definem as principais categorias de pesquisa. Mais de uma categoria pode ser especificada usando uma lista delimitada por vírgula atribuída ao parâmetro localCategories. 

  • EatDrink
  • SeeDo
  • Shop
  • HotelsAndMotels
  • BanksAndCreditUnions
  • Estacionamento
  • Hospitais

Subcategorias

As subcategorias são passadas da mesma maneira que localCategories. Subcategorias são categorias mais específicas. Eles são subordinados no sentido de que, se você especificar uma categoria C e uma de suas subcategorias S na mesma lista delimitada por vírgulas, receberá os mesmos resultados como se tivesse especificado apenas C.

Comer bebida

CervejariasPubsCerveja, SalõesCoquetel, RestaurantesAfricanos, RestaurantesAmericanos, Bagels, Churrascarias, Tabernas, BaresEsportivos, Bares, BaresGrillsEPubs, RestaurantesBuffet| RestaurantesBelgas, RestaurantesBritânicos, Cafés, RestaurantesCaribenhos, RestaurantesChineses, CaféChá, Delicatessens, ServiçoDelivery, Lanchonetes, LojasDescontos, Roscas, FastFood, RestaurantesFranceses, FrozenYogurt, RestaurantesAlemães, Supermercados, RestaurantesGregos, Mercearias, RestaurantesHavaianos, RestaurantesHúngaros, SorvetesSobremesasGeladas, RestaurantesIndianos, RestaurantesItalianos, RestaurantesJaponeses, Sucos, RestaurantesCoreanos, LojasBebidasAlcóolicas, RestaurantesMexicanos, RestaurantesOrinteMédio, Pizza, RestaurantesPoloneses,RestaurantesPortugueses, Pretzels, Restaurantes, RestaurantesRussosUcranianos, Sanduíches, RestaurantesFrutosDoMar, RestaurantesEspanhóis, Restaurantes, RestaurantesSushi, Delivery, RestaurantesTailandeses, RestaurantesTurcos, RestaurantesVegetarianosVeganos, RestaurantesVietnamitas

Consulte fazer

ParqueDeDiversão, Atrações, Carnavais, Cassinos, LocaisHistóricos, CursosMiniGolfe, Cinemas, Museus, Parques, CityTours, InformaçãoTurística, Zoológicos

Shop

Antiquários, Livrarias, LojasCDsMúsicas, LojasInfantis, Tabacarias, LojasQuadrinhos, LojasDepartamento, LojasDesconto, BazaresMercadoDePulgas, LojasMóveis, LojasArtigosDeDecoração, LojasJoiasRelógios, LojasUtensíliosDeCozinha, LojasBebidasAlcóolicas, ShoppingCenters, LojasArtigosMasculinos, LojasMúsicas, Outlets, PetShops, LojasSuprimentosParaPets, LojasMateriaisEscolaresEDeEscritório, LojasCalçados, LojasArtigosEsportivos, LojasBrinquedosJogos, LojasVitaminasSuplementos, LojasArtigosFemininos

Os exemplos a seguir obtêm resultados de acordo com o parâmetro 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

A consulta a seguir limita o número de resultados "hospitalares" aos três primeiros retornados da API da Pesquisa de empresa local do Bing:

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

A seguinte resposta JSON de exemplo inclui três hospitais na área metropolitana de Seattle:

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": {

      }
   }
}

Próximas etapas