Szybki start: korzystanie z biblioteki klienta wyszukiwania obrazów Bing
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
- Jeśli używasz systemu Windows, dowolna wersja programu Visual Studio 2017 lub nowszego
- Jeśli używasz systemu macOS lub Linux, program VS Code z zainstalowanym programem .NET Core
- Bezpłatna subskrypcja platformy Azure
Zobacz również cennik usług Azure AI — interfejs API Wyszukiwanie Bing.
Tworzenie projektu konsoli
Najpierw utwórz nową aplikację konsolową języka C#.
Utwórz nowe rozwiązanie konsoli o nazwie BingImageSearch w programie Visual Studio.
Dodawanie pakietu NuGet wyszukiwania obrazów poznawczych
- Kliknij prawym przyciskiem myszy projekt w Eksplorator rozwiązań.
- Wybierz pozycję Zarządzaj pakietami NuGet.
- Wyszukaj i wybierz pozycję Microsoft.Azure.CognitiveServices.Search.ImageSearch, a następnie zainstaluj pakiet.
Inicjowanie aplikacji
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;
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
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
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;
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
Za pomocą metody
bingImages().search()
wyślij żądanie HTTP zawierające zapytanie wyszukiwania. Zapisz odpowiedź jakoImagesModel
.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
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
- Aby go zainstalować, uruchom polecenie
- Klasa
CognitiveServicesCredentials
z@azure/ms-rest-azure-js
pakietu do uwierzytelniania klienta.- Aby go zainstalować, uruchom polecenie
npm install @azure/ms-rest-azure-js
- Aby go zainstalować, uruchom polecenie
Tworzenie i inicjowanie aplikacji
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;
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
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
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
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
Biblioteka klienta usługi Azure Image Search dla języka Python
- Zainstaluj przy użyciu polecenia
pip install azure-cognitiveservices-search-imagesearch
- Zainstaluj przy użyciu polecenia
Tworzenie i inicjowanie aplikacji
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
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
Utwórz wystąpienie klasy
CognitiveServicesCredentials
i użyj go do utworzenia wystąpienia klienta:client = ImageSearchClient(endpoint=subscription_endpoint, credentials=CognitiveServicesCredentials(subscription_key))
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!")