Dela via

Snabbstart: Använda klientbiblioteket för bildsökning i Bing

  • Artikel

Varning

Den 30 oktober 2020 flyttade Bing-sökning API:er från Azure AI-tjänster till Bing-sökning Services. Den här dokumentationen tillhandahålls endast som referens. Uppdaterad dokumentation finns i dokumentationen för API:et för Bing-sökning. Anvisningar om hur du skapar nya Azure-resurser för Bing-sökning finns i Skapa en Bing-sökning resurs via Azure Marketplace.

Använd den här snabbstarten för att göra din första bildsökning med hjälp av klientbiblioteket för bildsökning i Bing.

Klientsökningsbiblioteket är en omslutning för REST-API:et och innehåller samma funktioner.

Du skapar ett C#-program som skickar en bildsökningsfråga, parsar JSON-svaret och visar URL:en för den första bilden som returneras.

Förutsättningar

Se även prissättning för Azure AI-tjänster – Bing-sökning API.

Skapa ett konsolprojekt

Skapa först ett nytt C#-konsolprogram.

  1. Skapa en ny konsollösning med namnet BingImageSearch i Visual Studio.

  2. Lägg till NuGet-paketet för Cognitive Image Search

    1. Högerklicka på projektet i Solution Explorer.
    2. Välj Hantera NuGet-paket.
    3. Sök efter och välj Microsoft.Azure.CognitiveServices.Search.ImageSearch och installera sedan paketet.

Initiera programmet

  1. Ersätt alla using instruktioner i Program.cs med följande kod:

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

  2. Main I metoden för projektet skapar du variabler för din giltiga prenumerationsnyckel, bildresultatet som ska returneras av Bing och en sökterm. Sedan skapa en instans av bildsökningsklienten med hjälp av nyckeln.

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

Skicka en sökfråga med hjälp av klienten

Main Använd fortfarande -klienten för att söka med en frågetext:

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

Parsa och visa det första avbildningresultatet

Parsa bild resultatet som returneras i svaret.

Om svaret innehåller sökresultat lagrar du det första resultatet och skriver ut en del av dess information.

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ästa steg

Självstudie om enkel app för bildsökning i Bing

Se även

Använd den här snabbstarten för att göra din första bildsökning med klientbiblioteket för bildsökning i Bing, som är en omslutning för API:et och innehåller samma funktioner. Den här enkla Java-appen skickar en bildsökningsfråga, parsar JSON-svaret och visar webbadressen till den första bild som returneras.

Förutsättningar

Den senaste versionen av Java Development Kit (JDK)

Installera klientbiblioteksberoenden för bildsökning i Bing med hjälp av Maven, Gradle eller något annat beroendehanteringssystem. Maven POM-filen kräver följande deklaration:

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

Skapa och initiera appen

  1. Skapa ett nytt Java-projekt i valfri IDE eller valfritt redigeringsprogram och lägg till följande importer i din klassimplementering:

    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. Skapa variabler i huvudmetoden för din prenumerationsnyckel och sökvillkor. Sedan skapa en instans av bildsökningsklienten i Bing.

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

Skicka en sökbegäran till API:et

  1. Med hjälp av bingImages().search(), skicka en HTTP-begäran som innehåller sökfrågan. Spara svaret som en ImagesModel.

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

Parsa och visa resultatet

Parsa bild resultatet som returneras i svaret. Om svaret innehåller sökresultat ska du lagra och skriva ut information om det första resultatet, såsom en webbadress till miniatyrbilden, en webbadress till originalet samt det totala antalet returnerade 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ästa steg

Självstudie om enkel app för bildsökning i Bing

Se även

Använd den här snabbstarten för att göra din första bildsökning med klientbiblioteket för bildsökning i Bing, som är en omslutning för API:et och innehåller samma funktioner. Den här enkla JavaScript-appen skickar en bildsökningsfråga, parsar JSON-svaret och visar webbadressen till den första bild som returneras.

Förutsättningar

  • Den senaste versionen av Node.js.
  • SDK för bildsökning i Bing för JavaScript
    • Installera genom att köra npm install @azure/cognitiveservices-imagesearch
  • Klassen CognitiveServicesCredentials från @azure/ms-rest-azure-js paketet för att autentisera klienten.
    • Installera genom att köra npm install @azure/ms-rest-azure-js

Skapa och initiera appen

  1. Skapa en ny JavaScript-fil i den IDE eller redigerare du föredrar och ange skyddstyp, https och andra krav.

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

  2. Skapa variabler för en giltig prenumerationsnyckel, bildresultatet som ska returneras av Bing och en sökterm i main-metoden i projektet. Sedan skapa en instans av bildsökningsklienten med hjälp av nyckeln.

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

Skapa en asynkron hjälpfunktion

  1. Skapa en funktion som anropar klienten asynkront och returnerar svaret från tjänsten Bildsökning i Bing.

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

Skicka en fråga och hantera svaret

  1. Anropa hjälpfunktionen och hantera dess promise så att det returnerade bildresultatet parsas.

    Om svaret innehåller sökresultat ska du lagra och skriva ut information om det första resultatet, såsom en webbadress till miniatyrbilden, en webbadress till originalet samt det totala antalet returnerade 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ästa steg

Självstudie om enkel app för bildsökning i Bing

Se även

Använd den här snabbstarten för att göra din första bildsökning med klientbiblioteket för bildsökning i Bing, som är en omslutning för API:et och innehåller samma funktioner. Den här enkla Python-appen skickar en bildsökningsfråga, parsar JSON-svaret och visar webbadressen till den första bild som returneras.

Förutsättningar

Skapa och initiera appen

  1. Skapa ett nytt Python-skript i valfri IDE eller redigeringsprogram och importera följande:

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

  2. Skapa variabler för din prenumerationsnyckel och sökvillkor.

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

Skapa bildsökningsklient

  1. Skapa en instans av CognitiveServicesCredentials och skapa en instans av klienten:

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

  2. Skicka en sökbegäran till API:et för bildsökning i Bing:

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

Bearbeta och visa svaren

Parsa bild resultatet som returneras i svaret.

Om svaret innehåller sökresultat ska du lagra och skriva ut information om det första resultatet, såsom en webbadress till miniatyrbilden, en webbadress till originalet samt det totala antalet returnerade 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ästa steg

Självstudie om enkel app för bildsökning i Bing

Se även