Inicio rápido: Uso de la biblioteca cliente de Bing Image Search

  • Artículo

Advertencia

El 30 de octubre de 2020, las API de Bing Search se trasladaron de los servicios de Azure AI a los servicios de Bing Search. Esta documentación se proporciona solo como referencia. Para obtener documentación actualizada, consulte la documentación de Bing Search API. Para obtener instrucciones sobre cómo crear nuevos recursos de Azure para Bing Search, consulte el artículo sobre la creación de un recurso de Bing Search a través de Azure Marketplace.

Use este inicio rápido para realizar la primera búsqueda de imágenes mediante la biblioteca cliente de Bing Image Search.

La biblioteca de búsqueda de cliente es un contenedor de la API REST y contiene las mismas características.

Va a crear una aplicación de C# que envía una consulta de búsqueda de imágenes, analiza la respuesta de JSON y muestra la dirección URL de la primera imagen devuelta.

Prerrequisitos

Consulte también Precios de los servicios Azure AI - Bing Search API.

Creación de un proyecto de consola

En primer lugar, cree una nueva aplicación de consola de C#.

  1. Cree una solución de consola denominada BingImageSearch en Visual Studio.

  2. Agregue el paquete NuGet de búsqueda de imagen cognitiva.

    1. En el Explorador de soluciones, haga clic con el botón derecho en el proyecto.
    2. Seleccione Administrar paquetes NuGet.
    3. Busque y seleccione Microsoft.Azure.CognitiveServices.Search.ImageSearch y, a continuación, instale el paquete.

Inicialización de la aplicación

  1. Reemplace todas las instrucciones using en Program.cs por el código siguiente:

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

  2. En el método Main del proyecto, cree variables para la clave de suscripción válida, los resultados de imágenes que Bing devolverá y un término de búsqueda. Luego, use la clave para crear instancias del cliente de búsqueda de imagen.

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

Envío de una consulta de búsqueda con el cliente

Todavía en el método Main, use el cliente para buscar con el texto de una consulta:

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

Análisis y visualización del primer resultado de la imagen

Analice los resultados de la imagen devueltos en la respuesta.

Si la respuesta contiene resultados de búsqueda, almacene el primer resultado e imprima algunos de sus detalles.

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

Pasos siguientes

Tutorial de aplicación de una sola página de Bing Image Search

Consulte también

Use este inicio rápido para buscar su primera imagen mediante la biblioteca cliente de Bing Image Search, un contenedor de la API y que contiene las mismas características. Esta sencilla aplicación de Java envía una consulta de búsqueda de imagen, analiza la respuesta de JSON y muestra la dirección URL de la primera imagen devuelta.

Requisitos previos

La última versión del Kit de desarrollo de Java (JDK)

Instale las dependencias de la biblioteca cliente de Bing Image Search con Maven, Gradle u otro sistema de administración de dependencias. El archivo POM de Maven requiere la declaración siguiente:

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

Creación e inicialización de la aplicación

  1. Cree un proyecto de Java en su IDE o editor favorito y agregue las siguientes importaciones a la implementación de clases:

    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. En el método Main, cree variables para el término de búsqueda y la clave de suscripción. Luego, cree la instancia del cliente de Bing Image Search.

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

Envío de una solicitud de búsqueda a la API

  1. Con el uso de bingImages().search(), envíe la solicitud HTTP que contiene la consulta de búsqueda. Guarde la respuesta como ImagesModel.

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

Análisis y visualización del resultado

Analice los resultados de la imagen devueltos en la respuesta. Si la respuesta contiene resultados de la búsqueda, almacene el primer resultado e imprima sus detalles, como la dirección URL de una miniatura, la dirección URL original, además del número total de imágenes devueltas.

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

Pasos siguientes

Tutorial de aplicación de una sola página de Bing Image Search

Consulte también

Use este inicio rápido para buscar su primera imagen mediante la biblioteca cliente de Bing Image Search, un contenedor de la API y que contiene las mismas características. Esta sencilla aplicación de JavaScript envía una consulta de búsqueda de imagen, analiza la respuesta de JSON y muestra la dirección URL de la primera imagen devuelta.

Prerrequisitos

  • La última versión de Node.js.
  • El SDK de Bing Image Search para JavaScript.
    • Para instalarlo, ejecute npm install @azure/cognitiveservices-imagesearch.
  • La clase CognitiveServicesCredentials del paquete @azure/ms-rest-azure-js para autenticar el cliente.
    • Para instalarlo, ejecute npm install @azure/ms-rest-azure-js.

Creación e inicialización de la aplicación

  1. Cree un nuevo archivo JavaScript en el editor o el IDE que prefiera y establezca la rigurosidad, los protocolos https y demás requisitos.

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

  2. En el método principal del proyecto, cree variables para la clave de suscripción válida, los resultados de imágenes que Bing devolverá y un término de búsqueda. Luego, use la clave para crear instancias del cliente de búsqueda de imagen.

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

Creación de una función auxiliar asincrónica

  1. Cree una función para llamar al cliente de manera asincrónica y devuelva la respuesta del servicio Bing Image Search.

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

Envío de una consulta y control de la respuesta

  1. Llame a la función auxiliar y controle su promise para analizar los resultados de imágenes que se devuelven en la respuesta.

    Si la respuesta contiene resultados de la búsqueda, almacene el primer resultado e imprima sus detalles, como la dirección URL de una miniatura, la dirección URL original, además del número total de imágenes devueltas.

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

Pasos siguientes

Tutorial de aplicación de una sola página de Bing Image Search

Consulte también

Use este inicio rápido para buscar su primera imagen mediante la biblioteca cliente de Bing Image Search, un contenedor de la API y que contiene las mismas características. Esta sencilla aplicación de Python envía una consulta de búsqueda de imagen, analiza la respuesta de JSON y muestra la dirección URL de la primera imagen devuelta.

Requisitos previos

Creación e inicialización de la aplicación

  1. Cree un script de Python en su IDE o editor favorito y realice las siguientes importaciones:

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

  2. Cree variables para el término de búsqueda y la clave de suscripción.

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

Creación del cliente de Image Search

  1. Cree una instancia de CognitiveServicesCredentials y úsela para crear una instancia del cliente:

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

  2. Envíe una consulta de búsqueda a Bing Image Search API:

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

Procese y visualice los resultados

Analice los resultados de la imagen devueltos en la respuesta.

Si la respuesta contiene resultados de la búsqueda, almacene el primer resultado e imprima sus detalles, como la dirección URL de una miniatura, la dirección URL original, además del número total de imágenes devueltas.

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

Pasos siguientes

Tutorial de aplicación de una sola página de Bing Image Search

Consulte también