Guida introduttiva: Cercare immagini con l’SDK di Ricerca immagini Bing per PythonQuickstart: Search for images with the Bing Image Search SDK for Python

Usare questa guida introduttiva per effettuare la prima ricerca di immagini tramite l'SDK di Ricerca immagini Bing, che consiste in un wrapper per l'API e contiene le stesse funzionalità.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. Questa semplice applicazione Python invia una query di ricerca immagine, analizza la risposta JSON e visualizza l'URL della prima immagine restituita.This simple Python application sends an image search query, parses the JSON response, and displays the URL of the first image returned.

Il codice sorgente per questo esempio è disponibile in GitHub con annotazioni aggiuntive e altre informazioni sulla gestione degli errori.The source code for this sample is available on GitHub with additional error handling and annotations.

PrerequisitiPrerequisites

Ottenere una chiave di accesso di Servizi cognitivi in Ricerca.Get a Cognitive Services access key under Search. Vedere anche Prezzi di Servizi cognitivi - API di ricerca Bing.See also Cognitive Services Pricing - Bing Search API.

È necessario avere un account delle API Servizi cognitivi con accesso alle API di ricerca Bing.You must have a Cognitive Services API account with access to the Bing Search APIs. Se non si ha una sottoscrizione di Azure, è possibile creare un account gratuito.If you don't have an Azure subscription, you can create an account for free. Prima di continuare, è necessaria la chiave di accesso fornita dopo l'attivazione della versione di valutazione gratuita oppure è possibile usare una chiave di sottoscrizione a pagamento dal dashboard di Azure.Before continuing, You will need the access key provided after activating your free trial, or a paid subscription key from your Azure dashboard.

Creare e inizializzare l'applicazioneCreate and initialize the application

  1. Creare un nuovo script Python nell'ambiente di sviluppo integrato o nell'editor preferito ed eseguire le importazioni seguenti:Create a new Python script in your favorite IDE or editor, and the following imports:

    from azure.cognitiveservices.search.imagesearch import ImageSearchAPI
    from msrest.authentication import CognitiveServicesCredentials
    
  2. Creare variabili per la chiave di sottoscrizione e per il termine di ricerca.Create variables for your subscription key and search term.

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

Creare il client di Ricerca immaginiCreate the image search client

  1. Creare un'istanza di CognitiveServicesCredentials e usarla per creare un'istanza del client:Create an instance of CognitiveServicesCredentials, and use it to instantiate the client:

    client = ImageSearchAPI(CognitiveServicesCredentials(subscription_key))
    
  2. Inviare una query di ricerca all'API Ricerca immagini Bing:Send a search query to the Bing Image Search API:

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

    Elaborare e visualizzare i risultatiProcess and view the results

Analizzare le immagini restituite nella risposta.Parse the image results returned in the response.

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

Passaggi successiviNext steps

Vedere ancheSee also