Szybki start: korzystanie z biblioteki klienta wyszukiwania obrazów Bing

  • Artykuł

Ostrzeżenie

30 października 2020 r. interfejsy API Wyszukiwanie Bing zostały przeniesione z usług Azure AI do usług Wyszukiwanie Bing Services. Ta dokumentacja jest dostarczana tylko do celów referencyjnych. Aby uzyskać zaktualizowaną dokumentację, zobacz dokumentację interfejsu API wyszukiwania Bing. Aby uzyskać instrukcje dotyczące tworzenia nowych zasobów platformy Azure na potrzeby wyszukiwania Bing, zobacz Tworzenie zasobu Wyszukiwanie Bing za pomocą Azure Marketplace.

Użyj tego przewodnika Szybki start, aby wykonać pierwsze wyszukiwanie obrazów przy użyciu biblioteki klienta wyszukiwania obrazów Bing.

Biblioteka wyszukiwania klienta jest otoką interfejsu API REST i zawiera te same funkcje.

Utworzysz aplikację języka C#, która wysyła zapytanie wyszukiwania obrazów, analizuje odpowiedź JSON i wyświetla adres URL pierwszego zwróconego obrazu.

Wymagania wstępne

Zobacz również cennik usług Azure AI — interfejs API Wyszukiwanie Bing.

Tworzenie projektu konsoli

Najpierw utwórz nową aplikację konsolową języka C#.

  1. Utwórz nowe rozwiązanie konsoli o nazwie BingImageSearch w programie Visual Studio.

  2. Dodawanie pakietu NuGet wyszukiwania obrazów poznawczych

    1. Kliknij prawym przyciskiem myszy projekt w Eksplorator rozwiązań.
    2. Wybierz pozycję Zarządzaj pakietami NuGet.
    3. Wyszukaj i wybierz pozycję Microsoft.Azure.CognitiveServices.Search.ImageSearch, a następnie zainstaluj pakiet.

Inicjowanie aplikacji

  1. Zastąp wszystkie using instrukcje w pliku Program.cs następującym kodem:

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

  2. Main W metodzie projektu utwórz zmienne dla prawidłowego klucza subskrypcji, wyniki obrazu, które mają zostać zwrócone przez usługę Bing i termin wyszukiwania. Następnie utwórz wystąpienie klienta wyszukiwania obrazów za pomocą klucza.

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

Wysyłanie zapytania wyszukiwania przy użyciu klienta

Nadal w metodzie Main użyj klienta, aby wyszukać tekst zapytania:

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

Analizowanie i wyświetlanie wyniku pierwszego obrazu

Analizuj wyniki obrazów zwróconych w odpowiedzi.

Jeśli odpowiedź zawiera wyniki wyszukiwania, zapisz pierwszy wynik i wyświetl niektóre z jego szczegółów.

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

Następne kroki

Samouczek dotyczący jednostronicowej aplikacji wyszukiwania obrazów Bing

Zobacz też

Użyj tego przewodnika Szybki start, aby utworzyć pierwsze wyszukiwanie obrazów przy użyciu biblioteki klienta wyszukiwania obrazów Bing, która jest otoką interfejsu API i zawiera te same funkcje. Ta prosta aplikacja w języku Java wysyła zapytanie dotyczące wyszukania obrazu, analizuje odpowiedź w formacie JSON i wyświetla adres URL pierwszego zwróconego obrazu.

Wymagania wstępne

Najnowsza wersja zestawu Java Development Kit (JDK)

Zainstaluj zależności biblioteki klienta wyszukiwania obrazów Bing przy użyciu programu Maven, Gradle lub innego systemu zarządzania zależnościami. Plik POM systemu Maven wymaga następującej deklaracji:

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

Tworzenie i inicjowanie aplikacji

  1. Utwórz nowy projekt w języku Java w ulubionym środowisku IDE lub edytorze i dodaj następujące instrukcje import do implementacji klasy:

    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. W metodzie main utwórz zmienne dla klucza subskrypcji i szukanego terminu. Następnie utwórz wystąpienie klienta wyszukiwania obrazów Bing.

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

Wysyłanie żądania wyszukiwania do interfejsu API

  1. Za pomocą metody bingImages().search() wyślij żądanie HTTP zawierające zapytanie wyszukiwania. Zapisz odpowiedź jako ImagesModel.

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

Analiza i wyświetlanie wyników

Analizuj wyniki obrazów zwróconych w odpowiedzi. Jeśli odpowiedź zawiera wyniki wyszukiwania, zapisz pierwszy wynik i wyświetl jego szczegóły, takie jak adres URL miniatury i oryginalny adres URL, wraz z całkowitą liczbą zwróconych obrazów.

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

Następne kroki

Samouczek dotyczący jednostronicowej aplikacji wyszukiwania obrazów Bing

Zobacz też

Użyj tego przewodnika Szybki start, aby utworzyć pierwsze wyszukiwanie obrazów przy użyciu biblioteki klienta wyszukiwania obrazów Bing, która jest otoką interfejsu API i zawiera te same funkcje. Ta prosta aplikacja JavaScript wysyła zapytanie dotyczące wyszukania obrazu, analizuje odpowiedź w formacie JSON i wyświetla adres URL pierwszego zwróconego obrazu.

Wymagania wstępne

  • Najnowsza wersja środowiska Node.js.
  • Zestaw SDK wyszukiwania obrazów Bing dla języka JavaScript
    • Aby go zainstalować, uruchom polecenie npm install @azure/cognitiveservices-imagesearch
  • Klasa CognitiveServicesCredentials z @azure/ms-rest-azure-js pakietu do uwierzytelniania klienta.
    • Aby go zainstalować, uruchom polecenie npm install @azure/ms-rest-azure-js

Tworzenie i inicjowanie aplikacji

  1. Utwórz nowy plik JavaScript w swoim ulubionym środowisku IDE lub edytorze i ustaw poziom ścisłości, protokół HTTPS oraz inne wymagania.

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

  2. W metodzie głównej projektu utwórz zmienne dla swojego ważnego klucza subskrypcji, wyników obrazów do zwrócenia przez usługę Bing i terminu wyszukiwania. Następnie utwórz wystąpienie klienta wyszukiwania obrazów za pomocą klucza.

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

Tworzenie asynchronicznej funkcji pomocnika

  1. Utwórz funkcję do asynchronicznego wywołania klienta, a następnie zwróć odpowiedź z usługi wyszukiwania obrazów Bing.

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

Wysyłanie zapytania i obsługa odpowiedzi

  1. Wywołaj funkcję pomocnika i obsłuż jej element promise, aby przeanalizować wyniki obrazów zwrócone w odpowiedzi.

    Jeśli odpowiedź zawiera wyniki wyszukiwania, zapisz pierwszy wynik i wyświetl jego szczegóły, takie jak adres URL miniatury i oryginalny adres URL, wraz z całkowitą liczbą zwróconych obrazów.

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

Następne kroki

Samouczek dotyczący jednostronicowej aplikacji wyszukiwania obrazów Bing

Zobacz też

Użyj tego przewodnika Szybki start, aby utworzyć pierwsze wyszukiwanie obrazów przy użyciu biblioteki klienta wyszukiwania obrazów Bing, która jest otoką interfejsu API i zawiera te same funkcje. Ta prosta aplikacja w języku Python wysyła zapytanie dotyczące wyszukania obrazu, analizuje odpowiedź w formacie JSON i wyświetla adres URL pierwszego zwróconego obrazu.

Wymagania wstępne

Tworzenie i inicjowanie aplikacji

  1. Utwórz nowy skrypt w języku Python w ulubionym środowisku IDE lub edytorze z następującymi instrukcjami importu:

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

  2. Utwórz zmienne dla klucza subskrypcji i szukanego terminu.

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

Tworzenie klienta wyszukiwania obrazów

  1. Utwórz wystąpienie klasy CognitiveServicesCredentials i użyj go do utworzenia wystąpienia klienta:

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

  2. Wyślij zapytanie wyszukiwania do interfejsu API wyszukiwania obrazów Bing:

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

Przetwarzanie i wyświetlanie wyników

Analizuj wyniki obrazów zwróconych w odpowiedzi.

Jeśli odpowiedź zawiera wyniki wyszukiwania, zapisz pierwszy wynik i wyświetl jego szczegóły, takie jak adres URL miniatury i oryginalny adres URL, wraz z całkowitą liczbą zwróconych obrazów.

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

Następne kroki

Samouczek dotyczący jednostronicowej aplikacji wyszukiwania obrazów Bing

Zobacz też