Início Rápido: Usar a biblioteca de clientes da Pesquisa de Imagem do Bing

  • Artigo

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.

Use este início rápido para fazer sua primeira pesquisa de imagem com a biblioteca de clientes da Pesquisa de Imagem do Bing.

A biblioteca de pesquisa de clientes é um wrapper para a API REST e contém os mesmos recursos.

Você criará um aplicativo C# simples que envia uma consulta de pesquisa de imagem, analisa a resposta JSON e exibe a URL da primeira imagem devolvida.

Pré-requisitos

Veja também Preços dos Serviços de IA do Azure – API de Pesquisa do Bing.

Criar um projeto de console

Primeiro, crie um aplicativo de console do C#.

  1. Crie uma solução de console chamada BingImageSearch no Visual Studio.

  2. Adicione o pacote NuGet de Pesquisa de Imagem Cognitiva

    1. Clique com o botão direito do mouse no projeto no Gerenciador de Soluções.
    2. Selecione Gerenciar Pacotes NuGet.
    3. Pesquise e selecione Microsoft.Azure.CognitiveServices.Search.ImageSearch, depois instale o pacote.

Inicializar o aplicativo

  1. Substitua todas as instruções using no Program.cs pelo seguinte código:

    using System;
using System.Linq;
using Microsoft.Azure.CognitiveServices.Search.ImageSearch;
using Microsoft.Azure.CognitiveServices.Search.ImageSearch.Models;

  2. No método Main do seu projeto, crie variáveis para a chave de assinatura válida, os resultados da imagem que serão devolvidos pelo Bing e um termo de pesquisa. Em seguida, instancie o cliente de pesquisa de imagem usando a chave.

    static async Task Main(string[] args)
{
    //IMPORTANT: replace this variable with your Cognitive Services subscription key
    string subscriptionKey = "ENTER YOUR KEY HERE";
    //stores the image results returned by Bing
    Images imageResults = null;
    // the image search term to be used in the query
    string searchTerm = "canadian rockies";

    //initialize the client
    //NOTE: If you're using version 1.2.0 or below for the Bing Image Search client library, 
    // use ImageSearchAPI() instead of ImageSearchClient() to initialize your search client.

    var client = new ImageSearchClient(new ApiKeyServiceClientCredentials(subscriptionKey));
}

Envie uma consulta de pesquisa usando o cliente

Ainda no método Main, use o cliente para pesquisar com um texto de consulta:

// make the search request to the Bing Image API, and get the results"
imageResults = await client.Images.SearchAsync(query: searchTerm).Result; //search query

Analisar e ver o primeiro resultado de imagem

Analise os resultados da imagem retornados na resposta.

Se a resposta contiver resultados da pesquisa, armazene o primeiro resultado e imprima alguns de seus detalhes.

if (imageResults != null)
{
    //display the details for the first image result.
    var firstImageResult = imageResults.Value.First();
    Console.WriteLine($"\nTotal number of returned images: {imageResults.Value.Count}\n");
    Console.WriteLine($"Copy the following URLs to view these images on your browser.\n");
    Console.WriteLine($"URL to the first image:\n\n {firstImageResult.ContentUrl}\n");
    Console.WriteLine($"Thumbnail URL for the first image:\n\n {firstImageResult.ThumbnailUrl}");
    Console.WriteLine("Press any key to exit ...");
    Console.ReadKey();
}

Próximas etapas

Tutorial de aplicativo de página única da Pesquisa de Imagem do Bing

Confira também

Use este início rápido para fazer sua primeira pesquisa de imagem usando a biblioteca de clientes da Pesquisa de Imagem do Bing, que é um wrapper para a API e contém os mesmos recursos. Esse aplicativo simples do Java envia uma consulta de pesquisa de imagem, analisa a resposta JSON e exibe a URL da primeira imagem retornada.

Pré-requisitos

A versão mais recente do JDK (Java Development Kit)

Instale as dependências da biblioteca de clientes da Pesquisa de Imagem do Bing usando Maven, Gradle ou outro sistema de gerenciamento de dependência. O arquivo POM Maven requer a seguinte declaração:

 <dependencies>
    <dependency>
      <groupId>com.microsoft.azure.cognitiveservices</groupId>
      <artifactId>azure-cognitiveservices-imagesearch</artifactId>
      <version>1.0.1</version>
    </dependency>
 </dependencies>

Criar e inicializar o aplicativo

  1. Crie um novo projeto Java em seu IDE ou editor favorito e adicione as seguintes importações à sua implementação de classe:

    import com.microsoft.azure.cognitiveservices.search.imagesearch.BingImageSearchAPI;
import com.microsoft.azure.cognitiveservices.search.imagesearch.BingImageSearchManager;
import com.microsoft.azure.cognitiveservices.search.imagesearch.models.ImageObject;
import com.microsoft.azure.cognitiveservices.search.imagesearch.models.ImagesModel;

  2. No seu método principal, crie variáveis para o termo de pesquisa e a chave de assinatura. Em seguida, instancie o cliente da Pesquisa de Imagem do Bing.

    final String subscriptionKey = "COPY_YOUR_KEY_HERE";
String searchTerm = "canadian rockies";
//Image search client
BingImageSearchAPI client = BingImageSearchManager.authenticate(subscriptionKey);

Enviar uma solicitação de pesquisa para a API

  1. Usando bingImages().search(), envie a solicitação HTTP que contém a consulta de pesquisa. Salve a resposta como um ImagesModel.

    ImagesModel imageResults = client.bingImages().search()
            .withQuery(searchTerm)
            .withMarket("en-us")
            .execute();

Analisar e exibir o resultado

Analise os resultados da imagem retornados na resposta. Se a resposta contiver os resultados da pesquisa, armazene o primeiro resultado e imprima os detalhes, como a URL da miniatura, a URL original, juntamente com o número total de imagens retornadas.

if (imageResults != null && imageResults.value().size() > 0) {
    // Image results
    ImageObject firstImageResult = imageResults.value().get(0);

    System.out.println(String.format("Total number of images found: %d", imageResults.value().size()));
    System.out.println(String.format("First image thumbnail url: %s", firstImageResult.thumbnailUrl()));
    System.out.println(String.format("First image content url: %s", firstImageResult.contentUrl()));
}
else {
        System.out.println("Couldn't find image results!");
     }

Próximas etapas

Tutorial de aplicativo de página única da Pesquisa de Imagem do Bing

Confira também

Use este início rápido para fazer sua primeira pesquisa de imagem usando a biblioteca de clientes da Pesquisa de Imagem do Bing, que é um wrapper para a API e contém os mesmos recursos. Esse aplicativo simples do JavaScript enviar uma consulta de pesquisa de imagem, analisa a resposta JSON e exibe a URL da primeira imagem devolvida.

Pré-requisitos

  • A versão mais recente do Node.js.
  • O SDK a Pesquisa de Imagem do Bing para JavaScript
    • Para instalar, execute npm install @azure/cognitiveservices-imagesearch
  • A classe CognitiveServicesCredentials do pacote @azure/ms-rest-azure-js para autenticar o cliente.
    • Para instalar, execute npm install @azure/ms-rest-azure-js

Criar e inicializar o aplicativo

  1. Criar um novo arquivo JavaScript no seu IDE ou editor favorito e defina o rigor, o https e outros requisitos.

    'use strict';
const ImageSearchAPIClient = require('@azure/cognitiveservices-imagesearch');
const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;

  2. No método principal do seu projeto, crie variáveis para sua chave de assinatura válida, os resultados da imagem que serão devolvidos pelo Bing e um termo de pesquisa. Em seguida, instancie o cliente de pesquisa de imagem usando a chave.

    //replace this value with your valid subscription key.
let serviceKey = "ENTER YOUR KEY HERE";

//the search term for the request
let searchTerm = "canadian rockies";

//instantiate the image search client
let credentials = new CognitiveServicesCredentials(serviceKey);
let imageSearchApiClient = new ImageSearchAPIClient(credentials);

Criar uma função auxiliar assíncrona

  1. Crie uma função para chamar o cliente de forma assíncrona e retornar a resposta do serviço de Pesquisa de Imagem do Bing.

    // a helper function to perform an async call to the Bing Image Search API
const sendQuery = async () => {
    return await imageSearchApiClient.imagesOperations.search(searchTerm);
};

Enviar uma consulta e lidar com a resposta

  1. Chame a função auxiliar e lide com o promise para analisar os resultados da imagem devolvidos na resposta.

    Se a resposta contiver os resultados da pesquisa, armazene o primeiro resultado e imprima os detalhes, como a URL da miniatura, a URL original, juntamente com o número total de imagens retornadas.

    sendQuery().then(imageResults => {
    if (imageResults == null) {
    console.log("No image results were found.");
    }
    else {
        console.log(`Total number of images returned: ${imageResults.value.length}`);
        let firstImageResult = imageResults.value[0];
        //display the details for the first image result. After running the application,
        //you can copy the resulting URLs from the console into your browser to view the image.
        console.log(`Total number of images found: ${imageResults.value.length}`);
        console.log(`Copy these URLs to view the first image returned:`);
        console.log(`First image thumbnail url: ${firstImageResult.thumbnailUrl}`);
        console.log(`First image content url: ${firstImageResult.contentUrl}`);
    }
  })
  .catch(err => console.error(err))

Próximas etapas

Tutorial de aplicativo de página única da Pesquisa de Imagem do Bing

Confira também

Use este início rápido para fazer sua primeira pesquisa de imagem usando a biblioteca de clientes da Pesquisa de Imagem do Bing, que é um wrapper para a API e contém os mesmos recursos. Esse aplicativo simples do Python envia uma consulta de pesquisa de imagem, analisa a resposta JSON e exibe a URL da primeira imagem devolvida.

Pré-requisitos

Criar e inicializar o aplicativo

  1. Crie um novo script Python em seu IDE ou editor favorito e as seguintes importações:

    from azure.cognitiveservices.search.imagesearch import ImageSearchClient
from msrest.authentication import CognitiveServicesCredentials

  2. Crie variáveis para o termo de pesquisa e a chave de assinatura.

    subscription_key = "Enter your key here"
subscription_endpoint = "Enter your endpoint here"
search_term = "canadian rockies"

Crie o cliente de Pesquisa de Imagem

  1. Crie uma instância do CognitiveServicesCredentials e use-a para instanciar o cliente:

    client = ImageSearchClient(endpoint=subscription_endpoint, credentials=CognitiveServicesCredentials(subscription_key))

  2. Enviar a consulta de pesquisa para a API de Pesquisa de Imagem do Bing:

    image_results = client.images.search(query=search_term)

Processar e ver os resultados

Analise os resultados da imagem retornados na resposta.

Se a resposta contiver os resultados da pesquisa, armazene o primeiro resultado e imprima os detalhes, como a URL da miniatura, a URL original, juntamente com o número total de imagens retornadas.

if image_results.value:
    first_image_result = image_results.value[0]
    print("Total number of images returned: {}".format(len(image_results.value)))
    print("First image thumbnail url: {}".format(
        first_image_result.thumbnail_url))
    print("First image content url: {}".format(first_image_result.content_url))
else:
    print("No image results returned!")

Próximas etapas

Tutorial de aplicativo de página única da Pesquisa de Imagem do Bing

Confira também