Guia de início rápido: usar a biblioteca de cliente da Pesquisa de Imagens do Bing

Use este início rápido para fazer sua primeira pesquisa de imagens usando a biblioteca de cliente da Pesquisa de Imagens do Bing.

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

Você criará um aplicativo C# que enviará uma consulta de pesquisa de imagem, analisará a resposta JSON e exibirá a URL da primeira imagem retornada.

Pré-requisitos

• Se você estiver usando o Windows, qualquer edição do Visual Studio 2017 ou posterior
• Se você estiver usando macOS ou Linux, o VS Code com o .NET Core instalado
• Uma subscrição gratuita Azure

Consulte também Preços dos serviços de IA do Azure - API de Pesquisa do Bing.

Criar um projeto de console

Primeiro, crie um novo aplicativo de console C#.

Inicializar o aplicativo

1. Substitua todas as using instruções 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. Main No método do seu projeto, crie variáveis para sua chave de assinatura válida, os resultados da imagem a serem retornados pelo Bing e um termo de pesquisa. Em seguida, instancie o cliente de pesquisa de imagens 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));
   }
   

Enviar uma consulta de pesquisa usando o cliente

Ainda no Main método, 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

Analise e visualize o primeiro resultado da imagem

Analise os resultados da imagem retornados na resposta.

Se a resposta contiver resultados de pesquisa, armazene o primeiro resultado e imprima alguns dos 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óximos passos

Ver também

• O que é a Pesquisa de Imagens do Bing?
• Experimente uma demonstração interativa online
• Exemplos .NET para o SDK de serviços de IA do Azure
• Documentação dos Serviços de IA do Azure
• Referência da API de Pesquisa de Imagens do Bing

Use este início rápido para fazer sua primeira pesquisa de imagens usando a biblioteca de cliente da Pesquisa de Imagens do Bing, que é um wrapper para a API e contém os mesmos recursos. Este aplicativo Java simples 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 Java Development Kit (JDK)

Instale as dependências da biblioteca de cliente da Pesquisa de Imagens do Bing usando o Maven, o Gradle ou outro sistema de gerenciamento de dependência. O arquivo Maven POM 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 a sua chave de subscrição e termo de pesquisa. Em seguida, instancie o cliente de Pesquisa de Imagens 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 contendo a consulta de pesquisa. Salve a resposta como ImagesModel.

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

Analise e visualize o resultado

Analise os resultados da imagem retornados na resposta. Se a resposta contiver resultados de pesquisa, armazene o primeiro resultado e imprima seus detalhes, como um URL em miniatura, o URL original e 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óximos passos

Ver também

• O que é a Pesquisa de Imagens do Bing?
• Experimente uma demonstração interativa online
• Exemplos Java para o SDK de serviços de IA do Azure
• Documentação dos Serviços de IA do Azure
• Referência da API de Pesquisa de Imagens do Bing

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

Pré-requisitos

• A última versão do Node.js.
• O SDK de Pesquisa de Imagens 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. Crie um novo arquivo JavaScript em seu IDE ou editor favorito e defina o rigor, 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 a serem retornados pelo Bing e um termo de pesquisa. Em seguida, instancie o cliente de pesquisa de imagens 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 retorne a resposta do serviço de Pesquisa de Imagens 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 manipular a resposta

1. Chame a função auxiliar e manipule-a promise para analisar os resultados da imagem retornados na resposta.

   Se a resposta contiver resultados de pesquisa, armazene o primeiro resultado e imprima seus detalhes, como um URL em miniatura, o URL original e 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óximos passos

Ver também

• O que é a Pesquisa de Imagens do Bing?
• Experimente uma demonstração interativa online
• Node.js exemplos para o SDK de serviços de IA do Azure
• Documentação dos Serviços de IA do Azure
• Referência da API de Pesquisa de Imagens do Bing

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

Pré-requisitos

• Python 2.7 ou 3.6+.

• A biblioteca de cliente do Azure Image Search para Python

  • Instalar com pip install azure-cognitiveservices-search-imagesearch

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 a sua chave de subscrição e termo de pesquisa.

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

Criar o cliente de pesquisa de imagens

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

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

2. Envie uma consulta de pesquisa para a API de Pesquisa de Imagens do Bing:

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

Processar e visualizar os resultados

Analise os resultados da imagem retornados na resposta.

Se a resposta contiver resultados de pesquisa, armazene o primeiro resultado e imprima seus detalhes, como um URL em miniatura, o URL original e 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óximos passos

Ver também

• O que é a Pesquisa de Imagens do Bing?
• Experimente uma demonstração interativa online
• Exemplos de Python para o SDK de serviços de IA do Azure
• Documentação dos Serviços de IA do Azure
• Referência da API de Pesquisa de Imagens do Bing