Guía de inicio rápido: Búsqueda de imágenes con el SDK de Bing Image Search para Node.jsQuickstart: Search for images with the Bing Image Search SDK for Node.js

Use este inicio rápido para buscar su primera imagen con el SDK de Bing Image Search, un contenedor de la API y que contiene las mismas características.Use this quickstart to make your first image search using the Bing Image Search SDK, which is a wrapper for the API and contains the same features. 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.This simple JavaScript application sends an image search query, parses the JSON response, and displays the URL of the first image returned.

El código fuente de este ejemplo está disponible en GitHub con anotaciones y control de errores adicionales.The source code for this sample is available on GitHub with additional error handling and annotations.

Requisitos previosPrerequisites

Obtenga una clave de acceso de Cognitive Services en Buscar.Get a Cognitive Services access key under Search. Consulte también Precios de Cognitive Services - Bing Search API.See also Cognitive Services Pricing - Bing Search API. Consulte también Precios de Cognitive Services - Bing Search API.See also Cognitive Services Pricing - Bing Search API.

Debe tener una cuenta de Cognitive Services API con acceso a Bing Search APIs.You must have a Cognitive Services API account with access to the Bing Search APIs. Si no tiene una suscripción de Azure, puede crear una cuenta gratuita.If you don't have an Azure subscription, you can create an account for free. Antes de continuar, necesitará la clave de acceso que se le proporcionó al activar la versión de evaluación gratuita o puede usar una clave de suscripción de pago desde el panel de Azure.Before continuing, You will need the access key provided after activating your free trial, or a paid subscription key from your Azure dashboard.

Creación e inicialización de la aplicaciónCreate and initialize the application

  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.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. 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.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. Luego, use la clave para crear instancias del cliente de búsqueda de imagen.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);
    
    

Creación de una función auxiliar asincrónicaCreate an asynchronous helper function

  1. Cree una función para llamar al cliente de manera asincrónica y devuelva la respuesta del servicio Bing Image Search.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);
    };
    

    Envío de una consulta y control de la respuestaSend a query and handle the response

  2. Llame a la función auxiliar y controle su promise para analizar los resultados de imágenes que se devuelven en la respuesta.Call the helper function and handle its promise to parse the image results returned in the response.

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

Pasos siguientesNext steps

Otras referenciasSee also