Referensi API Pencarian Gambar v5

  • Artikel
  • 40 menit untuk membaca

Peringatan

API Pencarian Bing berpindah dari Cognitive Services ke Layanan Pencarian Bing. Mulai 30 Oktober 2020, setiap instans baru Bing Search perlu diprovisikan dengan mengikuti proses yang didokumentasikan di sini. Bing Search API yang diprovisikan menggunakan Cognitive Services akan didukung selama tiga tahun ke depan atau hingga akhir Perjanjian Enterprise Anda, mana saja yang lebih dulu. Untuk instruksi migrasi, lihat Layanan Pencarian Bing.

API Pencarian Gambar memungkinkan Anda mengirim kueri pencarian ke Bing dan mendapatkan kembali daftar gambar yang relevan. Bagian ini menyediakan detail teknis tentang parameter dan header kueri yang Anda gunakan untuk meminta gambar dan objek respons JSON yang berisinya. Untuk contoh yang memperlihatkan cara membuat permintaan, lihat Mencari Web untuk Gambar.

Untuk informasi tentang header yang harus disertakan permintaan, lihat Header Permintaan.

Untuk informasi tentang parameter kueri yang harus disertakan permintaan, lihat Parameter Kueri.

Untuk informasi tentang objek respons JSON yang mungkin disertakan respons, lihat Objek Respons.

Untuk informasi tentang penggunaan dan tampilan hasil yang diizinkan, lihat persyaratan Penggunaan dan Tampilan API Pencarian Bing.

Titik akhir

Untuk meminta gambar, kirim permintaan GET ke salah satu URL berikut:

Endpoint Deskripsi
https://api.cognitive.microsoft.com/bing/v5.0/images/search Mengembalikan gambar yang relevan dengan kueri pencarian pengguna. Anda juga dapat menggunakan titik akhir ini untuk mendapatkan wawasan tentang gambar, seperti halaman web yang menyertakan gambar.
https://api.cognitive.microsoft.com/bing/v5.0/images/trending Mengembalikan gambar yang sedang tren berdasarkan permintaan pencarian yang dibuat oleh orang lain. Gambar dipecah menjadi kategori yang berbeda. Misalnya, Pencarian Orang Populer.

Untuk daftar pasar yang mendukung gambar tren, lihat Gambar Tren.

Permintaan harus menggunakan protokol HTTPS.

Catatan

Panjang URL maksimum adalah 2.048 karakter. Untuk memastikan bahwa panjang URL Anda tidak melebihi batas, panjang maksimum parameter kueri Anda harus kurang dari 1.500 karakter. Jika URL melebihi 2.048 karakter, server menampilkan 404 Tidak ditemukan.

Header

Berikut adalah header yang mungkin disertakan oleh permintaan dan respons.

Header Deskripsi
Terima Header permintaan opsional.

Jenis media default adalah aplikasi/json. Untuk menentukan bahwa respons menggunakan JSON-LD, atur header Terima ke application/ld+json.
Accept-Language Header permintaan opsional.

Daftar bahasa yang dibatasi koma untuk digunakan untuk string antarmuka pengguna. Daftar ini dalam urutan preferensi yang menurun. Untuk mengetahui informasi selengkapnya, termasuk format yang diharapkan, lihat RFC2616.

Header ini dan parameter kueri setLang saling eksklusif jangan tentukan keduanya.

Jika Anda mengatur header ini, Anda juga harus menentukan parameter kueri cc. Untuk menentukan pasar untuk mengembalikan hasil, Bing menggunakan bahasa pertama yang didukung yang ditemukannya dari daftar dan menggabungkannya dengan cc nilai parameter. Jika daftar tidak menyertakan bahasa yang didukung, Bing menemukan bahasa dan pasar terdekat yang mendukung permintaan atau menggunakan pasar agregat atau default untuk hasilnya. Untuk menentukan pasar yang digunakan Bing, lihat header BingAPIs-Market.

Gunakan header ini dan parameter kueri cc hanya jika Anda menentukan beberapa bahasa. Jika tidak, gunakan parameter kueri mkt dan setLang.

String antarmuka pengguna adalah string yang digunakan sebagai label di antarmuka pengguna. Ada beberapa string antarmuka pengguna di objek respons JSON. Setiap tautan ke properti Bing.com dalam objek respons menerapkan bahasa yang ditentukan.
BingAPIs-Market Header respons.

Pasar yang digunakan oleh permintaan. Bentuknya adalah <languageCode>-<countryCode>. Misalnya, en-US.

Jika Anda menentukan pasar yang tidak tercantum dalam Kode Pasar, nilai ini mungkin berbeda dari pasar yang Anda tentukan dalam parameter kueri mkt . Hal yang sama berlaku jika Anda menentukan nilai untuk cc dan Accept-Language yang tidak dapat direkonsiliasi.
BingAPIs-TraceId Header respons.

ID entri log yang berisi detail permintaan. Saat terjadi kesalahan, ambil ID ini. Jika Anda tidak dapat menentukan dan mengatasi masalah tersebut, sertakan ID ini bersama dengan informasi lain yang Anda berikan kepada tim Dukungan.
Ocp-Apim-Subscription-Key Header permintaan yang diperlukan.

Kunci langganan yang Anda terima saat mendaftar untuk layanan ini di Cognitive Services.
Retry-After Header respons.

Respons mencakup header ini jika Anda melebihi jumlah kueri yang diizinkan per detik (QPS) atau per bulan (QPM). Header berisi jumlah detik yang harus Anda tunggu sebelum mengirim permintaan lain.
User-Agent Header permintaan opsional.

Agen pengguna yang berasal dari permintaan. Bing menggunakan agen pengguna untuk memberikan pengalaman yang dioptimalkan kepada pengguna seluler. Meskipun opsional, Anda dianjurkan untuk selalu menentukan header ini.

User-agent harus berupa string yang sama dengan yang dikirim oleh browser yang umum digunakan. Untuk mengetahui informasi tentang agen pengguna, lihat RFC 2616.

Berikut adalah contoh string user-agent.
  • Windows Phone—Mozilla/5.0 (kompatibel; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)

  • Android—Mozilla/5.0 (Linux; U; Android 2.3.5; en-us; SCH-I500 Build/GINGERBREAD) AppleWebKit/533.1 (KHTML; seperti Gecko) Version/4.0 Mobile Safari/533.1

  • iPhone—Mozilla/5.0 (iPhone; CPU iPhone OS 6_1 seperti Mac OS X) AppleWebKit/536.26 (KHTML; seperti Gecko) Mobile/10B142 iPhone4;1 BingWeb/3.03.1428.20120423

  • PC—Mozilla/5.0 (Windows NT 6.3; WOW64; Trident/7.0; Touch; rv:11.0) seperti Gecko

  • iPad—Mozilla/5.0 (iPad; CPU OS 7_0 seperti Mac OS X) AppleWebKit/537.51.1 (KHTML, seperti Gecko) Version/7.0 Mobile/11A465 Safari/9537.53
X-MSEdge-ClientID Permintaan dan header respons opsional.

Bing menggunakan header ini untuk memberi perilaku yang konsisten kepada pengguna di seluruh panggilan Bing API. Bing sering kali menerbangkan fitur dan peningkatan baru, dan menggunakan ID klien sebagai kunci untuk menetapkan lalu lintas pada penerbangan yang berbeda. Jika Anda tidak menggunakan ID klien yang sama untuk pengguna di beberapa permintaan, Bing dapat menetapkan pengguna ke beberapa penerbangan yang bertentangan. Ditetapkan ke beberapa penerbangan yang bertentangan dapat menyebabkan pengalaman pengguna yang tidak konsisten. Misalnya, jika permintaan kedua memiliki penetapan penerbangan yang berbeda dengan yang pertama, pengalaman tersebut mungkin tidak diharapkan. Selain itu, Bing dapat menggunakan ID klien untuk menyesuaikan hasil web dengan riwayat pencarian ID klien tersebut, memberikan pengalaman yang lebih kaya bagi pengguna.

Bing juga menggunakan header ini untuk membantu meningkatkan peringkat hasil dengan menganalisis aktivitas yang dibuat oleh ID klien. Peningkatan relevansi membantu terkait kualitas hasil yang lebih baik yang disampaikan oleh Bing API dan pada gilirannya memungkinkan rasio klik-tayang yang lebih tinggi untuk konsumen API.

PENTING: Meskipun opsional, Anda harus menganggap header ini diperlukan. Mempertahankan ID klien di beberapa permintaan untuk kombinasi pengguna akhir dan perangkat yang sama memungkinkan 1) konsumen API menerima pengalaman pengguna yang konsisten, dan 2) rasio klik-tayang yang lebih tinggi melalui kualitas hasil yang lebih baik dari Bing API.

Berikut adalah aturan dasar penggunaan yang berlaku untuk header ini.
  • Setiap pengguna yang menggunakan aplikasi Anda pada perangkat harus memiliki ID klien buatan Bing yang unik.

    Jika Anda tidak menyertakan header ini dalam permintaan, Bing membuat ID dan menampilkannya di header respons X-MSEdge-ClientID. Satu-satunya waktu yang TIDAK diizinkan untuk menyertakan header ini dalam permintaan adalah pertama kalinya pengguna menggunakan aplikasi Anda di perangkat tersebut.

  • Gunakan ID klien untuk setiap permintaan Bing API yang dibuat aplikasi Anda untuk pengguna ini di perangkat.

  • PERHATIAN: Anda harus memastikan bahwa ID Klien ini tidak dapat ditautkan ke informasi akun pengguna yang dapat diautentikasi.

  • Pertahankan ID klien. Untuk mempertahankan ID di aplikasi browser, gunakan cookie HTTP persisten untuk memastikan ID digunakan di semua sesi. Jangan gunakan cookie sesi. Untuk aplikasi lain seperti aplikasi seluler, gunakan penyimpanan persisten perangkat untuk mempertahankan ID.

    Lain kali pengguna menggunakan aplikasi Anda di perangkat tersebut, dapatkan ID klien yang Anda pertahankan.

CATATAN: Respons Bing mungkin atau mungkin tidak menyertakan header ini. Jika respons menyertakan header ini, tangkap ID klien dan gunakan untuk semua permintaan Bing berikutnya untuk pengguna di perangkat tersebut.

CATATAN Jika Anda menyertakan X-MSEdge-ClientID, Anda tidak boleh menyertakan cookie dalam permintaan.
X-Search-ClientIP Header permintaan opsional.

Alamat IPv4 atau IPv6 perangkat klien. Alamat IP digunakan untuk menemukan lokasi pengguna. Bing menggunakan informasi lokasi untuk menentukan perilaku pencarian yang aman.

CATATAN: Meskipun opsional, Anda dianjurkan untuk selalu menentukan header ini dan header X-Search-Location.

Jangan mengaburkan alamat (misalnya, dengan mengubah oktet terakhir menjadi 0). Mengaburkan alamat mengakibatkan lokasi tidak berada di dekat lokasi aktual perangkat, yang dapat mengakibatkan Bing memberikan hasil yang salah.
X-Search-Location Header permintaan opsional.

Daftar pasangan kunci/nilai yang dibatasi titik koma yang menjelaskan lokasi geografis klien. Bing menggunakan informasi lokasi untuk menentukan perilaku pencarian yang aman dan menampilkan konten lokal yang relevan. Tentukan pasangan kunci/nilai sebagai <kunci>:<nilai>. Berikut adalah kunci yang Anda gunakan untuk menentukan lokasi pengguna.

  • lat—Diperlukan. Garis lintang lokasi klien, dalam derajat. Garis lintang harus lebih besar dari atau sama dengan -90.0 dan kurang dari atau sama dengan +90.0. Nilai negatif menunjukkan garis lintang selatan dan nilai positif menunjukkan garis lintang utara.

  • long—Diperlukan. Bujur lokasi klien, dalam derajat. Bujur harus lebih besar dari atau sama dengan -180.0 dan kurang dari atau sama dengan +180.0. Nilai negatif menunjukkan bujur barat dan nilai positif menunjukkan bujur timur.

  • re—Diperlukan. Radius, dalam meter, yang menentukan akurasi horizontal koordinat. Berikan nilai yang ditampilkan oleh layanan lokasi perangkat. Nilai umum mungkin 22m untuk GPS/Wi-Fi, 380m untuk triangulasi menara sel, dan 18.000m untuk pencarian IP terbalik.

  • ts—Opsional. Tanda waktu UTC UNIX saat klien berada di lokasi tersebut. (Tanda waktu UNIX adalah jumlah detik sejak 1 Januari 1970.)

  • head—Opsional. Judul relatif atau arah perjalanan klien. Tentukan arah perjalanan sebagai derajat dari 0 hingga 360, menghitung searah jarum jam relatif terhadap utara sejati. Tentukan kunci ini hanya jika kunci sp bukan nol.

  • sp—Opsional. Kecepatan horizontal (kecepatan), dalam meter per detik, perangkat klien bepergian.

  • alt—Opsional. Ketinggian perangkat klien, dalam meter.

  • —bersifat Opsional. Radius, dalam meter, yang menentukan akurasi vertikal koordinat. Tentukan kunci ini hanya jika Anda menentukan kunci alt.

CATATAN: Meskipun banyak kunci bersifat opsional, semakin banyak informasi yang Anda berikan, semakin akurat hasil lokasinya.

CATATAN: Meskipun opsional, Anda dianjurkan untuk selalu menentukan lokasi geografis pengguna. Menyediakan lokasi sangat penting jika alamat IP klien tidak secara akurat mencerminkan lokasi fisik pengguna (misalnya, jika klien menggunakan VPN). Untuk hasil yang optimal, Anda harus menyertakan header ini dan header X-Search-ClientIP, tetapi minimal, Anda harus menyertakan header ini.

Catatan

Ingatlah bahwa Ketentuan Penggunaan memerlukan kepatuhan terhadap semua hukum yang berlaku, termasuk mengenai penggunaan header ini. Misalnya, di wilayah hukum tertentu, seperti Eropa, ada persyaratan untuk mendapatkan persetujuan pengguna sebelum menempatkan perangkat pelacakan tertentu pada perangkat pengguna.

Parameter kueri

Berikut adalah parameter kueri yang dapat disertakan dalam permintaan. Lihat kolom Wajib untuk parameter yang diperlukan. Nilai parameter kueri harus dikodekan URL. Untuk informasi tentang parameter kueri yang digunakan untuk memfilter gambar yang Bing kembalikan, lihat Filter Parameter Kueri.

Nama Nilai Jenis Diperlukan
Cab Koordinat bawah wilayah yang akan dipangkas.

Koordinat adalah nilai pecahan dari tinggi gambar asli dan diukur dari sudut kiri atas gambar. Tentukan koordinat sebagai nilai dari 0,0 hingga 1,0.

Parameter ini hanya didukung oleh API Insights; jangan tentukan parameter ini saat memanggil Gambar, Gambar Yang Sedang Tren, atau API Pencarian Web.		 Mengambang Tidak
Cal Koordinat kiri wilayah untuk dipangkas.

Koordinat adalah sebagian kecil dari lebar gambar asli dan diukur dari sudut kiri atas gambar. Tentukan koordinat sebagai nilai dari 0,0 hingga 1,0.

Parameter ini hanya didukung oleh API Insights; jangan tentukan parameter ini saat memanggil Gambar, Gambar Yang Sedang Tren, atau API Pencarian Web.		 Mengambang Tidak
mobil Koordinat wilayah yang tepat untuk dipangkas.

Koordinat adalah sebagian kecil dari lebar gambar asli dan diukur dari sudut kiri atas gambar. Tentukan koordinat sebagai nilai dari 0,0 hingga 1,0.

Parameter ini hanya didukung oleh API Insights; jangan tentukan parameter ini saat memanggil Gambar, Gambar Yang Sedang Tren, atau API Pencarian Web.		 Mengambang Tidak
cat Koordinat teratas wilayah yang akan dipangkas.

Koordinat adalah sebagian kecil dari tinggi gambar asli dan diukur dari sudut kiri atas gambar. Tentukan koordinat sebagai nilai dari 0,0 hingga 1,0.

Parameter ini hanya didukung oleh API Insights; jangan tentukan parameter ini saat memanggil Gambar, Gambar Yang Sedang Tren, atau API Pencarian Web.		 Mengambang Tidak
Ct Jenis pemangkasan yang digunakan untuk memangkas gambar berdasarkan koordinat yang ditentukan dalam parameter cal, cat, car, dan cab.

Berikut ini adalah nilai yang mungkin.
  • 0—Persegi panjang (default)

Parameter ini hanya didukung oleh API Insights; jangan tentukan parameter ini saat memanggil Gambar, Gambar Yang Sedang Tren, atau API Pencarian Web.		 Bilangan Bulat Tidak Bertanda Tidak
cc Kode negara 2 karakter negara tempat hasilnya berasal. Untuk daftar nilai yang mungkin, lihat Kode Pasar.

Jika Anda mengatur parameter ini, Anda juga harus menentukan header Accept-Language. Bing menggunakan bahasa pertama yang didukung yang ditemukannya dalam bahasa yang ditentukan dan menggabungkannya dengan kode negara untuk menentukan pasar untuk mengembalikan hasil. Jika daftar bahasa tidak menyertakan bahasa yang didukung, Bing menemukan bahasa dan pasar terdekat yang mendukung permintaan tersebut. Atau, Bing dapat menggunakan pasar agregat atau default untuk hasilnya.

Gunakan parameter kueri ini dan Accept-Language header hanya jika Anda menentukan beberapa bahasa. Jika tidak, Anda harus menggunakan mkt parameter kueri dan setLang .

Parameter ini dan parameter kueri mkt saling eksklusif—jangan tentukan keduanya.		 String Tidak
jumlah Jumlah gambar yang akan dikembalikan dalam respons. Jumlah aktual yang dikirimkan mungkin kurang dari yang diminta. Defaultnya adalah 35. Nilai maksimum adalah 150.

Anda dapat menggunakan parameter ini bersama dengan offset parameter ke hasil halaman. Misalnya, jika antarmuka pengguna Anda menyajikan 20 gambar per halaman, Anda akan mengatur count ke 20 dan offset ke 0 untuk mendapatkan halaman pertama hasil. Untuk setiap halaman berikutnya, Anda akan offset bertambah 20 (misalnya, 0, 20, 40).

Parameter ini hanya didukung oleh IMAGE Search API; jangan tentukan parameter ini saat memanggil Insights, Gambar Yang Sedang Tren, atau API Pencarian Web.		 UnsignedShort Tidak
id ID yang secara unik mengidentifikasi gambar. Anda dapat menggunakan parameter ini untuk memastikan bahwa gambar yang ditentukan adalah gambar pertama dalam daftar gambar. Bidang Objek imageIdgambar berisi ID yang akan Anda atur parameter ini. String Tidak
imgUrl URL ke gambar yang ingin Anda dapatkan wawasannya. Gunakan parameter ini sebagai alternatif untuk menentukan gambar dengan menggunakan insightsToken parameter .

Untuk menentukan gambar, Anda dapat menggunakan parameter ini atau Anda dapat menempatkan biner gambar dalam isi permintaan POST (lihat header Jenis Konten.

Ukuran gambar maksimum yang didukung adalah 1 MB.

Parameter ini hanya didukung oleh API Insights; jangan tentukan parameter ini saat memanggil Gambar, Gambar Yang Sedang Tren, atau API Pencarian Web.		 String Tidak
insightsToken Token dari panggilan API Pencarian Gambar sebelumnya (lihat imageInsightsToken). Tentukan parameter ini untuk mendapatkan informasi tambahan tentang gambar, seperti keterangan atau sumber belanja. Untuk daftar informasi tambahan yang bisa Anda dapatkan, lihat parameter kueri modulesRequested .

Parameter ini hanya didukung oleh API Insights; jangan tentukan parameter ini saat memanggil Gambar, Gambar Yang Sedang Tren, atau API Pencarian Web.		 String Tidak
mkt Pasar tempat hasilnya berasal. Biasanya, mkt adalah negara tempat pengguna membuat permintaan. Namun, itu bisa menjadi negara yang berbeda jika pengguna tidak berada di negara tempat Bing memberikan hasil. Pasar harus dalam bentuk <kode> bahasa> kode negara<. Misalnya, en-US. String tidak peka huruf besar/kecil. Untuk daftar kemungkinan nilai pasar, lihat Kode Pasar.

CATATAN: Jika diketahui, Anda dianjurkan untuk selalu menentukan pasar. Menentukan pasar membantu Bing merutekan permintaan dan menampilkan respons yang sesuai dan optimal. Jika Anda menentukan pasar yang tidak tercantum dalam Kode Pasar, Bing menggunakan kode pasar yang paling sesuai berdasarkan pemetaan internal yang dapat berubah.

Parameter ini dan parameter kueri cc saling eksklusif—jangan tentukan keduanya.		 String Tidak
modulRequested Daftar yang dibatasi koma dari satu atau beberapa wawasan untuk diminta. (Saat URL Anda mengodekan string kueri, koma berubah menjadi %2C.) Berikut ini adalah kemungkinan nilai yang tidak peka huruf besar/kecil.
  • Semua—Mengembalikan semua wawasan, jika tersedia, kecuali RecognizedEntities.

  • Anotasi—Memberikan karakteristik jenis konten yang ditemukan dalam gambar. Misalnya, jika gambarnya adalah seseorang, anotasi mungkin menunjukkan jenis kelamin orang tersebut dan jenis pakaian yang mereka kenakan.

  • BRQ—Kueri perwakilan terbaik yang menjelaskan gambar.

  • Keterangan—Keterangan yang menyediakan informasi tentang gambar. Jika keterangan berisi entitas, respons dapat menyertakan tautan ke gambar entitas tersebut.

  • Koleksi—Daftar gambar terkait.

  • Resep—Daftar resep untuk memasak makanan yang ditunjukkan dalam gambar.
  • PagesIncluding—Daftar halaman web yang menyertakan gambar.

  • RecognizedEntities—Daftar entitas (orang) yang dikenali dalam gambar.

    CATATAN: Anda mungkin tidak menentukan modul ini dengan modul lain. Jika Anda menentukannya dengan modul lain, respons tidak menyertakan modul ini.

  • RelatedSearches—Daftar pencarian terkait yang dibuat oleh orang lain.

  • ShoppingSources—Daftar pedagang tempat Anda dapat membeli penawaran terkait.

  • SimilarImages—Daftar gambar yang secara visual mirip dengan gambar asli.

  • SimilarProducts—Daftar gambar yang berisi produk yang mirip dengan produk yang ditemukan dalam gambar asli.

Jika Anda menentukan modul dan tidak ada data untuk modul, objek respons tidak menyertakan bidang terkait. Misalnya, jika Anda menentukan Keterangan dan tidak ada, respons tidak menyertakan imageCaption bidang .

Untuk menyertakan pencarian terkait, permintaan harus menyertakan string kueri asli.

Meskipun string kueri asli tidak diperlukan untuk gambar atau produk serupa, Anda harus selalu menyertakannya karena dapat membantu meningkatkan relevansi dan hasilnya.

Parameter ini hanya didukung oleh IMAGE Search API; jangan tentukan parameter ini saat memanggil TRENDING Images API atau Search API.		 String Tidak
offset Offset berbasis nol yang menunjukkan jumlah gambar yang akan dilewati sebelum mengembalikan gambar. Defaultnya adalah 0. Offset harus kurang dari (totalEstimatedMatches - count).

Gunakan parameteralong ini dengan count parameter ke hasil halaman. Misalnya, jika antarmuka pengguna Anda menyajikan 20 gambar per halaman, Anda akan mengatur count ke 20 dan offset ke 0 untuk mendapatkan halaman pertama hasil. Untuk setiap halaman berikutnya, Anda akan offset bertambah 20 (misalnya, 0, 20, 40).

Dimungkinkan bagi beberapa halaman untuk menyertakan beberapa tumpang tindih dalam hasil. Untuk mencegah duplikat, lihat nextOffsetAddCount.

Parameter ini hanya didukung oleh IMAGE Search API; jangan tentukan parameter ini saat memanggil TRENDING Images API atau Search API.		 Pendek Tidak Ditandatangani Tidak
q String kueri pencarian pengguna. String kueri tidak boleh kosong.

String kueri mungkin berisi operator tingkat lanjut Bing. Misalnya, untuk membatasi gambar ke domain tertentu, gunakan operator situs: .

Untuk membantu meningkatkan relevansi kueri wawasan (lihat insightsToken), Anda harus selalu menyertakan string kueri pengguna.

Parameter ini hanya didukung oleh IMAGE Search API; jangan tentukan parameter ini saat memanggil TRENDING Images API.		 String Ya
safeSearch Memfilter gambar untuk konten dewasa. Berikut ini adalah kemungkinan nilai filter.
  • Nonaktif—Dapat menampilkan gambar dengan konten dewasa. Jika permintaan melalui IMAGE Search API, respons menyertakan gambar mini yang jelas (tidak fuzzy). Jika permintaan melalui WEB Search API, respons menyertakan gambar mini yang di-pixel (fuzzy).

  • Sedang—Jika permintaan melalui IMAGE Search API, respons tidak menyertakan gambar dengan konten dewasa. Jika permintaan melalui WEB Search API, respons dapat mencakup gambar dengan konten dewasa (gambar mini di-pixelated (fuzzy)).

  • Ketat—Jangan mengembalikan gambar dengan konten dewasa.

Jika tidak ditentukan, defaultnya adalah Moderat.

CATATAN: Jika permintaan berasal dari pasar yang memerlukan safeSearch kebijakan dewasa Bing diatur ke Ketat, Bing mengabaikan safeSearch nilai dan menggunakan Strict.

CATATAN: Jika Anda menggunakan operator kueri site:, ada kemungkinan respons berisi konten dewasa terlepas dari untuk apa parameter kueri safeSearch ditetapkan. Gunakan site: hanya jika Anda mengetahui konten di situs dan skenario Anda mendukung kemungkinan konten dewasa.		 String Tidak
setLang Bahasa yang digunakan untuk string antarmuka pengguna. Tentukan bahasa menggunakan kode bahasa ISO 639-1 2 huruf. Misalnya, kode bahasa untuk bahasa Inggris adalah EN. Defaultnya adalah EN (Inggris).

Meskipun opsional, Anda harus selalu menentukan bahasa. Biasanya, Anda mengatur setLang ke bahasa yang sama dengan yang ditentukan oleh mkt kecuali pengguna ingin string antarmuka pengguna ditampilkan dalam bahasa yang berbeda.

Parameter dan header Accept-Language ini saling eksklusif—jangan tentukan keduanya.

String antarmuka pengguna adalah string yang digunakan sebagai label di antarmuka pengguna. Ada beberapa string antarmuka pengguna di objek respons JSON. Selain itu, setiap tautan ke properti Bing.com dalam objek respons menerapkan bahasa yang ditentukan.		 String Tidak

Memfilter parameter kueri

Berikut ini adalah parameter kueri filter opsional yang bisa Anda gunakan untuk memfilter gambar yang Bing kembalikan. Nilai parameter kueri harus dikodekan URL.

Hanya API Pencarian Gambar yang mendukung parameter kueri ini; jangan tentukan parameter ini saat memanggil TRENDING Images API atau Web Search API.

Nama Nilai Jenis
Aspek Memfilter gambar berdasarkan rasio aspek. Berikut ini adalah kemungkinan nilai filter.
  • Persegi—Mengembalikan gambar dengan rasio aspek standar
  • Wide—Mengembalikan gambar dengan rasio aspek layar lebar
  • Tinggi—Mengembalikan gambar dengan rasio aspek tinggi
  • Semua—Jangan filter berdasarkan aspek. Menentukan nilai ini sama dengan tidak menentukan aspect parameter.
 String
Warna Memfilter gambar menurut warna. Berikut ini adalah kemungkinan nilai filter.
  • ColorOnly—Mengembalikan gambar warna
  • Monokrom—Mengembalikan gambar hitam dan putih

Mengembalikan gambar dengan salah satu warna dominan berikut:
  • Hitam
  • Biru
  • Cokelat
  • Abu-abu
  • Hijau
  • Oranye
  • Pink
  • Ungu
  • Merah
  • Teal
  • Putih
  • Kuning
 String
Kesegaran Filter gambar menurut saat Bing menemukan gambar. Berikut ini adalah kemungkinan nilai filter.
  • Hari—Mengembalikan gambar yang ditemukan dalam 24 jam terakhir
  • Minggu—Mengembalikan gambar yang ditemukan dalam 7 hari terakhir
  • Bulan—Mengembalikan gambar yang ditemukan dalam 30 hari terakhir
  • Tahun—Mengembalikan gambar yang ditemukan dalam setahun terakhir
 String
Tinggi Filter gambar yang memiliki tinggi yang ditentukan, dalam piksel.

Anda dapat menggunakan filter ini bersama dengan size filter. Misalnya, kembalikan gambar kecil yang memiliki tinggi 150 piksel.		 UnsignedShort
imageContent Memfilter gambar menurut konten. Berikut ini adalah kemungkinan nilai filter.
  • Face—Menampilkan gambar yang hanya menampilkan wajah seseorang
  • Potret—Mengembalikan gambar yang hanya menampilkan kepala dan bahu seseorang
 String
imageType Memfilter gambar menurut jenis gambar. Berikut ini adalah kemungkinan nilai filter.

  • AnimatedGif—Hanya mengembalikan GIF animasi

  • Clipart—Hanya mengembalikan gambar clip art

  • Garis—Hanya mengembalikan gambar garis

  • Foto—Hanya menampilkan foto (tidak termasuk gambar garis, Gif animasi, dan clip art)

  • Belanja—Kembalikan hanya gambar yang berisi item di mana Bing mengetahui pedagang yang menjual item. Opsi ini hanya berlaku di pasar en-US.

  • Transparan—Hanya mengembalikan gambar dengan latar belakang transparan.
 String
Lisensi Memfilter hasil berdasarkan jenis lisensi terkait. Berikut ini adalah kemungkinan nilai filter.
  • Apa pun—Mengembalikan gambar yang berada di bawah jenis lisensi apa pun. Respons hanya mencakup gambar yang secara eksplisit menentukan lisensi.

  • Publik—Mengembalikan gambar di mana pembuat telah melepaskan hak eksklusif mereka, sejauh diizinkan oleh hukum.

  • Bagikan—Mengembalikan gambar yang mungkin dibagikan dengan orang lain. Mengubah atau mengedit gambar mungkin tidak diizinkan. Selain itu, memodifikasi, berbagi, dan menggunakan gambar untuk tujuan komersial mungkin tidak diizinkan. Biasanya, opsi ini mengembalikan gambar terbanyak.

  • ShareCommercially—Menampilkan gambar yang mungkin dibagikan dengan orang lain untuk tujuan pribadi atau komersial. Mengubah atau mengedit gambar mungkin tidak diizinkan.

  • Modifikasi—Mengembalikan gambar yang mungkin dimodifikasi, dibagikan, dan digunakan. Mengubah atau mengedit gambar mungkin tidak diizinkan. Memodifikasi, berbagi, dan menggunakan gambar untuk tujuan komersial mungkin tidak diizinkan.

  • ModifikasiKomersial—Mengembalikan gambar yang mungkin dimodifikasi, dibagikan, dan digunakan untuk tujuan pribadi atau komersial. Biasanya, opsi ini mengembalikan gambar terkecil.

  • Semua—Jangan filter menurut jenis lisensi. Menentukan nilai ini sama dengan tidak menentukan license parameter.

CATATAN: Bing tidak memverifikasi atau mewakili bahwa lisensi tertentu dikaitkan dengan gambar atau bahwa pengguna dapat menggunakan gambar di bawah lisensi tersebut. Untuk informasi selengkapnya tentang jenis lisensi ini, lihat Memfilter Gambar Menurut Jenis Lisensi.		 String
Ukuran Memfilter gambar menurut ukuran. Berikut ini adalah kemungkinan nilai filter.
  • Kecil—Mengembalikan gambar yang kurang dari 200x200 piksel

  • Sedang—Mengembalikan gambar yang lebih besar dari atau sama dengan 200x200 piksel tetapi kurang dari 500x500 piksel

  • Besar—Menampilkan gambar yang 500x500 piksel atau lebih besar

  • Wallpaper—Mengembalikan gambar wallpaper.

  • Semua—Jangan filter berdasarkan ukuran. Menentukan nilai ini sama dengan tidak menentukan size parameter.

Anda dapat menggunakan parameter ini bersama dengan height parameter atau width . Misalnya, Anda dapat menggunakan height dan size untuk meminta gambar kecil yang tingginya 150 piksel.		 String
Lebar Filter gambar yang memiliki lebar yang ditentukan, dalam piksel.

Anda dapat menggunakan filter ini bersama dengan size filter. Misalnya, mengembalikan gambar kecil yang memiliki lebar 150 piksel.		 UnsignedShort

Objek respons

Catatan

Untuk mematuhi Direktif Hak Cipta UE baru di Prancis, API Bing Web, Berita, Video, Gambar, dan semua Pencarian Kustom harus menghilangkan beberapa konten dari sumber Berita UE tertentu untuk pengguna Prancis. Konten yang dihapus dapat mencakup gambar dan video gambar mini, pratinjau video, dan cuplikan yang menyertai hasil pencarian dari sumber ini. Akibatnya, API Bing dapat melayani lebih sedikit hasil dengan gambar dan video gambar mini, pratinjau video, dan cuplikan kepada pengguna Prancis.

Berikut ini adalah objek JSON yang mungkin disertakan oleh respons. Jika permintaan berhasil, objek tingkat atas dalam respons adalah objek Gambar jika titik akhir adalah /images/search, ImageInsightsResponse jika permintaannya adalah untuk wawasan gambar, dan TrendingImages jika titik akhir adalah /images/trending. Jika permintaan gagal, objek tingkat atas adalah objek ErrorResponse.

Objek Deskripsi
AggregateOffer Mendefinisikan daftar penawaran dari pedagang yang memiliki penawaran yang terkait dengan gambar.
AgregatRating Menentukan metrik yang menunjukkan seberapa baik item dinilai oleh orang lain.
Kategori (ImageInsights) Mendefinisikan karakteristik yang ditemukan dalam gambar.
Kategori (TrendingImages) Menentukan kategori gambar yang sedang tren.
CategoryClassification Menentukan kategori karakteristik yang ditemukan dalam gambar.
Kesalahan Menentukan kesalahan yang terjadi.
ErrorResponse Objek tingkat atas yang disertakan respons saat permintaan gagal.
Gambar Objek yang berisi informasi tentang gambar yang relevan dengan kueri.
ImageCaption Menentukan keterangan tentang gambar.
ImageGallery Menentukan tautan ke halaman web yang berisi kumpulan gambar terkait.
ImageInsightsResponse Objek tingkat atas yang disertakan respons saat permintaan wawasan gambar berhasil.
Citra Objek tingkat atas yang disertakan respons saat permintaan gambar berhasil.
InsightsSourcesSummary Menentukan hitungan jumlah situs web tempat Anda dapat berbelanja atau melakukan tindakan lain yang terkait dengan gambar.
MediaSize Menentukan ukuran isi media.
NormalizedRectangle Menentukan wilayah gambar.
Instrumentasi Menentukan URL instrumentasi Bing.
Penawaran Mendefinisikan penawaran pedagang.
Organisasi Mendefinisikan informasi tentang pedagang.
Orang Mendefinisikan seseorang.
Pivot Menentukan segmen pivot.
ProductSummaryImage Menentukan gambar produk dan memberikan informasi ringkasan tentang penawaran yang Bing temukan secara online untuk produk.
Kueri Menentukan string kueri pencarian.
Resep Mendefinisikan resep memasak.
RecognizedEntity Mendefinisikan entitas yang dikenali.
RecognizedEntityGroup Mendefinisikan sekelompok entitas yang dikenali sebelumnya.
RecognizedEntityRegion Menentukan wilayah tempat entitas ditemukan dan daftar entitas yang mungkin cocok dengannya.
Gambar mini Menentukan gambar mini.
Petak Mendefinisikan petak peta gambar.
TrendingImages Objek tingkat atas yang disertakan respons saat permintaan gambar yang sedang tren berhasil.

AggregateOffer

Mendefinisikan daftar penawaran dari pedagang yang terkait dengan gambar.

Elemen Deskripsi Jenis
offers Daftar penawaran dari pedagang yang memiliki penawaran yang terkait dengan gambar. Penawaran[]

Mengagregasi

Menentukan metrik yang menunjukkan seberapa baik item dinilai oleh orang lain.

Nama Nilai Jenis
bestRating Ulasan berperingkat tertinggi. Nilai yang mungkin adalah 1,0 hingga 5,0. float
ratingValue Peringkat rata-rata (rata-rata). Nilai yang mungkin adalah 1,0 hingga 5,0. float
reviewCount Berapa kali resep telah dinilai atau ditinjau. Bilangan Bulat Tidak Bertanda
Teks Peringkat rata-rata (rata-rata), dalam bentuk string. String

Kategori (TrendingImages)

Menentukan kategori gambar yang sedang tren.

Namespace TrendingImages mendefinisikan objek ini.

Elemen Deskripsi Jenis
Ubin Daftar gambar yang sedang tren dalam kategori. Setiap petak berisi gambar dan kueri Bing yang mengembalikan lebih banyak gambar subjek. Misalnya, jika kategorinya adalah Pencarian Orang Populer, gambarnya adalah orang populer dan kuerinya adalah untuk lebih banyak gambar orang tersebut. Ubin[]
title Nama kategori gambar. Misalnya, Pencarian Orang Populer. String

Kategori (ImageInsights)

Mendefinisikan karakteristik yang ditemukan dalam gambar.

Namespace Layanan ImageInsights mendefinisikan objek ini.

Elemen Deskripsi Jenis
keyakinan Keyakinan bahwa Bing telah mengidentifikasi kategori dengan benar. Nilai yang mungkin adalah 0,0 hingga 1,0 di mana 1,0 menunjukkan bahwa Bing 100% yakin bahwa kategori sudah benar. Mengambang
nama Nama kategori. String

CategoryClassification

Menentukan kategori karakteristik yang ditemukan dalam gambar.

Elemen Deskripsi Jenis
Kategori Daftar karakteristik yang ditemukan dalam gambar. Misalnya, jika gambar tersebut adalah artis musikal, array mungkin termasuk Perempuan, Gaun, dan Musik untuk menunjukkan orang tersebut adalah wanita, mengenakan gaun, dan merupakan artis musikal. Kategori[]

Kesalahan

Menentukan kesalahan yang terjadi.

Elemen Deskripsi Jenis
code Kode kesalahan yang mengidentifikasi kesalahan. Untuk daftar kode yang mungkin, lihat Kode Kesalahan. String
message Deskripsi kesalahan. String
parameter Parameter kueri dalam permintaan yang menyebabkan kesalahan. String
value Nilai parameter kueri yang tidak valid. String

ErrorResponse

Objek tingkat atas yang disertakan respons saat permintaan gagal.

Nama Nilai Jenis
_type Ketik petunjuk. String
errors Daftar kesalahan yang menjelaskan alasan permintaan gagal. Error[]

Gambar

Menentukan gambar yang relevan dengan kueri.

Catatan

Karena format URL dan parameter dapat berubah tanpa pemberitahuan, semua URL harus digunakan apa adanya; Anda tidak boleh mengambil dependensi pada format atau parameter URL. Pengecualiannya adalah parameter dan nilai yang dibahas oleh Mengubah ukuran dan memangkas gambar mini.

Nama Nilai Jenis
accentColor Angka heksadesimal tiga byte yang mewakili warna yang mendominasi gambar. Klien dapat menggunakan warna sebagai latar belakang sementara hingga gambar dimuat. String
contentSize Ukuran file gambar. Format string adalah {size} {units}, di mana {units} dapat diatur ke B untuk byte, KB untuk Kilobyte, dll. Misalnya, 12345 B menunjukkan bahwa ukuran gambar adalah 12.345 byte. String
contentUrl URL ke gambar di situs web sumber. String
datePublished Tanggal dan waktu, dalam UTC, yang Bing menemukan gambar. Tanggal dalam format, YYYY-MM-DDTHH:MM:SS. String
encodingFormat Jenis mime gambar (misalnya, jpeg). String
Tinggi Tinggi gambar sumber, dalam piksel. Pendek Tidak Ditandatangani
hostPageDisplayUrl URL tampilan halaman web yang menghosting gambar.

Anda akan menggunakan URL ini di antarmuka pengguna Anda untuk mengidentifikasi halaman web host yang berisi gambar. URL ini tidak terbentuk dengan baik sehingga jangan gunakan untuk mengakses halaman web host. URL tidak menyertakan protokol (misalnya, HTTP) dan mungkin menyertakan karakter penyorotan temuan. Untuk mengakses halaman web host, gunakan hostPageUrl URL.		 String
hostPageUrl URL halaman web yang menyertakan gambar.

URL ini dan contentUrl mungkin URL yang sama.		 String
id ID yang secara unik mengidentifikasi gambar ini dalam daftar gambar.

Objek Gambar hanya menyertakan bidang ini saat gambar disertakan dalam hasil pencarian SEARCH API dan respons peringkat menentukan posisi tertentu untuk gambar. Untuk informasi tentang cara menggunakan bidang ini, lihat Menggunakan Peringkat untuk Menampilkan Hasil di panduan API Pencarian Web.		 String
imageId ID yang secara unik mengidentifikasi gambar ini dalam daftar gambar. Jika Anda ingin gambar menjadi gambar pertama dalam respons, atur parameter kueri id ke ID ini dalam permintaan Anda. String
imageInsightsToken Token yang Anda gunakan dalam panggilan berikutnya ke IMAGE Search API untuk mendapatkan informasi tambahan tentang gambar. Untuk informasi tentang menggunakan token ini, lihat parameter kueri insightsToken . String
insightsSourcesSummary Hitungan jumlah situs web tempat Anda dapat berbelanja atau melakukan tindakan lain yang terkait dengan gambar.

Misalnya, jika gambarnya adalah pai apel, objek ini mencakup hitungan jumlah situs web tempat Anda dapat membeli pai apel. Anda kemudian dapat menyertakan lencana (misalnya, ikon keranjang belanja) dan hitungan untuk menunjukkan jumlah penawaran. Saat pengguna mengklik ikon, Anda bisa menggunakan imageInisghtsToken untuk mendapatkan daftar situs web.

Untuk informasi terkait tentang kapan menampilkan badging, lihat displayRecipeSourcesBadges dan displayShoppingSourcesBadges.		 InsightsSourcesSummary
Nama Judul gambar. String
gambar mini Lebar dan tinggi gambar mini (lihat thumbnailUrl). MediaSize
thumbnailUrl URL ke gambar mini gambar. Untuk informasi tentang mengubah ukuran gambar, lihat Mengubah ukuran dan memotong gambar mini. String
webSearchUrl URL ke hasil pencarian Bing untuk gambar ini. String
Lebar Lebar gambar sumber, dalam piksel. Pendek Tidak Ditandatangani

ImageCaption

Menentukan keterangan gambar.

Nama Nilai Jenis
Caption Keterangan tentang gambar. String
dataSourceUrl URL ke situs web tempat keterangan ditemukan. Anda harus mengaitkan keterangan ke sumber. Misalnya, tampilkan nama domain dari URL di samping keterangan dan gunakan URL untuk menautkan ke situs web sumber. String
relatedSearches Daftar entitas yang ditemukan dalam keterangan. Untuk membawa pengguna ke gambar entitas, gunakan tautan dalam Query objek . Kueri

ImageGallery

Menentukan tautan ke halaman web yang berisi kumpulan gambar terkait.

Nama Nilai Jenis
Pencipta Orang yang memiliki koleksi. Anda harus mengaitkan koleksi ke pembuat. Orang
Deskripsi Deskripsi koleksi. Deskripsi mungkin kosong. String
followersCount Jumlah pengguna di jejaring sosial yang mengikuti pembuatnya. Bilangan Bulat Tidak Bertanda
imagesCount Jumlah gambar terkait yang ditemukan dalam koleksi. Bilangan Bulat Tidak Bertanda
Sumber Penerbit atau jejaring sosial tempat gambar ditemukan. Anda harus mengaitkan penerbit sebagai sumber tempat koleksi ditemukan. String
thumbnailUrl URL ke gambar mini salah satu gambar yang ditemukan dalam koleksi. String
Url URL ke halaman web yang berisi kumpulan gambar terkait. String

ImageInsightsResponse

Objek tingkat atas yang disertakan respons saat permintaan wawasan gambar berhasil.

Untuk informasi tentang meminta wawasan gambar, lihat parameter kueri insightsToken .

Parameter kueri modulesRequested memengaruhi bidang yang Bing sertakan dalam respons. Jika Anda mengatur modulesRequested hanya ke Keterangan, maka objek ini hanya imageCaption menyertakan bidang .

Nama Nilai Jenis
_type Ketik petunjuk. String
bestRepresentativeQuery String kueri yang paling mewakili gambar. Mengklik tautan dalam Query objek, membawa pengguna ke halaman web dengan lebih banyak gambar gambar. Kueri
categoryClassification Daftar kategori yang mengidentifikasi karakteristik konten yang ditemukan dalam gambar. Misalnya, jika gambar adalah seseorang, anotasi mungkin menunjukkan jenis kelamin orang tersebut dan jenis pakaian yang mereka kenakan. CategoryClassification
imageCaption Keterangan yang digunakan untuk gambar. ImageCaption
imageInsightsToken Token yang Anda gunakan dalam panggilan berikutnya ke IMAGE Search API untuk mendapatkan informasi tambahan tentang gambar. Untuk informasi tentang menggunakan token ini, lihat parameter kueri insightsToken .

Token ini memiliki penggunaan yang sama dengan token yang disertakan dalam objek Gambar . Biasanya, Anda menggunakan token ini dalam skenario mengenali entitas tempat Anda mengirim Bing gambar dengan menggunakan parameter kueri imgUrl dan mengatur parameter modulesRequested ke RecognizedEntities. Respons mencakup entitas yang dikenali dan token wawasan yang dapat Anda gunakan untuk mendapatkan wawasan tambahan tentang gambar.

Jika Anda mengatur modulRequested ke Semua, Anda mendapatkan semua wawasan yang tersedia selain entitas yang dikenali (Anda tidak perlu menggunakan token wawasan dalam panggilan berikutnya).		 String
pagesIncluding Daftar halaman web yang berisi gambar. Untuk mengakses halaman web, gunakan URL di bidang gambar hostPageUrl . Gambar[]
recipes Daftar resep yang terkait dengan gambar. Misalnya, jika gambarnya adalah pai apel, daftar tersebut akan berisi resep untuk membuat pai apel. Resep[]
recognizedEntityGroups Daftar grup yang berisi gambar entitas yang cocok dengan entitas yang ditemukan dalam gambar yang ditentukan. Misalnya, respons mungkin menyertakan gambar dari grup selebriti umum jika entitas diakui dalam grup tersebut. recognizedEntityGroup[]
relatedCollections Daftar tautan ke halaman web yang berisi gambar terkait. ImageGallery[]
relatedSearches Daftar kueri terkait yang dibuat oleh orang lain. Kueri[]
shoppingSources Daftar pedagang yang menawarkan item yang terkait dengan gambar. Misalnya, jika gambarnya adalah pai apel, daftar tersebut akan berisi pedagang yang menjual pai apel. AggregateOffer[]
visuallySimilarImages Daftar gambar yang secara visual mirip dengan gambar asli. Misalnya, jika gambar yang ditentukan adalah matahari terbenam di atas badan air, daftar gambar serupa dari matahari terbenam lainnya di atas badan air.

Jika gambar yang ditentukan adalah seseorang, gambar serupa mungkin dari orang yang sama atau mereka mungkin dari orang yang berpakaian serupa atau dalam pengaturan yang sama.

Perhatikan bahwa kriteria kesamaan terus berkembang.		 Gambar[]
visuallySimilarProducts Daftar gambar yang berisi produk yang secara visual mirip dengan produk yang ditemukan dalam gambar asli. Misalnya, jika gambar yang ditentukan berisi gaun, daftar gambar serupa akan berisi gaun. ProductSummaryImage[]

Gambar

Objek tingkat atas yang disertakan respons saat permintaan gambar berhasil.

Nama Nilai Jenis
_type Ketik petunjuk. String
displayRecipeSourcesBadges Nilai Boolean yang menentukan apakah Anda harus menyertakan lencana untuk menunjukkan bahwa ada resep yang tersedia. Bing mengatur bendera ini ke true ketika yakin niat pengguna adalah untuk menemukan resep. Jika Bing tidak percaya niat pengguna adalah untuk menemukan resep, bendera ini diatur ke false.

Dimungkinkan untuk displayRecipeSourcesBadgesmenjadi false meskipun recipeSourcesCount bidang insightsSourcesSummary memiliki nilai yang lebih besar dari nol.

Bendera ini hanya menunjukkan niat pengguna. Biasanya, jika gambar recipeSourcesCount lebih besar dari nol dan displayRecipeSourcesBadgesbenar, Anda akan menampilkan lencana resep dan mengandalkan gambar. Jika tidak, jika displayRecipeSourcesBadgessalah, Anda tidak akan. Untuk aplikasi, Anda harus memutuskan cara menggunakan bidang ini untuk menentukan apakah akan menampilkan lencana.		 Boolean
displayShoppingSourcesBadges Nilai Boolean yang menentukan apakah Anda harus menyertakan badging (misalnya, ikon ke cart belanja) untuk menunjukkan bahwa ada sumber belanja yang tersedia. Bing menetapkan bendera ini ke true ketika yakin niat pengguna adalah untuk berbelanja. Jika Bing tidak percaya niat pengguna adalah untuk berbelanja, bendera ini diatur ke false.

Dimungkinkan untuk displayShoppingSourcesBadgesmenjadi false meskipun shoppingSourcesCount bidang insightsSourcesSummary memiliki nilai yang lebih besar dari nol.

Bendera ini hanya menunjukkan niat pengguna. Biasanya, jika gambar shoppingSourcesCount lebih besar dari nol dan displayShoppingSourcesBadgesbenar, Anda akan menampilkan lencana belanja dan mengandalkan gambar. Jika tidak, jika displayShoppingSourcesBadgessalah, Anda tidak akan. Untuk aplikasi, Anda harus memutuskan cara menggunakan bidang ini untuk menentukan apakah akan menampilkan lencana.		 Boolean
id ID yang secara unik mengidentifikasi jawaban gambar.

Objek menyertakan bidang ini hanya jika gambar disertakan sebagai bagian dari hasil pencarian API Pencarian Web. Untuk informasi tentang cara menggunakan bidang ini, lihat Menggunakan Peringkat untuk Menampilkan Hasil di panduan API Pencarian Web.		 String
isFamilyFriendly Nilai Boolean yang menentukan apakah satu atau beberapa gambar berisi konten dewasa. Jika tidak ada gambar yang berisi konten dewasa, isFamilyFriendly diatur ke true. Jika tidak, jika satu atau beberapa gambar berisi konten dewasa, isFamilyFriendly diatur ke false.

Jika false, gambar mini di-pixelated (fuzzy).

CATATAN: Bidang ini hanya disertakan dalam respons API Pencarian Web, bukan dalam respons API Pencarian Gambar.		 Boolean
nextOffsetAddCount Angka yang akan ditambahkan ke parameter kueri offset untuk memastikan bahwa Anda tidak menerima duplikat saat membuat halaman hasil.

Jika Anda mengatur offset ke 0 dan count ke 30 pada permintaan pertama Anda, lalu mengatur offset ke 30 pada permintaan kedua Anda, beberapa hasil dalam respons kedua mungkin duplikat respons pertama.

Untuk mencegah duplikat, tambahkan nilai nextOffsetAddCount ke jumlah count dan offset. Misalnya, jika nilai saat ini dan offsetcount adalah 30 dan nilainya nextOffsetAddCount adalah 9, atur offset ke 69 (hitungan + offset + nextOffsetAddCount).		 Bilangan bulat
pivotSuggestions Daftar segmen dalam kueri asli. Misalnya, jika kuerinya adalah Bunga Merah, Bing mungkin mensegmentasi kueri menjadi Merah dan Bunga.

Pivot Bunga mungkin berisi saran kueri seperti Peoni Merah dan Aster Merah, dan pivot Merah mungkin berisi saran kueri seperti Bunga Hijau dan Bunga Kuning.		 Pivot
queryExpansions Daftar kueri yang diperluas yang mempersempit kueri asli. Misalnya, jika kuerinya adalah Microsoft Surface, kueri yang diperluas mungkin: Microsoft Surface Pro 3, Microsoft Surface RT, Microsoft Surface Telepon, dan Microsoft Surface Hub. Kueri
readLink URL yang mengembalikan jawaban ini. Untuk menggunakan URL, Anda harus menambahkan parameter kueri yang sesuai dan menyertakan header Ocp-Apim-Subscription-Key .

Respons API Pencarian Gambar dan API Pencarian mencakup bidang ini. Biasanya, Anda akan menggunakan URL saat disertakan dalam respons Pencarian dan Anda ingin mengkueri IMAGE Search API secara langsung.		 String
totalEstimatedMatches Perkiraan jumlah gambar yang relevan dengan kueri. Gunakan nomor ini bersama dengan parameter kueri hitungan dan offset untuk halaman hasilnya.

Objek hanya menyertakan bidang ini saat memanggil IMAGE Search API. Objek tidak menyertakan bidang ini saat Anda memanggil WEB Search API.		 Long
value Daftar gambar yang relevan dengan kueri.

Jika tidak ada hasil, array kosong.		 Gambar[]
webSearchUrl URL ke Bing hasil pencarian untuk gambar yang diminta. String

InsightsSourcesSummary

Menentukan hitungan jumlah situs web tempat Anda dapat berbelanja atau melakukan tindakan lain yang terkait dengan gambar.

Elemen Deskripsi Jenis
recipeSourcesCount Jumlah situs web yang menawarkan resep yang terkait dengan subjek gambar. Bilangan Bulat Tidak Bertanda
shoppingSourcesCount Jumlah situs web yang menawarkan barang atau layanan yang terkait dengan subjek gambar. Bilangan Bulat Tidak Bertanda

MediaSize

Menentukan ukuran konten media.

Nama Nilai Jenis
tinggi Tinggi konten media, dalam piksel. Bilangan bulat
lebar Lebar konten media, dalam piksel. Bilangan bulat

NormalizedRectangle

Menentukan wilayah gambar. Wilayah ini ditentukan oleh koordinat sudut atas, kiri dan bawah, sudut kanan wilayah. Koordinat adalah nilai pecahan dari lebar dan tinggi gambar asli dalam rentang 0,0 hingga 1,0.

Nama Nilai Jenis
bottom Koordinat bawah. Mengambang
left Koordinat kiri. Mengambang
right Koordinat yang tepat Mengambang
teratas Koordinat teratas Mengambang

Penawaran

Mendefinisikan penawaran pedagang.

Objek ini digunakan oleh wawasan ShoppingSources dan wawasan SimilarProducts. Untuk wawasan yang diterapkan bidang, lihat deskripsi.

Elemen Deskripsi Jenis
agregatRating Peringkat agregat yang menunjukkan seberapa baik produk telah dinilai oleh orang lain.

Digunakan oleh SimilarProducts.		 Mengagregasi
ketersediaan Ketersediaan item yang ditawarkan. Berikut ini adalah nilai yang mungkin.
  • Dihentikan
  • InStock
  • InStoreOnly
  • LimitedAvailability
  • OnlineOnly
  • OutOfStock
  • Preorder
  • SoldOut

Digunakan oleh ShoppingSources.		 String
LowPrice Harga terendah untuk produk yang Bing temukan secara online.

Digunakan oleh SimilarProducts.		 Mengambang
nama Nama produk yang ditawarkan. String
offerCount Jumlah penawaran yang Bing temukan secara online.

Digunakan oleh SimilarProducts.		 Bilangan Bulat Tidak Bertanda
harga Harga di mana produk ditawarkan.

Digunakan oleh ShoppingSources.		 Mengambang
priceCurrency Mata uang moneter. Misalnya, USD. String
Penjual Nama pedagang.

Digunakan oleh ShoppingSources.		 Organisasi
url URL yang membawa pengguna ke penawaran di situs web pedagang.

Digunakan oleh ShoppingSources.		 String

Organisasi

Mendefinisikan informasi tentang pedagang.

Elemen Deskripsi Jenis
gambar Logo pedagang. Objek Image hanya url menyertakan bidang . Gambar
nama Nama pedagang. String

Orang

Mendefinisikan seseorang.

Nama Nilai Jenis
_type Ketik petunjuk. String
deskripsi Deskripsi singkat tentang orang tersebut String
gambar Gambar orang tersebut. Gambar
jabatan Jabatan orang tersebut String
nama Nama orang itu. String
url URL ke beranda jejaring sosial orang tersebut, jika berlaku. String
webSearchUrl URL yang membawa pengguna ke halaman hasil pencarian Bing untuk kueri yang berisi nama orang ini. String

Pivot

Menentukan segmen pivot.

Nama Nilai Jenis
Pivot Segmen dari kueri asli untuk dipivot. String
Saran Daftar kueri yang disarankan untuk pivot. Kueri

ProductSummaryImage

Menentukan gambar produk dan memberikan informasi ringkasan tentang penawaran yang Bing temukan secara online untuk produk.

Catatan

Karena format URL dan parameter dapat berubah tanpa pemberitahuan, semua URL harus digunakan apa adanya; Anda tidak boleh mengambil dependensi pada format atau parameter URL. Pengecualiannya adalah parameter dan nilai yang dibahas oleh Mengubah ukuran dan memangkas gambar mini.

Nama Nilai Jenis
accentColor Angka heksadesimal tiga byte yang mewakili warna yang mendominasi gambar. Klien dapat menggunakan warna sebagai latar belakang sementara hingga gambar dimuat. String
aggregateOffer Ringkasan penawaran yang Bing temukan secara online untuk produk dalam gambar. Misalnya, jika gambarnya adalah gaun, penawaran mengidentifikasi harga terendah dari gaun dan jumlah penawaran yang ditemukan. Penawaran
contentSize Ukuran file gambar. Format string adalah {size} {units}, di mana {units} dapat diatur ke B untuk byte, KB untuk Kilobyte, dan sebagainya. Misalnya, 12345 B menunjukkan bahwa ukuran gambar adalah 12.345 byte. String
contentUrl URL ke gambar di situs web sumber. String
datePublished Tanggal dan waktu yang Bing menemukan gambar. Tanggal dalam format, YYYY-MM-DDTHH:MM:SS. String
encodingFormat Jenis mime gambar (misalnya, jpeg). String
tinggi Tinggi gambar sumber, dalam piksel. Pendek Tidak Ditandatangani
hostPageDisplayUrl URL tampilan halaman web yang menghosting gambar.

Anda dapat menggunakan URL ini di antarmuka pengguna Anda untuk mengidentifikasi halaman web host yang berisi gambar. URL ini tidak terbentuk dengan baik sehingga jangan gunakan untuk mengakses halaman web host. URL tidak menyertakan protokol (misalnya, HTTP) dan dapat menyertakan karakter penyorotan temuan.. Untuk mengakses halaman web host, gunakan URL yang ditemukan di hostPageUrl properti .		 String
hostPageUrl URL halaman web yang menyertakan gambar.

URL ini dan contentUrl mungkin URL yang sama.		 String
id ID yang secara unik mengidentifikasi gambar ini dalam daftar gambar.

Objek Gambar hanya menyertakan bidang ini ketika gambar disertakan dalam hasil pencarian API Pencarian Web dan respons peringkat menentukan posisi tertentu untuk gambar. Untuk informasi tentang cara menggunakan bidang ini, lihat Menggunakan Peringkat untuk Menampilkan Hasil di panduan API Pencarian Web.		 String
imageId ID yang secara unik mengidentifikasi gambar ini dalam daftar gambar. Anda dapat menggunakan ID dalam permintaan berikutnya untuk memastikan bahwa gambar ini adalah gambar pertama yang dikembalikan dalam daftar gambar. Untuk memastikan bahwa gambar ini adalah gambar pertama dalam daftar, sertakan id parameter kueri dan atur ke ID gambar. String
imageInsightsToken Token yang Anda gunakan dalam panggilan berikutnya ke IMAGE Search API untuk mendapatkan informasi tambahan tentang gambar. Untuk informasi tentang menggunakan token ini, lihat parameter kueri insightsToken . String
insightsSourcesSummary Hitungan jumlah situs web tempat Anda dapat berbelanja atau melakukan tindakan lain yang terkait dengan gambar.

Misalnya, jika gambarnya adalah pai apel, objek ini mencakup hitungan jumlah situs web tempat Anda dapat membeli pai apel. Anda kemudian dapat menyertakan lencana (misalnya, ikon keranjang belanja) dan hitungan untuk menunjukkan jumlah penawaran. Saat pengguna mengklik ikon, Anda bisa menggunakan imageInisghtsToken untuk mendapatkan daftar situs web.

Untuk informasi terkait tentang kapan menampilkan badging, lihat displayRecipeSourcesBadges dan displayShoppingSourcesBadges.		 InsightsSourcesSummary
nama Judul gambar. String
gambar mini Lebar dan tinggi gambar mini (lihat thumbnailUrl). MediaSize
thumbnailUrl URL ke gambar mini gambar. Untuk informasi tentang mengubah ukuran gambar, lihat Mengubah ukuran dan memotong gambar mini. String
webSearchUrl URL ke hasil pencarian Bing untuk gambar ini. String
lebar Lebar gambar sumber, dalam piksel. Pendek Tidak Ditandatangani

Kueri

Menentukan string kueri pencarian.

Nama Nilai Jenis
tekstampak Versi tampilan string kueri.

Untuk kueri yang diperluas (lihat queryExpansions) dan saran pivot (lihat pivotSuggestions), bidang ini mengidentifikasi istilah yang memperluas kueri asli. Misalnya, jika kueri adalah Microsoft Surface dan kueri yang diperluas adalah Microsoft Surface RT, displayText akan berisi RT.		 String
searchLink URL yang Anda gunakan untuk mendapatkan hasil pencarian terkait. Sebelum menggunakan URL, Anda harus menambahkan parameter kueri yang sesuai dan menyertakan header Ocp-Apim-Subscription-Key .

Gunakan URL ini jika Anda menampilkan hasilnya di antarmuka pengguna Anda sendiri; jika tidak, gunakan webSearchUrl URL.		 String
teks String kueri. String
gambar mini URL ke gambar mini gambar terkait.

Objek mencakup bidang ini hanya untuk saran pivot dan pencarian terkait.		 Gambar mini
webSearchUrl URL yang membawa pengguna ke halaman hasil pencarian Bing untuk kueri.

Gunakan URL ini jika Anda tidak menampilkan hasilnya di antarmuka pengguna Anda sendiri; jika tidak, gunakan searchUrl URL.

Hanya disertakan untuk pencarian terkait.		 String

Resep

Mendefinisikan resep memasak.

Elemen Deskripsi Jenis
agregatRating Peringkat agregat yang menunjukkan seberapa baik resep telah dinilai oleh orang lain. AgregatRating
cookTime Jumlah waktu yang dibutuhkan makanan untuk dimasak. Misalnya, PT25M. Untuk informasi tentang format waktu, lihat Durasi pada Wikipedia.com. String
Pencipta Penulis resep. Orang
nama Nama resep. String
prepTime Jumlah waktu yang diperlukan untuk menyiapkan bahan-bahan. Misalnya, PT15M. Untuk informasi tentang format waktu, lihat Durasi pada Wikipedia.com. String
thumbnailUrl URL ke gambar mini dari makanan yang disiapkan. String
totalTime Jumlah total waktu yang diperlukan untuk menyiapkan dan memasak resep. Misalnya, PT45M. Untuk informasi tentang format waktu, lihat Durasi pada Wikipedia.com. String
url URL yang membawa pengguna ke halaman web yang berisi resep. String

RecognizedEntity

Mendefinisikan entitas yang dikenali.

Elemen Deskripsi Jenis
entitas Entitas yang dikenali.

Berikut ini adalah objek entitas yang mungkin.
 Object
matchConfidence Keyakinan bahwa Bing memiliki entitas dalam gambar cocok dengan entitas ini. Keyakinan berkisar antara 0,0 hingga 1,0 dengan 0,0 tidak percaya diri dan 1.0 percaya diri. Mengambang

RecognizedEntityGroup

Mendefinisikan sekelompok entitas yang dikenali sebelumnya.

Elemen Deskripsi Jenis
name Nama grup tempat gambar entitas juga ditemukan.

Berikut ini adalah grup yang mungkin.
  • CelebRecognitionAnnotations—Mirip dengan CelebrityAnnotations tetapi memberikan probabilitas yang lebih tinggi dari kecocokan yang akurat.

  • CelebrityAnnotations—Berisi selebriti seperti aktor, politisi, atlet, dan tokoh sejarah.
 String
recognizedEntityRegions Wilayah gambar yang berisi entitas. RecognizedEntityRegion[]

RecognizedEntityRegion

Menentukan wilayah gambar tempat entitas ditemukan dan daftar entitas yang mungkin cocok dengannya.

Elemen Deskripsi Jenis
matchingEntities Daftar entitas yang Bing yakini cocok dengan entitas yang ditemukan di wilayah tersebut. Entitas berada dalam urutan kepercayaan yang turun (lihat matchConfidence bidang RecognizedEntity). RecognizedEntity[]
wilayah Wilayah gambar yang berisi entitas.

Nilai persegi panjang relatif terhadap lebar dan tinggi gambar asli dan berada di rentang 0,0 hingga 1,0.

Misalnya, jika gambar adalah 300x200 dan sudut kiri atas wilayah berada pada titik (10, 20) dan sudut kanan bawah berada pada titik (290, 150), maka persegi panjang yang dinormalisasi adalah:

Kiri = 0,0333333333333333333

Atas = 0,1

Kanan = 0.9666666666666667

Bawah = 0,75

Bagi orang-orang, wilayah ini mewakili wajah orang tersebut.		 NormalizedRectangle

Gambar mini

Menentukan gambar mini gambar.

Elemen Deskripsi Jenis
url URL ke gambar mini gambar. String

Petak petak

Menentukan petak peta gambar.

Elemen Deskripsi Jenis
gambar URL ke gambar mini gambar. Gambar
query Kueri yang mengembalikan halaman hasil pencarian Bing dengan lebih banyak gambar subjek. Misalnya, jika kategorinya adalah Pencarian Orang Populer, thumbnail di image bidang akan menjadi orang yang populer. Untuk mengembalikan lebih banyak gambar orang tersebut, gunakan tautan dalam Query objek . Kueri

TrendingImages

Objek tingkat atas yang disertakan respons saat permintaan gambar yang sedang tren berhasil.

Elemen Deskripsi Jenis
Kategori Daftar yang mengidentifikasi kategori gambar dan daftar gambar yang sedang tren dalam kategori tersebut. Kategori[]

Kode kesalahan

Berikut ini adalah kemungkinan kode status HTTP yang dapat dikembalikan oleh permintaan.

Kode Status Deskripsi
200 Panggilan berhasil.
400 Salah satu parameter kueri hilang atau tidak valid.
401 Kunci langganan hilang atau tidak valid.
403 Pengguna diautentikasi (misalnya, menggunakan kunci langganan yang valid) tetapi mereka tidak memiliki izin ke sumber daya yang diminta.

Jika penelepon melebihi kuota kueri per bulan, Bing juga dapat mengembalikan status ini.
410 Permintaan yang digunakan HTTP, bukan protokol HTTPS. HTTPS adalah satu-satunya protokol yang didukung.
429 Penelepon melebihi kueri mereka per kuota kedua.

Jika permintaan gagal, isi respons akan berisi ErrorResponse objek . Objek respons akan menyertakan kode kesalahan dan deskripsi kesalahan. Jika kesalahan terkait dengan parameter, parameter bidang akan mengidentifikasi parameter yang menjadi masalah. Dan jika kesalahan terkait dengan nilai parameter, value bidang akan mengidentifikasi nilai yang tidak valid.

{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "RequestParameterMissing", 
      "message": "Required parameter is missing.", 
      "parameter": "q" 
    }
  ]
}


{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "AuthorizationMissing", 
      "message": "Authorization is required.", 
    }
  ]
}

Berikut ini adalah kemungkinan kode kesalahan.

Kode kesalahan Deskripsi
RequestParameterMissing Permintaan tidak memiliki parameter yang diperlukan. Bidang parameter mengidentifikasi parameter yang hilang.
RequestParameterInvalidValue Nilai parameter tidak valid. Bidang parameter mengidentifikasi parameter yang berisi nilai yang tidak valid, dan value bidang berisi nilai yang tidak valid.
ResourceAccessDenied Pemanggil tidak memiliki izin untuk mengakses sumber daya. Kesalahan ini dapat terjadi jika kunci langganan telah dinonaktifkan atau telah kedaluwarsa.
ExceededVolume Penelepon melebihi kuota kueri per bulan (QPM).
ExceededQpsLimit Penelepon melebihi kueri mereka per detik (QPS).
Nonaktifkan Pemanggil tidak memiliki izin untuk mengakses sumber daya.
UnexpectedError Terjadi kesalahan tak terduga pada server. Coba lagi nanti.
DataSourceErrors Terjadi kesalahan saat mengakses sumber daya.
AuthorizationMissing Bing tidak dapat mengautentikasi pemanggil. Kesalahan ini dapat terjadi jika Ocp-Apim-Subscription-Key header hilang.
HttpNotAllowed Permintaan menggunakan protokol HTTP alih-alih protokol HTTPS; Bing hanya mendukung HTTPS.
InvalidAuthorization Bing tidak dapat mengautentikasi pemanggil. Ini dapat terjadi jika kunci langganan tidak valid.
InsufficientScope Pemanggil tidak memiliki izin untuk mengakses sumber daya. Kesalahan ini dapat terjadi jika kunci langganan telah kedaluwarsa.

Kode pasar

Tabel berikut mencantumkan nilai kode pasar yang dapat Anda gunakan untuk menentukan mkt parameter kueri. Bing hanya akan menampilkan konten untuk pasar ini. Daftar ini dapat berubah.

Untuk daftar kode negara yang mungkin Anda tentukan dalam cc parameter kueri, lihat Kode negara.

Negara/Wilayah Bahasa Kode pasar
Argentina Spanyol es-AR
Australia Inggris en-AU
Austria Jerman de-AT
Belgia Belanda nl-BE
Belgia Prancis fr-BE
Brasil Portugis pt-BR
Kanada Inggris en-CA
Kanada Prancis fr-CA
Cile Spanyol es-CL
Denmark Dansk da-DK
Finlandia Suomi fi-FI
Prancis Prancis fr-FR
Jerman Jerman de-DE
Hong Kong SAR Mandarin Tradisional zh-HK
India Inggris en-IN
Indonesia Inggris en-ID
Italia Italia it-IT
Jepang Jepang ja-JP
Korea Korea ko-KR
Malaysia Inggris en-MY
Meksiko Spanyol es-MX
Belanda Belanda nl-NL
Selandia Baru Inggris en-NZ
Norwegia Norwegia no-NO
Republik Rakyat Tiongkok Mandarin zh-CN
Polandia Polski pl-PL
Republik Filipina Inggris en-PH
Rusia Rusia ru-RU
Afrika Selatan Inggris en-ZA
Spanyol Spanyol es-ES
Swedia Swedia sv-SE
Swiss Prancis fr-CH
Swiss Jerman de-CH
Taiwan Mandarin Tradisional zh-TW
Turki Turki tr-TR
Inggris Raya Inggris en-GB
Amerika Serikat Inggris en-US
Amerika Serikat Spanyol es-US

Kode negara

Berikut ini adalah kode negara yang dapat Anda tentukan dalam cc parameter kueri. Daftar ini dapat berubah.

Negara/Wilayah Kode Negara
Argentina AR
Australia AU
Austria AT
Belgia BE
Brasil BR
Kanada CA
Cile CL
Denmark DK
Finlandia FI
Prancis FR
Jerman DE
Hong Kong SAR HK
India IN
Indonesia ID
Italia IT
Jepang JP
Korea KR
Malaysia MY
Meksiko MX
Belanda NL
Selandia Baru NZ
Norwegia NO
Republik Rakyat Tiongkok CN
Polandia PL
Portugal PT
Republik Filipina PH
Rusia RU
Arab Saudi SA
Afrika Selatan ZA
Spanyol ES
Swedia SE
Swiss CH
Taiwan TW
Turki TR
Inggris Raya GB
Amerika Serikat US