Bagikan melalui

Mulai cepat: Menggunakan pustaka klien Bing Image Search

  • Artikel

Peringatan

Pada 30 Oktober 2020, API Bing Search dipindahkan dari layanan Azure AI ke layanan Bing Search. Dokumentasi ini disediakan hanya untuk referensi. Untuk dokumentasi terbaru, lihat dokumentasi Bing Search API. Untuk petunjuk tentang cara membuat sumber daya Azure baru untuk pencarian Bing, lihat Membuat sumber daya Pencarian Bing melalui Marketplace Azure.

Gunakan mulai cepat ini untuk membuat pencarian gambar pertama Anda menggunakan pustaka klien Bing Image Search.

Pustaka pencarian klien adalah pembungkus untuk REST API dan berisi fitur yang sama.

Anda akan membuat aplikasi C# mengirimkan kueri pencarian gambar, menguraikan respons JSON, dan menampilkan URL gambar pertama yang ditampilkan.

Prasyarat

Lihat juga harga layanan Azure AI - Bing Search API.

Membuat proyek konsol

Pertama, buat aplikasi konsol C# baru.

  1. Buat solusi konsol baru bernama BingImageSearch di Visual Studio.

  2. Tambahkan paket Cognitive Image Search NuGet

    1. Klik kanan proyek Anda di Penjelajah Solusi.
    2. Pilih Kelola Paket NuGet.
    3. Cari dan pilih Microsoft.Azure.CognitiveServices.Search.ImageSearch, lalu instal paket tersebut.

Menginisialisasi aplikasi

  1. Ganti semua pernyataan using di Program.cs dengan kode berikut:

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

  2. Dalam metode Main proyek Anda, buat variabel untuk kunci langganan Anda yang valid, hasil gambar yang akan ditampilkan oleh Bing, dan istilah pencarian. Kemudian, buat klien pencarian gambar menggunakan kunci.

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

Mengirim kueri pencarian menggunakan klien

Masih dalam Main metode, gunakan klien untuk mencari dengan teks kueri:

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

Mengurai dan menampilkan hasil gambar pertama

Mengurai hasil gambar yang ditampilkan dalam respons.

Jika respons berisi hasil pencarian, simpan hasil pertama dan cetak beberapa detailnya.

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

Langkah berikutnya

Tutorial aplikasi satu halaman Bing Image Search

Lihat juga

Gunakan mulai cepat ini untuk membuat pencarian gambar pertama Anda menggunakan library klien Bing Image Search, yang merupakan wrapper API dan berisi fitur yang sama. Aplikasi Java sederhana ini mengirimkan kueri pencarian gambar, menguraikan respons JSON, dan menampilkan URL gambar pertama yang ditampilkan.

Prasyarat

Versi terbaru Java Development Kit (JDK)

Instal dependensi pustaka klien Bing Image Search dengan menggunakan Maven, Gradle, atau sistem manajemen dependensi lainnya. File POM Maven memerlukan deklarasi berikut:

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

Membuat dan menginisialisasi aplikasi

  1. Buat proyek Java baru di IDE atau editor favorit Anda, dan tambahkan impor berikut ke penerapan kelas Anda:

    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. Dalam metode utama Anda, buat variabel untuk kunci langganan Anda, dan cari istilah. Kemudian, buat instans klien Bing Image Search.

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

Mengirim permintaan pencarian ke API

  1. Dengan menggunakan bingImages().search(), kirim permintaan HTTP yang berisi kueri pencarian. Simpan respons sebagai ImagesModel.

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

Mengurai dan menampilkan hasilnya

Mengurai hasil gambar yang ditampilkan dalam respons. Jika respons berisi hasil pencarian, simpan hasil pertama dan cetak detailnya, seperti URL gambar mini, URL asli, bersama dengan jumlah total gambar yang ditampilkan.

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

Langkah berikutnya

Tutorial aplikasi satu halaman Bing Image Search

Lihat juga

Gunakan mulai cepat ini untuk membuat pencarian gambar pertama Anda menggunakan library klien Bing Image Search, yang merupakan wrapper API dan berisi fitur yang sama. Aplikasi JavaScript sederhana ini mengirimkan kueri pencarian gambar, menguraikan respons JSON, dan menampilkan URL gambar pertama yang ditampilkan.

Prasyarat

  • Versi terbaru Node.js.
  • Bing Image Search SDK untuk JavaScript
    • Untuk menginstal, jalankan npm install @azure/cognitiveservices-imagesearch
  • Kelas CognitiveServicesCredentials dari paket @azure/ms-rest-azure-js untuk mengautentikasi klien.
    • Untuk menginstal, jalankan npm install @azure/ms-rest-azure-js

Membuat dan menginisialisasi aplikasi

  1. Buat file JavaScript baru di IDE atau editor favorit Anda, dan atur ketebalan, https, dan persyaratan lainnya.

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

  2. Dalam metode utama proyek Anda, buat variabel untuk kunci langganan Anda yang valid, hasil gambar yang akan ditampilkan oleh Bing, dan istilah pencarian. Kemudian, buat instans klien pencarian gambar menggunakan kunci.

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

Membuat fungsi pembantu asinkron

  1. Buat fungsi untuk memanggil klien secara asinkron, dan menampilkan respons dari layanan Bing Image Search.

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

Mengirim kueri dan menangani respons

  1. Panggil fungsi pembantu dan tangani promise-nya untuk mengurai hasil gambar yang ditampilkan dalam respons.

    Jika respons berisi hasil pencarian, simpan hasil pertama dan cetak detailnya, seperti URL gambar mini, URL asli, bersama dengan jumlah total gambar yang ditampilkan.

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

Langkah berikutnya

Tutorial aplikasi satu halaman Bing Image Search

Lihat juga

Gunakan mulai cepat ini untuk membuat pencarian gambar pertama Anda menggunakan pustaka klien Bing Image Search, yang merupakan pembungkus API dan berisi fitur yang sama. Aplikasi Python sederhana ini mengirimkan kueri pencarian gambar, menguraikan respons JSON, dan menampilkan URL gambar pertama yang dikembalikan.

Prasyarat

Membuat dan menginisialisasi aplikasi

  1. Buat skrip Python baru di IDE atau editor favorit Anda, dan impor berikut:

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

  2. Buat variabel untuk kunci langganan dan istilah pencarian Anda.

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

Buat klien pencarian gambar

  1. Buat instans CognitiveServicesCredentials, dan gunakan untuk memberi contoh klien:

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

  2. Kirim kueri pencarian ke Bing Image Search API:

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

Proses dan lihat hasilnya

Urai hasil gambar yang dikembalikan dalam respons.

Jika respons berisi hasil pencarian, simpan hasil pertama dan cetak detailnya, seperti URL gambar mini, URL asli, bersama dengan jumlah total gambar yang ditampilkan.

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

Langkah berikutnya

Tutorial aplikasi satu halaman Bing Image Search

Lihat juga