Quickstart: Use a biblioteca de clientes Bing Image SearchQuickstart: Use the Bing Image Search client library

Utilize este quickstart para fazer a sua primeira pesquisa de imagem utilizando a biblioteca do cliente Bing Image Search, que é um invólucro para a API e contém as mesmas funcionalidades.Use this quickstart to make your first image search using the Bing Image Search client library, which is a wrapper for the API and contains the same features. Esta aplicação C# simples envia uma consulta de pesquisa de imagens, analisa a resposta JSON e apresenta o URL da primeira imagem devolvida.This simple C# application sends an image search query, parses the JSON response, and displays the URL of the first image returned.

O código fonte deste exemplo está disponível no GitHub com processamento de erros e anotações de código adicionais.The source code for this sample is available on GitHub with additional error handling and annotations.

Pré-requisitosPrerequisites

Para instalar a biblioteca de clientes Bing Image Search no Estúdio Visual, utilize a opção 'Gerir pacotes' do Solution Explorer.To install the Bing Image Search client library in Visual Studio, use the Manage NuGet Packages option from Solution Explorer.

Criar um recurso AzureCreate an Azure resource

Comece a utilizar a API de Pesquisa de Imagem Bing criando um dos seguintes recursos Azure.Start using the Bing Image Search API by creating one of the following Azure resources.

Bing Search v7 recursoBing Search v7 resource

  • Disponível através do portal Azure até eliminar o recurso.Available through the Azure portal until you delete the resource.
  • Use o nível de preços gratuitos para experimentar o serviço e atualize mais tarde para um nível pago para produção.Use the free pricing tier to try the service, and upgrade later to a paid tier for production.

Recurso multi-serviçoMulti-service resource

  • Disponível através do portal Azure até eliminar o recurso.Available through the Azure portal until you delete the resource.
  • Use a mesma chave e ponto final para as suas aplicações, através de vários Serviços Cognitivos.Use the same key and endpoint for your applications, across multiple Cognitive Services.

Consulte também preços dos serviços cognitivos - Bing Search API.See also Cognitive Services Pricing - Bing Search API.

Criar e inicializar a aplicaçãoCreate and initialize the application

Primeiro, crie uma nova aplicação de consola C# no Visual Studio.First, create a new C# console application in Visual Studio. Em seguida, adicione os seguintes pacotes ao seu projeto.Then add the following packages to your project.

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

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.In the main method of your project, create variables for your valid subscription key, the image results to be returned by Bing, and a search term. Em seguida, inicie o cliente de pesquisa de imagens com a chave.Then instantiate the image search client using the key.

//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 clienteSend a search query using the client

Utilize o cliente para procurar com um texto de consulta:Use the client to search with a query text:

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

Analisar e ver o primeiro resultado da imagemParse and view the first image result

Analise os resultados da imagem devolvidos na resposta.Parse the image results returned in the response. Se a resposta contiver os resultados da pesquisa, armazene o primeiro resultado e imprima os detalhes, como um URL de miniatura, o URL original, juntamente com o número total de imagens devolvidas.If the response contains search results, store the first result and print out its details, such as a thumbnail URL, the original URL,along with the total number of returned images.

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.ReadKey();
}

Passos seguintesNext steps

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

Ver tambémSee also

Utilize este quickstart para fazer a sua primeira pesquisa de imagem utilizando a biblioteca do cliente Bing Image Search, que é um invólucro para a API e contém as mesmas funcionalidades.Use this quickstart to make your first image search using the Bing Image Search client library, which is a wrapper for the API and contains the same features. Esta aplicação Java simples envia uma consulta de pesquisa de imagens, analisa a resposta JSON e apresenta o URL da primeira imagem devolvida.This simple Java application sends an image search query, parses the JSON response, and displays the URL of the first image returned.

O código fonte deste exemplo está disponível no GitHub com processamento de erros e anotações de código adicionais.The source code for this sample is available on GitHub with additional error handling and annotations.

Pré-requisitosPrerequisites

A versão mais recente do Java Development Kit (JDK)The latest version of the Java Development Kit (JDK)

Instale as dependências da biblioteca do cliente Bing Image Search utilizando Maven, Gradle ou outro sistema de gestão de dependência.Install the Bing Image Search client library dependencies by using Maven, Gradle, or another dependency management system. O ficheiro POM do Maven necessita da seguinte declaração:The Maven POM file requires the following declaration:

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

Criar um recurso AzureCreate an Azure resource

Comece a utilizar a API de Pesquisa de Imagem Bing criando um dos seguintes recursos Azure.Start using the Bing Image Search API by creating one of the following Azure resources.

Bing Search v7 recursoBing Search v7 resource

  • Disponível através do portal Azure até eliminar o recurso.Available through the Azure portal until you delete the resource.
  • Use o nível de preços gratuitos para experimentar o serviço e atualize mais tarde para um nível pago para produção.Use the free pricing tier to try the service, and upgrade later to a paid tier for production.

Recurso multi-serviçoMulti-service resource

  • Disponível através do portal Azure até eliminar o recurso.Available through the Azure portal until you delete the resource.
  • Use a mesma chave e ponto final para as suas aplicações, através de vários Serviços Cognitivos.Use the same key and endpoint for your applications, across multiple Cognitive Services.

Criar e inicializar a aplicaçãoCreate and initialize the application

  1. Crie um novo projeto Java no seu IDE ou editor favorito e adicione as seguintes importações à sua implementação de classe:Create a new Java project in your favorite IDE or editor, and add the following imports to your class implementation:

    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.In your main method create variables for your subscription key, and search term. Em seguida, instancie o cliente Pesquisa de Imagens do Bing.Then instantiate the Bing Image Search client.

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

Enviar um pedido de pesquisa à APISend a search request to the API

  1. Utilize bingImages().search() para enviar o pedido HTTP que contém a consulta de pesquisa.Using bingImages().search(), send the HTTP request containing the search query. Guarde a resposta como ImagesModel.Save the response as a ImagesModel.

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

Analisar e ver o resultadoParse and view the result

Analise os resultados da imagem devolvidos na resposta.Parse the image results returned in the response. Se a resposta contiver resultados de pesquisa, guarde o primeiro resultado e imprima os seus detalhes, tais como um URL de miniatura, o URL original, juntamente com o número total de imagens devolvidas.If the response contains search results, store the first result and print out its details, such as a thumbnail URL, the original URL, along with the total number of returned images.

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 seguintesNext steps

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

Veja tambémSee also

Utilize este quickstart para fazer a sua primeira pesquisa de imagem utilizando a biblioteca do cliente Bing Image Search, que é um invólucro para a API e contém as mesmas funcionalidades.Use this quickstart to make your first image search using the Bing Image Search client library, which is a wrapper for the API and contains the same features. Esta aplicação JavaScript simples envia uma consulta de pesquisa de imagens, analisa a resposta JSON e apresenta o URL da primeira imagem devolvida.This simple JavaScript application sends an image search query, parses the JSON response, and displays the URL of the first image returned.

O código-fonte desta amostra está disponível no GitHub com tratamento de erros adicionais e anotações.The source code for this sample is available on GitHub with additional error handling and annotations.

Pré-requisitosPrerequisites

Criar um recurso AzureCreate an Azure resource

Comece a utilizar a API de Pesquisa de Imagem Bing criando um dos seguintes recursos Azure.Start using the Bing Image Search API by creating one of the following Azure resources.

Bing Search v7 recursoBing Search v7 resource

  • Disponível através do portal Azure até eliminar o recurso.Available through the Azure portal until you delete the resource.
  • Use o nível de preços gratuitos para experimentar o serviço e atualize mais tarde para um nível pago para produção.Use the free pricing tier to try the service, and upgrade later to a paid tier for production.

Recurso multi-serviçoMulti-service resource

  • Disponível através do portal Azure até eliminar o recurso.Available through the Azure portal until you delete the resource.
  • Use a mesma chave e ponto final para as suas aplicações, através de vários Serviços Cognitivos.Use the same key and endpoint for your applications, across multiple Cognitive Services.

Criar e inicializar a aplicaçãoCreate and initialize the application

  1. Crie um novo ficheiro JavaScript no seu IDE ou editor favorito e defina a exatidão, o HTTPS e outros requisitos.Create a new JavaScript file in your favorite IDE or editor, and set the strictness, https, and other requirements.

    'use strict';
    const ImageSearchAPIClient = require('@azure/cognitiveservices-imagesearch');
    const CognitiveServicesCredentials = require('ms-rest-azure').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.In the main method of your project, create variables for your valid subscription key, the image results to be returned by Bing, and a search term. Em seguida, inicie o cliente de pesquisa de imagens com a chave.Then instantiate the image search client using the key.

    //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íncronaCreate an asynchronous helper function

  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.Create a function to call the client asynchronously, and return the response from the Bing Image Search service.

    //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 respostaSend a query and handle the response

  2. Chame a função auxiliar e processe promise para analisar os resultados de imagens devolvidos na resposta.Call the helper function and handle its promise to parse the image results returned in the response.

    Se a resposta contiver os resultados da pesquisa, armazene o primeiro resultado e imprima os detalhes, como um URL de miniatura, o URL original, juntamente com o número total de imagens devolvidas.If the response contains search results, store the first result and print out its details, such as a thumbnail URL, the original URL,along with the total number of returned images.

    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 seguintesNext steps

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

Ver tambémSee also

Utilize este quickstart para fazer a sua primeira pesquisa de imagem utilizando a biblioteca do cliente Bing Image Search, que é um invólucro para a API e contém as mesmas funcionalidades.Use this quickstart to make your first image search using the Bing Image Search client library, which is a wrapper for the API and contains the same features. Esta aplicação Python simples envia uma consulta de pesquisa de imagens, analisa a resposta JSON e apresenta o URL da primeira imagem devolvida.This simple Python application sends an image search query, parses the JSON response, and displays the URL of the first image returned.

O código fonte deste exemplo está disponível no GitHub com processamento de erros e anotações de código adicionais.The source code for this sample is available on GitHub with additional error handling and annotations.

Pré-requisitosPrerequisites

Criar um recurso AzureCreate an Azure resource

Comece a utilizar a API de Pesquisa de Imagem Bing criando um dos seguintes recursos Azure.Start using the Bing Image Search API by creating one of the following Azure resources.

Bing Search v7 recursoBing Search v7 resource

  • Disponível através do portal Azure até eliminar o recurso.Available through the Azure portal until you delete the resource.
  • Use o nível de preços gratuitos para experimentar o serviço e atualize mais tarde para um nível pago para produção.Use the free pricing tier to try the service, and upgrade later to a paid tier for production.

Recurso multi-serviçoMulti-service resource

  • Disponível através do portal Azure até eliminar o recurso.Available through the Azure portal until you delete the resource.
  • Use a mesma chave e ponto final para as suas aplicações, através de vários Serviços Cognitivos.Use the same key and endpoint for your applications, across multiple Cognitive Services.

Criar e inicializar a aplicaçãoCreate and initialize the application

  1. Crie um novo script Python no seu IDE ou editor favorito e as seguintes importações:Create a new Python script in your favorite IDE or editor, and the following imports:

    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.Create variables for your subscription key and search term.

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

Criar o cliente de pesquisa de imagensCreate the image search client

  1. Crie uma instância do CognitiveServicesCredentials e utilize-a para instanciar o cliente:Create an instance of CognitiveServicesCredentials, and use it to instantiate the client:

    client = ImageSearchClient(endpoint=subscription_endpoint, credentials=CognitiveServicesCredentials(subscription_key))
    
  2. Envie uma consulta de pesquisa para a API de Pesquisa de Imagens do Bing:Send a search query to the Bing Image Search API:

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

    Processar e ver os resultadosProcess and view the results

Analise os resultados da imagem devolvidos na resposta.Parse the image results returned in the response.

Se a resposta contiver os resultados da pesquisa, armazene o primeiro resultado e imprima os detalhes, como um URL de miniatura, o URL original, juntamente com o número total de imagens devolvidas.If the response contains search results, store the first result and print out its details, such as a thumbnail URL, the original URL,along with the total number of returned images.

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 seguintesNext steps

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

Ver tambémSee also