Bagikan melalui

Dapatkan gambar dari web dengan API Pencarian Gambar Bing

  • 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.

Saat menggunakan REST API Pencarian Gambar Bing, Anda bisa mendapatkan gambar dari web yang terkait dengan istilah pencarian Anda dengan mengirimkan permintaan GET berikut:

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com

Gunakan parameter kueri q untuk istilah pencarian yang dikodekan dengan url Anda. Misalnya, jika Anda memasukkan dinghies berlayar, atur q ke sailing+dinghies atau sailing%20dinghies.

Penting

  • Semua permintaan harus dibuat dari server, dan bukan dari klien.
  • Jika ini pertama kalinya Anda memanggil salah satu API pencarian Bing, jangan sertakan header ID klien. Hanya sertakan ID klien jika sebelumnya Anda telah memanggil Bing API yang mengembalikan ID klien untuk kombinasi pengguna dan perangkat.

Mendapatkan gambar dari domain web tertentu

Untuk mendapatkan gambar dari domain tertentu, gunakan situs: operator kueri.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us HTTP/1.1

Catatan

Respons terhadap kueri yang menggunakan operator site: mungkin menyertakan konten dewasa terlepas dari pengaturan safeSearch. Hanya gunakan site: jika Anda mengetahui konten di domain.

Filter gambar

Secara default, API Pencarian Gambar mengembalikan semua gambar yang relevan dengan kueri. Jika Anda ingin memfilter gambar yang dikembalikan Bing (misalnya, untuk mengembalikan hanya gambar dengan latar belakang transparan atau ukuran tertentu), gunakan parameter kueri berikut:

  • aspek—Memfilter gambar berdasarkan rasio aspek (misalnya, gambar layar standar atau lebar).
  • warna—Memfilter gambar dengan warna dominan atau hitam dan putih.
  • kesegaran—Memfilter gambar berdasarkan usia (misalnya, gambar yang ditemukan oleh Bing dalam seminggu terakhir).
  • tinggi, lebar—Memfilter gambar berdasarkan lebar dan tinggi.
  • imageContent—Memfilter gambar berdasarkan konten (misalnya, gambar yang hanya menampilkan wajah seseorang).
  • imageType—Memfilter gambar menurut jenis (misalnya, clip art, GIF animasi, atau latar belakang transparan).
  • lisensi—Memfilter gambar berdasarkan jenis lisensi yang terkait dengan situs.
  • ukuran—Memfilter gambar menurut ukuran, seperti gambar kecil hingga 200x200 piksel.

Untuk mendapatkan gambar dari domain tertentu, gunakan situs: operator kueri.

Contoh berikut menunjukkan cara mendapatkan gambar kecil dari ContosoSailing.com Bing ditemukan dalam seminggu terakhir.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&size=small&freshness=week&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
X-MSEdge-ClientIP: 999.999.999.999  
X-Search-Location: lat:47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com

Format respons Pencarian Gambar Bing

Pesan respons dari Bing berisi jawaban Gambar yang berisi daftar gambar yang ditentukan layanan Azure AI relevan dengan kueri. Setiap objek Gambar dalam daftar mencakup informasi berikut tentang gambar: URL, ukurannya, dimensinya, format pengkodeannya, URL ke gambar mini gambar, dan dimensi thumbnail.

Catatan

  • Gambar harus ditampilkan dalam urutan yang disediakan dalam respons.
  • Karena format dan parameter URL dapat berubah tanpa pemberitahuan, gunakan semua URL apa adanya. Anda tidak boleh mengambil dependensi pada format atau parameter URL kecuali jika dicatat.
{
    "name": "Rich Passage Sailing Dinghy",
    "webSearchUrl": "https:\/\/www.bing.com\/cr?IG=73118C8B4E3...",
    "thumbnailUrl": "https:\/\/tse1.mm.bing.net\/th?id=OIP.GNarK7m...",
    "datePublished": "2011-10-29T11:26:00",
    "contentUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3...",
    "hostPageUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3687...",
    "contentSize": "79239 B",
    "encodingFormat": "jpeg",
    "hostPageDisplayUrl": "en.contoso.org\/wiki\/File:Rich_Passage...",
    "width": 526,
    "height": 688,
    "thumbnail": {
        "width": 229,
        "height": 300
    },
    "imageInsightsToken": "ccid_GNarK7ma*mid_CCF85447ADA6...",
    "insightsSourcesSummary": {
        "shoppingSourcesCount": 0,
        "recipeSourcesCount": 0
    },
    "imageId": "CCF85447ADA6FFF9E96E7DF0B796F7A86E34593",
    "accentColor": "376094"
},

Saat Anda memanggil API Pencarian Gambar Bing, Bing mengembalikan daftar hasil. Daftar ini adalah subkumpulan dari jumlah total hasil yang relevan dengan kueri. Bidang respons totalEstimatedMatches berisi perkiraan jumlah gambar yang tersedia untuk dilihat. Untuk detail tentang cara menelusuri gambar lainnya, lihat Gambar Paging.

Langkah berikutnya

Jika Anda belum mencoba API Pencarian Gambar Bing sebelumnya, coba mulai cepat. Jika Anda mencari sesuatu yang lebih kompleks, cobalah tutorial untuk membuat aplikasi web halaman tunggal.