Freigeben über

Schnellstart: Verwenden der Clientbibliothek für die Bing-Bildersuche

  • Artikel

Warnung

Am 30. Oktober 2020 wurden die Bing-Suche-APIs aus den Azure KI Services in die Bing-Suchdienste verschoben. Diese Dokumentation wird nur zu Referenzzwecken bereitgestellt. Eine aktualisierte Dokumentation finden Sie in der Dokumentation zu den Bing-Suche-APIs. Anweisungen zum Erstellen neuer Azure-Ressourcen für die Bing-Suche finden Sie unter Erstellen einer Ressource für die Bing-Suche über Azure Marketplace.

Führen Sie mithilfe dieses Schnellstarts Ihre erste Bildersuche mit der Bing-Bildersuche-Clientbibliothek aus.

Die Clientsuchbibliothek ist ein Wrapper für die REST-API und enthält die gleichen Funktionen.

Sie erstellen eine C#-Anwendung, die eine Bildersuchabfrage sendet, die JSON-Antwort analysiert und die URL des ersten zurückgegebenen Bilds anzeigt.

Voraussetzungen

Siehe auch Bing-Suche – Preise.

Erstellen eines Konsolenprojekts

Erstellen Sie zunächst eine neue C#-Konsolenanwendung.

  1. Erstellen Sie in Visual Studio eine neue Konsolenprojektmappe mit dem Namen BingImageSearch.

  2. Fügen Sie das NuGet-Paket für die Cognitive Services-Bildersuche hinzu.

    1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt.
    2. Wählen Sie NuGet-Pakete verwalten aus.
    3. Suchen Sie nach Microsoft.Azure.CognitiveServices.Search.ImageSearch, wählen Sie das Paket aus, und installieren Sie es.

Initialisieren der Anwendung

  1. Ersetzen Sie alle using-Anweisungen in Program.cs durch folgenden Code:

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

  2. Erstellen Sie in der Main-Methode Ihres Projekts Variablen für Ihren gültigen Abonnementschlüssel, die von Bing zurückzugebenden Bildergebnisse und einen Suchbegriff. Instanziieren Sie dann den Client für die Bildersuche mit dem Schlüssel.

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

Senden einer Suchabfrage mit dem Client

Verwenden Sie in der Main-Methode den Client, um mit einem Abfragetext eine Suche durchzuführen:

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

Analysieren und Anzeigen des ersten Bildergebnisses

Analysieren Sie die Bildergebnisse, die in der Antwort zurückgegeben werden.

Wenn die Antwort Suchergebnisse enthält, speichern Sie das erste Ergebnis, und geben Sie einige Details aus:

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

Nächste Schritte

Tutorial: Einseitige Web-App für die Bing-Bildersuche

Weitere Informationen

Führen Sie mithilfe dieses Schnellstarts Ihre erste Bildersuche mit der Bing-Bildersuche-Clientbibliothek aus, die ein Wrapper für die API ist und die gleichen Funktionen enthält. Diese einfache Java-Anwendung sendet eine Bildersuchabfrage, analysiert die JSON-Antwort und zeigt die URL des ersten zurückgegebenen Bilds an.

Voraussetzungen

Sie benötigen die aktuelle Version des Java Development Kits (JDK).

Installieren Sie die Abhängigkeit für die Bing-Bildersuche-Clientbibliothek mithilfe von Maven, Gradle oder anderen Systemen zum Verwalten von Abhängigkeiten. Die Maven-POM-Datei erfordert die folgende Deklaration:

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

Erstellen und Initialisieren der Anwendung

  1. Erstellen Sie in Ihrer bevorzugten IDE bzw. in einem Editor ein neues Java-Projekt, und fügen Sie Ihrer Klassenimplementierung die folgenden Importe hinzu:

    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. Erstellen Sie in Ihrer Main-Methode Variablen für Ihren Abonnementschlüssel und einen Suchbegriff. Instanziieren Sie dann den Bing-Bildersuche-Client.

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

Senden einer Suchanforderung an die API

  1. Senden Sie mithilfe von bingImages().search() die HTTP-Anforderung, die die Suchabfrage enthält. Speichern Sie die Antwort als ImagesModel-Objekt.

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

Analysieren und Anzeigen von Ergebnissen

Analysieren Sie die Bildergebnisse, die in der Antwort zurückgegeben werden. Wenn die Antwort Suchergebnisse enthält, speichern Sie das erste Ergebnis, und drucken Sie die Details aus, z. B. eine Miniaturansichts-URL, die ursprüngliche URL und die Gesamtzahl zurückgegebener Bilder.

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

Nächste Schritte

Tutorial: Einseitige Web-App für die Bing-Bildersuche

Weitere Informationen

Führen Sie mithilfe dieses Schnellstarts Ihre erste Bildersuche mit der Bing-Bildersuche-Clientbibliothek aus, die ein Wrapper für die API ist und die gleichen Funktionen enthält. Diese einfache JavaScript-Anwendung sendet ein Bildsuchabfrage, analysiert die JSON-Antwort und zeigt die URL des ersten zurückgegebenen Bilds an.

Voraussetzungen

  • Die aktuelle Version von Node.js
  • Das Bing Bildsuche-SDK für JavaScript
    • Führen Sie zum Installieren npm install @azure/cognitiveservices-imagesearch aus.
  • Die CognitiveServicesCredentials-Klasse aus dem Paket @azure/ms-rest-azure-js zum Authentifizieren des Clients.
    • Führen Sie zum Installieren npm install @azure/ms-rest-azure-js aus.

Erstellen und Initialisieren der Anwendung

  1. Erstellen Sie eine neue JavaScript-Datei in Ihrer bevorzugten IDE oder Ihrem bevorzugten Editor, und stellen Sie die Genauigkeit, https und andere Anforderungen ein.

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

  2. Erstellen Sie in der Main-Methode Ihres Projekts Variablen für Ihren gültigen Abonnementschlüssel, die von Bing zurückzugebenden Bildergebnisse und einen Suchbegriff. Instanziieren Sie dann den Client für die Bildersuche mit dem Schlüssel.

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

Erstellen einer asynchronen Hilfsfunktion

  1. Erstellen Sie eine Funktion, um den Client asynchron aufzurufen und die Antwort vom Bing-Bildersuchdienst zurückzugeben.

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

Senden einer Abfrage und Verarbeiten der Antwort

  1. Rufen Sie die Hilfsfunktion auf und verwenden Sie promise, um die in der Antwort zurückgegebenen Bildergebnisse zu analysieren.

    Wenn die Antwort Suchergebnisse enthält, speichern Sie das erste Ergebnis, und drucken Sie die Details aus, z. B. eine Miniaturansichts-URL, die ursprüngliche URL und die Gesamtzahl zurückgegebener Bilder.

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

Nächste Schritte

Tutorial: Einseitige Web-App für die Bing-Bildersuche

Weitere Informationen

Führen Sie mithilfe dieses Schnellstarts Ihre erste Bildersuche mit der Bing-Bildersuche-Clientbibliothek aus, die ein Wrapper für die API ist und die gleichen Funktionen enthält. Diese einfache Python-Anwendung sendet eine Bildersuchabfrage, analysiert die JSON-Antwort und zeigt die URL des ersten zurückgegebenen Bilds an.

Voraussetzungen

Erstellen und Initialisieren der Anwendung

  1. Erstellen Sie in Ihrer bevorzugten IDE bzw. in einem Editor ein neues Python-Skript und die folgenden Importe:

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

  2. Erstellen Sie Variablen für Ihren Abonnementschlüssel und einen Suchbegriff.

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

Erstellen eines Clients für die Bildersuche

  1. Erstellen Sie eine CognitiveServicesCredentials-Instanz, und instanziieren Sie damit den Client:

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

  2. Senden Sie eine Suchabfrage an die Bing-Bildersuche-API:

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

Lassen Sie die Ergebnisse verarbeiten und anzeigen.

Analysieren Sie die Bildergebnisse, die in der Antwort zurückgegeben werden.

Wenn die Antwort Suchergebnisse enthält, speichern Sie das erste Ergebnis, und drucken Sie die Details aus, z. B. eine Miniaturansichts-URL, die ursprüngliche URL und die Gesamtzahl zurückgegebener Bilder.

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

Nächste Schritte

Tutorial: Einseitige Web-App für die Bing-Bildersuche

Weitere Informationen