Início Rápido: Utilizar a biblioteca de cliente da 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.

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

A biblioteca de pesquisa de cliente é um wrapper para a API REST e contém as mesmas funcionalidades.

Vai criar uma aplicação C# que envia uma consulta de pesquisa de imagens, analisa a resposta JSON e apresenta o URL da primeira imagem devolvida.

Pré-requisitos

Veja também Os preços dos serviços de IA do Azure - Pesquisa do Bing API.

Criar um projeto de consola

Primeiro, crie uma nova aplicação de consola C#.

  1. Crie uma nova solução de consola com o nome BingImageSearch no Visual Studio.

  2. Adicionar o pacote Cognitive Image Search NuGet

    1. Clique com o botão direito do rato no projeto no Explorador de Soluções.
    2. Selecione Gerir Pacotes NuGet.
    3. Procure e selecione Microsoft.Azure.CognitiveServices.Search.ImageSearch e, em seguida, instale o pacote.

Inicializar a aplicação

  1. Substitua todas as using instruções em 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 a sua chave de subscrição válida, os resultados da imagem a serem devolvidos pelo Bing e um termo de pesquisa. Em seguida, inicie o cliente de pesquisa de imagens com 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 com o cliente

Ainda no Main método , utilize o cliente para procurar 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 da imagem

Analise os resultados da imagem devolvidos na resposta.

Se a resposta contiver resultados de pesquisa, armazene o primeiro resultado e imprima alguns dos respetivos 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();
}

Passos seguintes

Bing Image Search single-page app tutorial (Tutorial de aplicação de página única da Pesquisa de Imagens do Bing)

Ver também

Utilize este início rápido para fazer a sua primeira pesquisa de imagens com a biblioteca de cliente da Pesquisa de Imagens do Bing, que é um wrapper para a API e contém as mesmas funcionalidades. Esta aplicação Java simples envia uma consulta de pesquisa de imagens, analisa a resposta JSON e apresenta o URL da primeira imagem devolvida.

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 com o Maven, o Gradle ou outro sistema de gestão de dependências. O ficheiro POM do Maven necessita da 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 a aplicação

  1. Crie um novo projeto Java no seu IDE ou editor favorito e adicione as seguintes importações à implementação da sua 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 método principal, crie variáveis para a sua chave de subscrição e termo de pesquisa. Em seguida, instancie o cliente 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 um pedido de pesquisa para a API

  1. Utilize bingImages().search() para enviar o pedido HTTP que contém a consulta de pesquisa. Guarde a resposta como ImagesModel.

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

Analisar e ver o resultado

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

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!");
     }

Passos seguintes

Bing Image Search single-page app tutorial (Tutorial de aplicação de página única da Pesquisa de Imagens do Bing)

Ver também

Utilize este início rápido para fazer a sua primeira pesquisa de imagens com a biblioteca de cliente da Pesquisa de Imagens do Bing, que é um wrapper para a API e contém as mesmas funcionalidades. Esta aplicação JavaScript simples envia uma consulta de pesquisa de imagens, analisa a resposta JSON e apresenta o URL da primeira imagem devolvida.

Pré-requisitos

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

Criar e inicializar a aplicação

  1. Crie um novo ficheiro JavaScript no seu IDE ou editor favorito e defina a exatidão, 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 projeto, crie variáveis para a sua chave de subscrição válida, os resultados de imagens a devolver pelo Bing e um termo de pesquisa. Em seguida, inicie o cliente de pesquisa de imagens com 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 devolver a resposta do serviço 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 processar a resposta

  1. Chame a função auxiliar e processe promise para analisar os resultados de imagens devolvidos na resposta.

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

    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))

Passos seguintes

Bing Image Search single-page app tutorial (Tutorial de aplicação de página única da Pesquisa de Imagens do Bing)

Ver também

Utilize este início rápido para fazer a sua primeira pesquisa de imagens com a biblioteca de cliente da Pesquisa de Imagens do Bing, que é um wrapper para a API e contém as mesmas funcionalidades. Esta aplicação Python simples envia uma consulta de pesquisa de imagens, analisa a resposta JSON e apresenta o URL da primeira imagem devolvida.

Pré-requisitos

Criar e inicializar a aplicação

  1. Crie um novo script Python no 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 utilize-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 ver os resultados

Analise os resultados da imagem devolvidos na resposta.

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

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!")

Passos seguintes

Bing Image Search single-page app tutorial (Tutorial de aplicação de página única da Pesquisa de Imagens do Bing)

Ver também