Aracılığıyla paylaş


Hızlı Başlangıç: Bing Resim Arama istemci kitaplığını kullanma

Uyarı

30 Ekim 2020'de Bing Arama API'leri Azure yapay zeka hizmetlerinden Bing Arama Hizmetlerine taşındı. Bu belgeler yalnızca başvuru için sağlanır. Güncelleştirilmiş belgeler için Bing arama API'sinin belgelerine bakın. Bing araması için yeni Azure kaynakları oluşturma yönergeleri için bkz. Azure Market aracılığıyla Bing Arama kaynağı oluşturma.

Bing Resim Arama istemci kitaplığını kullanarak ilk görüntü aramanızı yapmak için bu hızlı başlangıcı kullanın.

İstemci arama kitaplığı REST API için sarmalayıcıdır ve aynı özellikleri içerir.

Bir C# uygulaması oluşturacaksınız, bir görüntü arama sorgusu gönderir, JSON yanıtını ayrıştıracak ve döndürülen ilk görüntünün URL'sini görüntüler.

Önkoşullar

Ayrıca bkz. Azure AI hizmetleri fiyatlandırması - Bing Arama API.

Konsol projesi oluşturma

İlk olarak yeni bir C# konsol uygulaması oluşturun.

  1. Visual Studio'da BingImageSearch adlı yeni bir konsol çözümü oluşturun.

  2. Bilişsel Görüntü Arama NuGet paketini ekleme

    1. Çözüm Gezgini'da projenize sağ tıklayın.
    2. NuGet Paketlerini Yönet'i seçin.
    3. Microsoft.Azure.CognitiveServices.Search.ImageSearch öğesini arayıp seçin ve paketi yükleyin.

Uygulamayı başlatma

  1. Program.cs dosyasındaki using tüm deyimleri aşağıdaki kodla değiştirin:

    using System;
    using System.Linq;
    using Microsoft.Azure.CognitiveServices.Search.ImageSearch;
    using Microsoft.Azure.CognitiveServices.Search.ImageSearch.Models;
    
  2. Projenizin yönteminde Main geçerli abonelik anahtarınız, Bing tarafından döndürülecek görüntü sonuçları ve bir arama terimi için değişkenler oluşturun. Ardından anahtarı kullanılarak görüntü arama istemcisinin bir örneğini oluşturun.

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

İstemciyi kullanarak bir arama sorgusu gönderme

Yine yönteminde Main , sorgu metniyle arama yapmak için istemcisini kullanın:

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

Birinci görüntü sonucunu ayrıştırma ve görüntüleme

Yanıtta döndürülen resim sonuçlarını ayrıştırın.

Yanıt arama sonuçları içeriyorsa, ilk sonucu depolayın ve ayrıntılarının bazılarını yazdırın.

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

Sonraki adımlar

Ayrıca bkz.

API için sarmalayıcı olan ve aynı özellikleri içeren Bing Resim Arama istemci kitaplığını kullanarak ilk görüntü aramanızı yapmak için bu hızlı başlangıcı kullanın. Bu basit Java uygulaması bir görüntü arama sorgusu gönderir, JSON yanıtını ayrıştırır ve döndürülen ilk görüntünün URL’sini görüntüler.

Önkoşullar

Java Geliştirme Seti’nin (JDK) en son sürümü

Maven, Gradle veya başka bir bağımlılık yönetim sistemi kullanarak Bing Resim Arama istemci kitaplığı bağımlılıklarını yükleyin. Maven POM dosyası şu bildirimi gerektirir:

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

Uygulamayı oluşturma ve başlatma

  1. Sık kullandığınız IDE veya düzenleyicide yeni bir Java projesi oluşturun ve sınıf uygulamanıza aşağıdaki içeri aktarmaları ekleyin:

    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. Ana yönteminizde abonelik anahtarınız ve arama teriminiz için değişkenler oluşturun. Ardından Bing Resim Arama istemcisinin örneğini oluşturun.

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

API'ye arama isteği gönderme

  1. bingImages().search() kullanarak, arama sorgusunu içeren HTTP isteğini gönderin. Yanıtı ImagesModel olarak kaydedin.

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

Sonucu ayrıştırma ve görüntüleme

Yanıtta döndürülen resim sonuçlarını ayrıştırın. Yanıt arama sonuçları içeriyorsa ilk sonucu depolayın ve küçük resim URL'si, özgün URL ve döndürülen toplam görüntü sayısı gibi ayrıntılarını yazdırın.

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

Sonraki adımlar

Ayrıca bkz.

API için sarmalayıcı olan ve aynı özellikleri içeren Bing Resim Arama istemci kitaplığını kullanarak ilk görüntü aramanızı yapmak için bu hızlı başlangıcı kullanın. Bu basit JavaScript uygulaması bir görüntü arama sorgusu gönderir, JSON yanıtını ayrıştırır ve döndürülen ilk görüntünün URL'sini görüntüler.

Önkoşullar

  • Node.js'in en son sürümü.
  • JavaScript için Bing Resim Arama SDK'sı
    • Yüklemek için npm install @azure/cognitiveservices-imagesearch
  • İstemcinin CognitiveServicesCredentials kimliğini doğrulamak için paketten @azure/ms-rest-azure-js sınıfı.
    • Yüklemek için npm install @azure/ms-rest-azure-js

Uygulamayı oluşturma ve başlatma

  1. Sık kullandığınız IDE'de veya düzenleyicide yeni bir JavaScript dosyası oluşturun ve katılık, https ve diğer gereksinimleri ayarlayın.

    'use strict';
    const ImageSearchAPIClient = require('@azure/cognitiveservices-imagesearch');
    const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
    
  2. Projenizin main yönteminde geçerli abonelik anahtarınız, Bing tarafından döndürülecek görüntü sonuçları ve bir arama terimi için değişkenler oluşturun. Ardından anahtarı kullanılarak görüntü arama istemcisinin bir örneğini oluşturun.

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

Zaman uyumsuz yardımcı işlev oluşturma

  1. İstemciyi zaman uyumsuz olarak çağırmak için bir işlev oluşturun ve Bing Görüntü Arama hizmetinin yanıtını döndürün.

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

Sorgu göndermek ve yanıtı işlemek

  1. Yardımcı işlevi çağırın ve yanıtta döndürülen görüntü sonuçlarını ayrıştırmak için promise değerini işleyin.

    Yanıt arama sonuçları içeriyorsa ilk sonucu depolayın ve küçük resim URL'si, özgün URL ve döndürülen toplam görüntü sayısı gibi ayrıntılarını yazdırın.

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

Sonraki adımlar

Ayrıca bkz.

API için sarmalayıcı olan ve aynı özellikleri içeren Bing Resim Arama istemci kitaplığını kullanarak ilk görüntü aramanızı yapmak için bu hızlı başlangıcı kullanın. Bu basit Python uygulaması, bir görüntü arama sorgusu gönderir, JSON yanıtını ayrıştırır ve döndürülen ilk görüntünün URL’sini görüntüler.

Önkoşullar

Uygulamayı oluşturma ve başlatma

  1. Sık kullandığınız IDE ortamında veya düzenleyicide yeni bir Python betiği ve aşağıdaki içeri aktarımları oluşturun:

    from azure.cognitiveservices.search.imagesearch import ImageSearchClient
    from msrest.authentication import CognitiveServicesCredentials
    
  2. Abonelik anahtarınız ve arama teriminiz için değişkenler oluşturun.

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

Görüntü arama istemcisi oluşturma

  1. CognitiveServicesCredentials örneği oluşturun ve istemcinin bir örneğini başlatmak için bunu kullanın:

    client = ImageSearchClient(endpoint=subscription_endpoint, credentials=CognitiveServicesCredentials(subscription_key))
    
  2. Bing Resim Arama API’sine arama sorgusu gönderme:

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

Sonuçları işleme ve görüntüleme

Yanıtta döndürülen resim sonuçlarını ayrıştırın.

Yanıt arama sonuçları içeriyorsa ilk sonucu depolayın ve küçük resim URL'si, özgün URL ve döndürülen toplam görüntü sayısı gibi ayrıntılarını yazdırın.

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

Sonraki adımlar

Ayrıca bkz.