Démarrage rapide : Utiliser la bibliothèque de client Recherche d’images Bing

  • Article

Avertissement

Le 30 octobre 2020, les API de recherche Bing sont passées des services Azure AI aux services de recherche Bing. Cette documentation est fournie à des fins de référence uniquement. Pour accéder à la documentation mise à jour, consultez la documentation de l’API Recherche Bing. Pour obtenir des instructions sur la création de nouvelles ressources Azure pour Recherche Bing, consultez Créer une ressource Recherche Bing à l’aide de Place de marché Azure.

Utilisez ce guide de démarrage rapide pour effectuer votre première recherche d’images à l’aide de la bibliothèque de client Recherche d’images Bing.

Cette bibliothèque est un wrapper de l’API REST et contient les mêmes fonctionnalités.

Vous allez créer une application C# simple qui envoie une requête de recherche d’image, analyse la réponse JSON et affiche l’URL de la première image retournée.

Prérequis

Consultez également Tarification Azure AI services – API de recherche Bing.

Créer un projet de console

Tout d’abord, créez une application console C#.

  1. Créez une solution de console nommée BingImageSearch dans Visual Studio.

  2. Ajoutez le package NuGet de recherche d’images cognitive :

    1. Cliquez avec le bouton droit sur l’Explorateur de solutions.
    2. Sélectionnez Gérer les packages NuGet.
    3. Recherchez et sélectionnez Microsoft.Azure.CognitiveServices.Search.ImageSearch, puis installez le package.

Initialiser l’application

  1. Remplacez toutes les instructions using dans Program.cs par le code suivant :

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

  2. Dans la méthode Main de votre projet, créez des variables pour votre clé d’abonnement valide, les résultats d’image devant être retournés par Bing et un terme de recherche. Ensuite, instanciez le client de recherche d’image à l’aide de la clé.

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

Envoyer une requête de recherche avec le client

Toujours dans la méthode Main, utilisez le client pour effectuer une recherche avec un texte de requête :

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

Analyser et afficher le premier résultat d’image

Analysez les résultats d’image retournés par la réponse.

Si la réponse contient des résultats de recherche, stockez le premier résultat et affichez certains de ses détails.

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

Étapes suivantes

Tutoriel d’une application monopage Recherche d’images Bing

Voir aussi

Utilisez ce guide de démarrage rapide pour effectuer votre première recherche d’images à l’aide de la bibliothèque de client Recherche d’images Bing, qui est un wrapper de l’API et contient les mêmes fonctionnalités. Cette application Java simple envoie une requête de recherche d’image, analyse la réponse JSON et affiche l’URL de la première image retournée.

Prérequis

La dernière version du JDK (Java Development Kit)

Installez les dépendances de bibliothèque de client Recherche d’images Bing en utilisant Maven, Gradle ou un autre système de gestion des dépendances. Le fichier POM Maven nécessite la déclaration suivante :

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

Créer et initialiser l’application

  1. Créez un projet Java dans votre éditeur ou IDE favori, et ajoutez les importations suivantes à votre implémentation de 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. Dans votre méthode principale, créez des variables pour votre clé d’abonnement, ainsi que votre terme de recherche. Instanciez ensuite le client Recherche d’images Bing.

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

Envoyer une demande de recherche à l’API

  1. À l’aide de bingImages().search(), envoyer la requête HTTP contenant la requête de recherche. Enregistrer la réponse sous la forme d’un ImagesModel.

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

Analyser et afficher le résultat

Analysez les résultats d’image retournés par la réponse. Si la réponse contient des résultats de recherche, stockez le premier résultat et imprimez ses détails, comme l’URL d’une miniature, l’URL d’origine, ainsi que le nombre total d’images retournées.

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

Étapes suivantes

Tutoriel d’une application monopage Recherche d’images Bing

Voir aussi

Utilisez ce guide de démarrage rapide pour effectuer votre première recherche d’images à l’aide de la bibliothèque de client Recherche d’images Bing, qui est un wrapper de l’API et contient les mêmes fonctionnalités. Cette application JavaScript simple envoie une requête de recherche d’image, analyse la réponse JSON et affiche l’URL de la première image retournée.

Prérequis

  • La dernière version de Node.js.
  • Le SDK Recherche d’images Bing pour JavaScript
    • Pour l’installer, exécutez npm install @azure/cognitiveservices-imagesearch
  • La classe CognitiveServicesCredentials du package @azure/ms-rest-azure-js pour authentifier le client.
    • Pour l’installer, exécutez npm install @azure/ms-rest-azure-js

Créer et initialiser l’application

  1. Créez un fichier JavaScript dans l’éditeur ou IDE de votre choix et définissez la sévérité, https et autres exigences.

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

  2. Dans la méthode principale de votre projet, créez des variables pour votre clé d’abonnement valide, les résultats d’image devant être retournés par Bing et un terme de recherche. Ensuite, instanciez le client de recherche d’image à l’aide de la clé.

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

Créer une fonction d’assistance asynchrone

  1. Créez une fonction pour appeler le client de façon asynchrone et retournez la réponse du service Recherche d’images Bing.

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

Envoyer une requête et gérer la réponse

  1. Appelez la fonction d’assistance et gérez son élément promise pour analyser les résultats d’image retournés dans la réponse.

    Si la réponse contient des résultats de recherche, stockez le premier résultat et imprimez ses détails, comme l’URL d’une miniature, l’URL d’origine, ainsi que le nombre total d’images retournées.

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

Étapes suivantes

Tutoriel d’une application monopage Recherche d’images Bing

Voir aussi

Utilisez ce guide de démarrage rapide pour effectuer votre première recherche d’images à l’aide de la bibliothèque de client Recherche d’images Bing, qui est un wrapper de l’API et contient les mêmes fonctionnalités. Cette application Python simple envoie une requête de recherche d’image, analyse la réponse JSON et affiche l’URL de la première image retournée.

Prérequis

Créer et initialiser l’application

  1. Créez un script Python dans votre éditeur ou IDE favori, puis les importations suivantes :

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

  2. Créez des variables pour votre clé d’abonnement et votre terme de recherche.

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

Créer le client Recherche d’images

  1. Créez une instance de CognitiveServicesCredentials, puis utilisez-la pour instancier le client :

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

  2. Envoyez une requête de recherche à l’API Recherche d’images Bing :

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

Traiter et afficher les résultats

Analysez les résultats d’image retournés par la réponse.

Si la réponse contient des résultats de recherche, stockez le premier résultat et imprimez ses détails, comme l’URL d’une miniature, l’URL d’origine, ainsi que le nombre total d’images retournées.

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

Étapes suivantes

Tutoriel d’une application monopage Recherche d’images Bing

Voir aussi