Obter imagens da Web com a API de Pesquisa de Imagens do Bing

  • Artigo

Aviso

A 30 de outubro de 2020, as APIs de Pesquisa do Bing passaram dos serviços de IA do Azure para os Serviços Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, veja 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, veja Criar um recurso de Pesquisa do Bing através do Azure Marketplace.

Quando utiliza a API REST de Pesquisa de Imagens do Bing, pode obter imagens da Web relacionadas com o termo de pesquisa ao enviar o seguinte pedido GET:

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com

Utilize o parâmetro de consulta q para o termo de pesquisa codificado por URL. Por exemplo, se introduzir dinghies à vela, defina q como sailing+dinghies ou sailing%20dinghies.

Importante

  • Todos os pedidos têm de ser feitos a partir de um servidor e não de um cliente.
  • Se for a primeira vez que chama uma das APIs de pesquisa do Bing, não inclua o cabeçalho do ID de cliente. Inclua apenas o ID de cliente se tiver chamado anteriormente uma API do Bing que devolveu um ID de cliente para a combinação de utilizador e dispositivo.

Obter imagens de um domínio Web específico

Para obter imagens de um domínio específico, utilize o operador de consulta site:.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us HTTP/1.1

Nota

As respostas às consultas que utilizam o site: operador podem incluir conteúdo para adultos, independentemente da definição safeSearch . site: Utilize apenas se tiver conhecimento do conteúdo no domínio.

Filtrar imagens

Por predefinição, a API de Pesquisa de Imagens devolve todas as imagens relevantes para a consulta. Se quiser filtrar as imagens devolvidas pelo Bing (por exemplo, para devolver apenas imagens com um fundo transparente ou um tamanho específico), utilize os seguintes parâmetros de consulta:

  • aspect — Filtre imagens por proporção (por exemplo, imagens de ecrã padrão ou largas).
  • color — Filtre imagens por cor dominante ou a preto e branco.
  • freshness — filtre imagens por idade (por exemplo, imagens descobertas pelo Bing na semana passada).
  • altura, largura — filtrar imagens por largura e altura.
  • imageContent — filtrar imagens por conteúdo (por exemplo, imagens que mostram apenas o rosto de uma pessoa).
  • imageType — filtre imagens por tipo (por exemplo, ClipArt, GIFs animados ou fundos transparentes).
  • license — filtre imagens pelo tipo de licença associada ao site.
  • size — filtre imagens por tamanho, como imagens pequenas até 200x200 píxeis.

Para obter imagens de um domínio específico, utilize o operador de consulta site:.

O exemplo seguinte mostra como obter pequenas imagens de ContosoSailing.com que o Bing descobriu na semana passada.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&size=small&freshness=week&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
X-MSEdge-ClientIP: 999.999.999.999  
X-Search-Location: lat:47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com

Formato de resposta da Pesquisa de Imagens do Bing

A mensagem de resposta do Bing contém uma resposta Imagens que contém uma lista de imagens que os serviços de IA do Azure determinaram serem relevantes para a consulta. Cada objeto Imagem na lista inclui as seguintes informações sobre a imagem: o URL, o tamanho, as dimensões, o formato de codificação, um URL para uma miniatura da imagem e as dimensões da miniatura.

Nota

  • As imagens têm de ser apresentadas pela ordem indicada na resposta.
  • Uma vez que os parâmetros e os formatos de URL estão sujeitos a alterações sem aviso prévio, utilize todos os URLs tal como estão. Não deve assumir dependências no formato ou parâmetros do URL, exceto quando indicado.
{
    "name": "Rich Passage Sailing Dinghy",
    "webSearchUrl": "https:\/\/www.bing.com\/cr?IG=73118C8B4E3...",
    "thumbnailUrl": "https:\/\/tse1.mm.bing.net\/th?id=OIP.GNarK7m...",
    "datePublished": "2011-10-29T11:26:00",
    "contentUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3...",
    "hostPageUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3687...",
    "contentSize": "79239 B",
    "encodingFormat": "jpeg",
    "hostPageDisplayUrl": "en.contoso.org\/wiki\/File:Rich_Passage...",
    "width": 526,
    "height": 688,
    "thumbnail": {
        "width": 229,
        "height": 300
    },
    "imageInsightsToken": "ccid_GNarK7ma*mid_CCF85447ADA6...",
    "insightsSourcesSummary": {
        "shoppingSourcesCount": 0,
        "recipeSourcesCount": 0
    },
    "imageId": "CCF85447ADA6FFF9E96E7DF0B796F7A86E34593",
    "accentColor": "376094"
},

Quando chamar a API de Pesquisa de Imagens do Bing, o Bing devolve uma lista de resultados. A lista é um subconjunto do número total de resultados que são relevantes para a consulta. O campo totalEstimatedMatches da resposta contém uma estimativa do número de imagens que estão disponíveis para visualização. Para obter detalhes sobre como analisar as restantes imagens, consulte Paginar Imagens.

Passos seguintes

Se ainda não experimentou a API de Pesquisa de Imagens do Bing, experimente um início rápido. Se estiver à procura de algo mais complexo, experimente o tutorial para criar uma aplicação Web de página única.