Inicio rápido: Uso de la biblioteca cliente de Bing Image Search
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
- Si usa Windows, cualquier edición de Visual Studio 2017 o posterior.
- Si utiliza macOS o Linux, VS Code con .NET Core instalado.
- Una suscripción de Azure gratuita
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#.
Cree una solución de consola denominada BingImageSearch en Visual Studio.
Agregue el paquete NuGet de búsqueda de imagen cognitiva.
- En el Explorador de soluciones, haga clic con el botón derecho en el proyecto.
- Seleccione Administrar paquetes NuGet.
- Busque y seleccione Microsoft.Azure.CognitiveServices.Search.ImageSearch y, a continuación, instale el paquete.
Inicialización de la aplicación
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;
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
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
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;
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
Con el uso de
bingImages().search()
, envíe la solicitud HTTP que contiene la consulta de búsqueda. Guarde la respuesta comoImagesModel
.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
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
.
- Para instalarlo, ejecute
- La clase
CognitiveServicesCredentials
del paquete@azure/ms-rest-azure-js
para autenticar el cliente.- Para instalarlo, ejecute
npm install @azure/ms-rest-azure-js
.
- Para instalarlo, ejecute
Creación e inicialización de la aplicación
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;
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
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
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
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
La biblioteca cliente de Azure Image Search para Python
- Instalación mediante
pip install azure-cognitiveservices-search-imagesearch
- Instalación mediante
Creación e inicialización de la aplicación
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
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
Cree una instancia de
CognitiveServicesCredentials
y úsela para crear una instancia del cliente:client = ImageSearchClient(endpoint=subscription_endpoint, credentials=CognitiveServicesCredentials(subscription_key))
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!")