Obtenha imagens da web com a API de Pesquisa de Imagem BingGet images from the web with the Bing Image Search API

Quando utilizar a API de Pesquisa de Imagem Bing, pode obter imagens da web que estejam relacionadas com o seu termo de pesquisa enviando o seguinte pedido GET:When you use the Bing Image Search REST API, you can get images from the web that are related to your search term by sending the following GET request:

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 seu termo de pesquisa codificado por url.Use the q query parameter for your url-encoded search term. Por exemplo, se entrar em botes de vela, definido q para sailing+dinghies ou sailing%20dinghies.For example, if you enter sailing dinghies, set q to sailing+dinghies or sailing%20dinghies.

Importante

  • Todos os pedidos devem ser feitos a partir de um servidor, e não de um cliente.All requests must be made from a server, and not from a client.
  • Se é a primeira vez que liga para qualquer uma das APIs de pesquisa do Bing, não inclua o cabeçalho de identificação do cliente.If it's your first time calling any of the Bing search APIs, don't include the client ID header. Apenas inclua o ID do cliente se já ligou para um Bing API que devolveu um ID do cliente para a combinação de utilizador e dispositivo.Only include the client ID if you've previously called a Bing API that returned a client ID for the user and device combination.

Obtenha imagens de um domínio web específicoGet images from a specific web domain

Para obter imagens de um domínio específico, utilize o operador de consulta site:.To get images from a specific domain, use the site: query operator.

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 site: consultas que utilizam o operador podem incluir conteúdo adulto, independentemente da definição de segurançaSearch.Responses to queries using the site: operator might include adult content regardless of the safeSearch setting. site: utilize se tiver conhecimento do conteúdo no domínio.Only use site: if you're aware of the content on the domain.

Filtrar imagensFilter images

Por padrão, a Image Search API devolve todas as imagens relevantes para a consulta.By default, the Image Search API returns all images that are relevant to the query. Se pretender filtrar as imagens que bing retorna (por exemplo, para devolver apenas imagens com um fundo transparente ou tamanho específico), utilize os seguintes parâmetros de consulta:If you want to filter the images that Bing returns (for example, to return only images with a transparent background or specific size), use the following query parameters:

  • aspeto— Filtrar imagens por relação de aspeto (por exemplo, imagens de ecrã padrão ou de ecrã largo).aspect—Filter images by aspect ratio (for example, standard or wide screen images).
  • cor— Filtrar imagens por cor dominante ou preto e branco.color—Filter images by dominant color or black and white.
  • frescura— Filtrar imagens por idade (por exemplo, imagens descobertas por Bing na semana passada).freshness—Filter images by age (for example, images discovered by Bing in the past week).
  • altura, largura— Filtrar imagens por largura e altura.height, width—Filter images by width and height.
  • imagemConteúdo— Filtrar imagens por conteúdo (por exemplo, imagens que mostram apenas o rosto de uma pessoa).imageContent—Filter images by content (for example, images that show only a person's face).
  • imagemTipo— Filtrar imagens por tipo (por exemplo, clip art, GIFs animados ou fundos transparentes).imageType—Filter images by type (for example, clip art, animated GIFs, or transparent backgrounds).
  • licença— Filtrar imagens pelo tipo de licença associada ao site.license—Filter images by the type of license associated with the site.
  • tamanho— Filtrar imagens por tamanho, como pequenas imagens até 200x200 pixels.size—Filter images by size, such as small images up to 200x200 pixels.

Para obter imagens de um domínio específico, utilize o operador de consulta site:.To get images from a specific domain, use the site: query operator.

O exemplo que se segue mostra como obter pequenas imagens de ContosoSailing.com que Bing descobriu na semana passada.The following example shows how to get small images from ContosoSailing.com that Bing discovered in the past week.

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 de pesquisa de imagem bingBing Image Search response format

A mensagem de resposta de Bing contém uma resposta imagens que contém uma lista de imagens que os Serviços Cognitivos determinaram ser relevantes para a consulta.The response message from Bing contains an Images answer that contains a list of images that Cognitive Services determined to be relevant to the query. Cada objeto de imagem na lista inclui as seguintes informações sobre a imagem: o URL, o seu tamanho, as suas dimensões, o seu formato de codificação, um URL para uma miniatura da imagem e as dimensões da miniatura.Each Image object in the list includes the following information about the image: the URL, its size, its dimensions, its encoding format, a URL to a thumbnail of the image, and the thumbnail's dimensions.

Nota

  • As imagens devem ser apresentadas na ordem fornecida na resposta.Images must be displayed in the order provided in the response.
  • Como os formatos e parâmetros de URL estão sujeitos a alterações sem aviso prévio, utilize todos os URLs como está.Because URL formats and parameters are subject to change without notice, use all URLs as-is. Não deve assumir dependências do formato url ou dos parâmetros, exceto quando se nota.You should not take dependencies on the URL format or parameters except where noted.
{
    "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.When you call the Bing Image Search API, Bing returns a list of results. A lista é um subconjunto do número total de resultados que são relevantes para a consulta.The list is a subset of the total number of results that are relevant to the query. O campo totalEstimatedMatches da resposta contém uma estimativa do número de imagens que estão disponíveis para visualização.The response's totalEstimatedMatches field contains an estimate of the number of images that are available to view. Para mais detalhes sobre como página rindo através do resto das imagens, consulte Imagens Paging.For details about how to page through the rest of the images, see Paging Images.

Passos seguintesNext steps

Se ainda não experimentou a API de Pesquisa de Imagem bing antes, tente um arranque rápido.If you haven't tried the Bing Image Search API before, try a quickstart. Se procura algo mais complexo, experimente o tutorial para criar uma aplicação web de uma página única.If you're looking for something more complex, try the tutorial to create a single-page web app.