Avvio rapido: Usare la libreria client di Ricerca immagini Bing

  • Articolo

Avviso

Il 30 ottobre 2020 le API di Ricerca Bing spostate dai servizi di intelligenza artificiale di Azure ai servizi Ricerca Bing. Questa documentazione viene fornita solo per informazioni di riferimento. Per la documentazione aggiornata, vedere la documentazione dell'API di ricerca Bing. Per istruzioni sulla creazione di nuove risorse di Azure per la ricerca Bing, vedere Creare una risorsa Ricerca Bing tramite la Azure Marketplace.

Usare questa guida di avvio rapido per effettuare la prima ricerca di immagini tramite la libreria client di Ricerca immagini Bing.

La libreria di ricerca client è un wrapper per l'API REST e contiene le stesse funzionalità.

Creare un'applicazione C# che invia una query di ricerca di immagini, analizza la risposta JSON e visualizza l'URL della prima immagine restituita.

Prerequisiti

Vedere anche prezzi dei servizi di intelligenza artificiale di Azure - API Ricerca Bing.

Creare un nuovo progetto console

Prima di tutto, creare una nuova applicazione console C#.

  1. Creare una nuova soluzione console denominata BingImageSearch in Visual Studio.

  2. Aggiungere il pacchetto NuGet di ricerca cognitiva di immagini

    1. Fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni.
    2. Scegliere Gestisci pacchetti NuGet.
    3. Cercare e selezionare Microsoft.Azure.CognitiveServices.Search.ImageSearch, quindi installare il pacchetto.

Inizializzare l'applicazione

  1. Sostituire tutte le istruzioni using in Program.cs con il codice seguente:

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

  2. Nel metodo Main del progetto, creare variabili per la chiave di sottoscrizione valida, i risultati immagini che devono essere restituiti da Bing e un termine di ricerca. Creare quindi un'istanza del client di ricerca delle immagini usando la chiave.

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

Inviare una query di ricerca tramite il client

Sempre con il metodo Main, usare il client per eseguire una ricerca con il testo della query:

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

Analizzare e visualizzare la prima immagine dei risultati

Analizzare le immagini restituite nella risposta.

Se la risposta contiene risultati della ricerca, archiviare il primo risultato e stamparne alcuni dettagli.

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

Passaggi successivi

Esercitazione sull'app a singola pagina di Ricerca immagini Bing

Vedere anche

Usare questa guida di avvio rapido per effettuare la prima ricerca di immagini tramite la libreria client di Ricerca immagini Bing, che consiste in un wrapper per l'API e contiene le stesse funzionalità. Questa semplice applicazione Java invia una query di ricerca di immagini, analizza la risposta JSON e visualizza l'URL della prima immagine restituita.

Prerequisiti

La versione più recente di Java Development Kit (JDK)

Installare le dipendenze della libreria client di Ricerca immagini Bing usando Maven, Gradle o un altro sistema di gestione delle dipendenze. Il file POM di Maven richiede la dichiarazione seguente:

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

Creare e inizializzare l'applicazione

  1. Creare un nuovo progetto Java nell'ambiente di sviluppo integrato o nell'editor preferito e aggiungere le importazioni seguenti all'implementazione della 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. Nel metodo principale creare variabili per la chiave di sottoscrizione e per il termine di ricerca. Creare quindi un'istanza del client di Ricerca immagini Bing.

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

Inviare una richiesta di ricerca all'API

  1. Tramite bingImages().search(), inviare la richiesta HTTP contenente la query di ricerca. Salvare la risposta come ImagesModel.

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

Analizzare e visualizzare il risultato

Analizzare le immagini restituite nella risposta. Se la risposta contiene i risultati della ricerca, archiviare il primo risultato e stamparne i dettagli, ad esempio l'URL di anteprima e l'URL originale, insieme al numero totale di immagini restituite.

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

Passaggi successivi

Esercitazione sull'app a singola pagina di Ricerca immagini Bing

Vedere anche

Usare questa guida di avvio rapido per effettuare la prima ricerca di immagini tramite la libreria client di Ricerca immagini Bing, che consiste in un wrapper per l'API e contiene le stesse funzionalità. Questa semplice applicazione JavaScript invia una query di ricerca immagine, analizza la risposta JSON e visualizza l'URL della prima immagine restituita.

Prerequisiti

  • La versione più recente di Node.js.
  • L'SDK di Ricerca immagini Bing per JavaScript
    • Per installarlo, eseguire npm install @azure/cognitiveservices-imagesearch
  • La classe CognitiveServicesCredentials del pacchetto @azure/ms-rest-azure-js per autenticare il client.
    • Per installarlo, eseguire npm install @azure/ms-rest-azure-js

Creare e inizializzare l'applicazione

  1. Creare un nuovo file JavaScript nell'IDE o editor preferito e impostare severità, https e altri requisiti.

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

  2. Nel metodo principale del progetto, creare variabili per la chiave di sottoscrizione valida, i risultati immagini che devono essere restituiti da Bing e un termine di ricerca. Creare quindi un'istanza del client di ricerca delle immagini usando la chiave.

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

Creare una funzione helper asincrone

  1. Creare una funzione per chiamare il client in modo asincrono e restituire la risposta dal servizio di ricerca immagini Bing.

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

Inviare una query e gestire la risposta

  1. Chiamare la funzione helper e gestire il relativo promise per analizzare i risultati di immagine restituiti con la risposta.

    Se la risposta contiene i risultati della ricerca, archiviare il primo risultato e stamparne i dettagli, ad esempio l'URL di anteprima e l'URL originale, insieme al numero totale di immagini restituite.

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

Passaggi successivi

Esercitazione sull'app a singola pagina di Ricerca immagini Bing

Vedere anche

Usare questa guida di avvio rapido per effettuare la prima ricerca di immagini tramite la libreria client di Ricerca immagini Bing, che consiste in un wrapper per l'API e contiene le stesse funzionalità. Questa semplice applicazione Python invia una query di ricerca immagine, analizza la risposta JSON e visualizza l'URL della prima immagine restituita.

Prerequisiti

Creare e inizializzare l'applicazione

  1. Creare un nuovo script Python nell'ambiente di sviluppo integrato o nell'editor preferito ed eseguire le importazioni seguenti:

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

  2. Creare variabili per la chiave di sottoscrizione e per il termine di ricerca.

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

Creare il client di Ricerca immagini

  1. Creare un'istanza di CognitiveServicesCredentials e usarla per creare un'istanza del client:

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

  2. Inviare una query di ricerca all'API Ricerca immagini Bing:

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

Elaborare e visualizzare i risultati

Analizzare le immagini restituite nella risposta.

Se la risposta contiene i risultati della ricerca, archiviare il primo risultato e stamparne i dettagli, ad esempio l'URL di anteprima e l'URL originale, insieme al numero totale di immagini restituite.

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

Passaggi successivi

Esercitazione sull'app a singola pagina di Ricerca immagini Bing

Vedere anche