Rychlý start: Použití klientské knihovny Vyhledávání obrázků Bingu

  • Článek

Upozornění

30. října 2020 se rozhraní API Vyhledávání Bingu přesunula ze služeb Azure AI na Vyhledávání Bingu Services. Tato dokumentace je k dispozici pouze pro referenci. Aktualizovanou dokumentaci najdete v dokumentaci k rozhraní API Bingu pro vyhledávání. Pokyny k vytváření nových prostředků Azure pro vyhledávání Bingu najdete v tématu Vytvoření prostředku Vyhledávání Bingu prostřednictvím Azure Marketplace.

Pomocí tohoto rychlého startu provedete první hledání obrázků pomocí klientské knihovny Bingu pro vyhledávání obrázků.

Knihovna klientského vyhledávání je obálka pro rozhraní REST API a obsahuje stejné funkce.

Vytvoříte aplikaci c# odešle dotaz pro vyhledávání obrázků, parsuje odpověď JSON a zobrazí adresu URL prvního vráceného obrázku.

Požadavky

Projděte si také ceny služeb Azure AI – Vyhledávání Bingu API.

Vytvoření projektu konzoly

Nejprve vytvořte novou konzolovou aplikaci jazyka C#.

  1. V sadě Visual Studio vytvořte nové řešení konzoly s názvem BingImageSearch .

  2. Přidání balíčku NuGet služby Cognitive Image Search

    1. Klikněte pravým tlačítkem na projekt v Průzkumník řešení.
    2. Vyberte Spravovat balíčky NuGet.
    3. Vyhledejte a vyberte Microsoft.Azure.CognitiveServices.Search.ImageSearch a pak balíček nainstalujte.

Inicializace aplikace

  1. Nahraďte všechny using příkazy v souboru Program.cs následujícím kódem:

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

  2. Main V metodě projektu vytvořte proměnné pro platný klíč předplatného, výsledky obrázků, které má Bing vrátit, a hledaný termín. Potom pomocí daného klíče vytvořte instanci klienta vyhledávání obrázků.

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

Odeslání vyhledávacího dotazu pomocí klienta

Stále v Main metodě použijte klienta k vyhledávání s textem dotazu:

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

Parsování a zobrazení výsledku s prvním obrázkem

Parsujte výsledky obrázků vrácené v odpovědi.

Pokud odpověď obsahuje výsledky hledání, uložte první výsledek a vytiskněte některé jeho podrobnosti.

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

Další kroky

Vyhledávání obrázků Bingu – kurz jednostránkové aplikace

Viz také

Pomocí tohoto rychlého startu provedete první hledání obrázků pomocí klientské knihovny Vyhledávání obrázků Bingu, která je obálkou rozhraní API a obsahuje stejné funkce. Tato jednoduchá aplikace Javy posílá dotaz pro vyhledání obrázku, parsuje odpověď JSON a zobrazuje adresu URL prvního nalezeného obrázku.

Požadavky

Nejnovější verze sady Java Development Kit (JDK)

Nainstalujte závislosti klientské knihovny Vyhledávání obrázků Bingu pomocí Mavenu, Gradle nebo jiného systému pro správu závislostí. Soubor POM Mavenu vyžaduje následující deklaraci:

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

Vytvoření a inicializace aplikace

  1. Ve svém oblíbeném integrovaném vývojovém prostředí nebo editoru vytvořte nový projekt Java a do implementace třídy přidejte následující importy:

    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. V hlavní metodě vytvořte proměnné pro klíč předplatného a hledaný výraz. Potom vytvořte instanci klienta vyhledávání obrázků Bingu.

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

Odeslání požadavku hledání do rozhraní API

  1. Pomocí bingImages().search() odešlete požadavek HTTP obsahující vyhledávací dotaz. Uložte odpověď jako ImagesModel.

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

Parsování a zobrazení výsledku

Parsujte výsledky obrázků vrácené v odpovědi. Pokud odpověď obsahuje výsledky hledání, uložte první výsledek a vytiskněte jeho podrobnosti, jako je adresa URL miniatury, původní adresa URL a celkový počet vrácených obrázků.

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

Další kroky

Vyhledávání obrázků Bingu – kurz jednostránkové aplikace

Viz také

Pomocí tohoto rychlého startu provedete první hledání obrázků pomocí klientské knihovny Vyhledávání obrázků Bingu, která je obálkou rozhraní API a obsahuje stejné funkce. Tato jednoduchá aplikace JavaScript posílá dotaz pro vyhledání obrázku, parsuje odpověď JSON a zobrazuje adresu URL prvního nalezeného obrázku.

Požadavky

  • Nejnovější verze Node.js
  • Sada SDK Bingu pro vyhledávání obrázků pro JavaScript
    • Instalaci provedete spuštěním příkazu . npm install @azure/cognitiveservices-imagesearch
  • Třída CognitiveServicesCredentials z @azure/ms-rest-azure-js balíčku k ověření klienta.
    • Instalaci provedete spuštěním příkazu . npm install @azure/ms-rest-azure-js

Vytvoření a inicializace aplikace

  1. Vytvořte ve svém oblíbeném prostředí IDE nebo editoru nový soubor JavaScript a nastavte přísnost, protokol HTTPS a další požadavky.

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

  2. V metodě main vašeho projektu vytvořte proměnné pro váš platný klíč předplatného, výsledky obrázků, které má vrátit Bing, a hledaný výraz. Potom pomocí daného klíče vytvořte instanci klienta vyhledávání obrázků.

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

Vytvoření asynchronní pomocné funkce

  1. Vytvořte funkci, která asynchronně zavolá klienta a vrátí odpověď ze služby Vyhledávání obrázků Bingu.

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

Odeslání dotazu a zpracování odpovědi

  1. Zavolejte pomocnou funkci a zpracujte její promise, aby se parsovaly výsledky obrázků, které se vrátily v odpovědi.

    Pokud odpověď obsahuje výsledky hledání, uložte první výsledek a vytiskněte jeho podrobnosti, jako je adresa URL miniatury, původní adresa URL a celkový počet vrácených obrázků.

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

Další kroky

Vyhledávání obrázků Bingu – kurz jednostránkové aplikace

Viz také

Pomocí tohoto rychlého startu provedete první hledání obrázků pomocí klientské knihovny Vyhledávání obrázků Bingu, která je obálkou rozhraní API a obsahuje stejné funkce. Tato jednoduchá aplikace Pythonu posílá dotaz pro vyhledání obrázku, parsuje odpověď JSON a zobrazuje adresu URL prvního nalezeného obrázku.

Požadavky

Vytvoření a inicializace aplikace

  1. Ve vašem oblíbeném integrovaném vývojovém prostředí nebo editoru vytvořte nový skript Pythonu a přidejte následující importy:

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

  2. Vytvořte proměnné pro klíč předplatného a hledaný výraz.

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

Vytvoření klienta vyhledávání obrázků

  1. Vytvořte instanci třídy CognitiveServicesCredentials a použijte ji k vytvoření instance klienta:

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

  2. Odešlete vyhledávací dotaz do rozhraní API Bingu pro vyhledávání obrázků:

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

Zpracování a zobrazení výsledků

Parsujte výsledky obrázků vrácené v odpovědi.

Pokud odpověď obsahuje výsledky hledání, uložte první výsledek a vytiskněte jeho podrobnosti, jako je adresa URL miniatury, původní adresa URL a celkový počet vrácených obrázků.

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

Další kroky

Vyhledávání obrázků Bingu – kurz jednostránkové aplikace

Viz také