Images - Visual Search

  • Referensi
Service:
Cognitive Services
API Version:
1.0

Visual Search API memungkinkan Anda menemukan wawasan tentang gambar seperti gambar yang mirip secara visual, sumber belanja, dan pencarian terkait. API juga dapat melakukan pengenalan teks, mengidentifikasi entitas (orang, tempat, hal-hal), mengembalikan konten topikal lainnya untuk dijelajahi pengguna, dan banyak lagi. Untuk informasi selengkapnya, lihat Gambaran Umum Pencarian Visual.

POST {Endpoint}/bing/v7.0/images/visualsearch
With optional parameters: 
POST {Endpoint}/bing/v7.0/images/visualsearch?mkt={mkt}&safeSearch={safeSearch}&setLang={setLang}

Parameter URI

Name In Required Type Description
Endpoint
 path True
  • string

Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: "https://westus.api.cognitive.microsoft.com", "https://api.cognitive.microsoft.com").
mkt
 query
  • string

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 -. 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.
safeSearch
 query

Filter gambar menghasilkan tindakan dengan jenis 'VisualSearch' untuk konten dewasa. Berikut ini adalah kemungkinan nilai filter. Nonaktif: Dapat mengembalikan gambar dengan konten dewasa. Sedang: Jangan mengembalikan gambar dengan konten dewasa. Ketat: Jangan mengembalikan gambar dengan konten dewasa. Defaultnya adalah Moderate. Jika permintaan berasal dari pasar yang Bing kebijakan dewasa mengharuskan safeSearch diatur ke Ketat, Bing mengabaikan nilai safeSearch dan menggunakan Strict. Jika Anda menggunakan situs: filter dalam permintaan pengetahuan, ada kemungkinan respons mungkin berisi konten dewasa terlepas dari apa parameter kueri safeSearch diatur ke. Gunakan situs: hanya jika Anda mengetahui konten di situs dan skenario Anda mendukung kemungkinan konten dewasa.
setLang
 query
  • string

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 yang ditentukan oleh mkt kecuali pengguna ingin string antarmuka pengguna ditampilkan dalam bahasa yang berbeda. 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.

Header Permintaan

Media Types: "multipart/form-data", "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string
X-BingApis-SDK True

Mengaktifkan kepatuhan swagger.
Accept
  • string

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

Daftar yang dibatasi koma dari satu atau beberapa bahasa yang akan digunakan untuk string antarmuka pengguna. Daftar ini dalam urutan preferensi yang menurun. Untuk informasi tambahan, 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 nilai parameter cc. 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.
Content-Type
  • string

Harus diatur ke multipart/form-data dan menyertakan parameter batas (misalnya, multipart/form-data; boundary=). Untuk detail selengkapnya, lihat Jenis formulir konten.
User-Agent
  • string

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; Sentuh; NOKIA; Lumia 822). Android: Mozilla / 5.0 (Linux; U; Android 2.3.5; en - kami; SCH - I500 Build / GINGERBREAD) AppleWebKit / 533.1 (KHTML; seperti Gecko) Versi / 4.0 Safari Seluler / 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; Sentuh; 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
  • string

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. 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. 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. Bing respons 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. PERHATIAN: Anda harus memastikan bahwa ID Klien ini tidak dapat ditautkan ke informasi akun pengguna yang dapat diautentikasi. Jika Anda menyertakan X-MSEdge-ClientID, Anda tidak boleh menyertakan cookie dalam permintaan.
X-MSEdge-ClientIP
  • string

Alamat IPv4 atau IPv6 perangkat klien. Alamat IP digunakan untuk menemukan lokasi pengguna. Bing menggunakan informasi lokasi untuk menentukan perilaku pencarian yang aman. 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
  • string

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 :. Berikut adalah kunci yang Anda gunakan untuk menentukan lokasi pengguna. lat (wajib): 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. panjang (diperlukan): Garis 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 (wajib): 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): UTC UNIX tanda waktu saat klien berada di lokasi tersebut. (Tanda waktu UNIX adalah jumlah detik sejak 1 Januari 1970.) kepala (opsional): Judul relatif klien atau arah perjalanan. 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, yang dilalui perangkat klien. alt (opsional): Ketinggian perangkat klien, dalam meter. adalah (opsional): Radius, dalam meter, yang menentukan akurasi vertikal koordinat. Tentukan kunci ini hanya jika Anda menentukan kunci alt. Meskipun banyak kunci bersifat opsional, semakin banyak informasi yang Anda berikan, semakin akurat hasil lokasinya. 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-MSEdge-ClientIP, tetapi minimal, Anda harus menyertakan header ini.

Respons

Name Type Description
200 OK

Berhasil.
Other Status Codes

Terjadi kesalahan. Periksa jenis respons dan/atau kode status untuk detail selengkapnya.

Keamanan

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Contoh

Sample Request

POST {Endpoint}/bing/v7.0/images/visualsearch

Sample Response

Status code:
200 
{
  "_type": "ImageKnowledge",
  "tags": [
    {
      "image": {
        "thumbnailUrl": "https://tse4.mm.bing.net/th?q=Space+Needle&pid=Api&mkt=en-US&adlt=moderate"
      },
      "displayName": "Space Needle",
      "boundingBox": {
        "queryRectangle": {
          "topLeft": {
            "x": 0,
            "y": 0
          },
          "topRight": {
            "x": 1,
            "y": 0
          },
          "bottomRight": {
            "x": 1,
            "y": 1
          },
          "bottomLeft": {
            "x": 0,
            "y": 1
          }
        },
        "displayRectangle": {
          "topLeft": {
            "x": 0,
            "y": 0
          },
          "topRight": {
            "x": 1,
            "y": 0
          },
          "bottomRight": {
            "x": 1,
            "y": 1
          },
          "bottomLeft": {
            "x": 0,
            "y": 1
          }
        }
      },
      "actions": [
        {
          "_type": "ImageAction",
          "actionType": "ImageById",
          "image": {
            "webSearchUrl": "https://www.bing.com/images/search?view=detailv2&FORM=OIIRPO",
            "name": "",
            "contentUrl": "https://assets0.roadtrippers.com/uploads/poi_gallery_image/image/319703805/-quality_60_-interlace_Plane_-resize_1024x480_U__-gravity_center_-extent_1024x480/poi_gallery_image-image-9e436dcb-f4af-4965-9fd6-d526b1af1758.jpg",
            "hostPageUrl": "https://assets0.roadtrippers.com/uploads/poi_gallery_image/image/319703805/-quality_60_-interlace_Plane_-resize_1024x480_U__-gravity_center_-extent_1024x480/poi_gallery_image-image-9e436dcb-f4af-4965-9fd6-d526b1af1758.jpg",
            "contentSize": "47157 B",
            "encodingFormat": "jpeg",
            "hostPageDisplayUrl": "https://assets0.roadtrippers.com/uploads/poi_gallery_image/image/319703805/-quality_60_-interlace_Plane_-resize_1024x480_U__-gravity_center_-extent_1024x480/poi_gallery_image-image-9e436dcb-f4af-4965-9fd6-d526b1af1758.jpg",
            "width": 1024,
            "height": 480,
            "thumbnail": {
              "width": 0,
              "height": 0
            },
            "accentColor": "31749A"
          }
        }
      ]
    },
    {
      "image": {
        "thumbnailUrl": "https://tse4.mm.bing.net/th?q=city&pid=Api&mkt=en-US&adlt=moderate"
      },
      "displayName": "city",
      "boundingBox": {
        "queryRectangle": {
          "topLeft": {
            "x": 0,
            "y": 0
          },
          "topRight": {
            "x": 1,
            "y": 0
          },
          "bottomRight": {
            "x": 1,
            "y": 1
          },
          "bottomLeft": {
            "x": 0,
            "y": 1
          }
        },
        "displayRectangle": {
          "topLeft": {
            "x": 0,
            "y": 0
          },
          "topRight": {
            "x": 1,
            "y": 0
          },
          "bottomRight": {
            "x": 1,
            "y": 1
          },
          "bottomLeft": {
            "x": 0,
            "y": 1
          }
        }
      },
      "actions": [
        {
          "_type": "ImageAction",
          "webSearchUrl": "https://www.bing.com/images/search?q=city",
          "displayName": "city",
          "serviceUrl": "https://www.bing.com/api/v7/images/search?q=city",
          "actionType": "ImageResults"
        }
      ]
    }
  ],
  "image": {
    "imageInsightsToken": "ccid_5raYvpmc*mid_28189CE73748FE8CB0AB80F7B377C4DA64EA132E"
  }
}

Definisi

AggregateOffer

Mendefinisikan daftar penawaran dari pedagang yang terkait dengan gambar.
AggregateRating

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

Mata uang moneter. Misalnya, USD.
Error

Mendefinisikan kesalahan yang terjadi.
ErrorCode

Kode kesalahan yang mengidentifikasi kategori kesalahan.
ErrorResponse

Respons tingkat atas yang mewakili permintaan yang gagal.
ErrorSubCode

Kode kesalahan yang selanjutnya membantu mengidentifikasi kesalahan.
ImageEntityAction

Menentukan tindakan entitas.
ImageKnowledge

Menentukan respons API pencarian visual.
ImageModuleAction

Menentukan tindakan daftar gambar.
ImageObject

Mendefinisikan gambar.
ImageRecipesAction

Mendefinisikan tindakan resep.
ImageRelatedSearchesAction

Menentukan tindakan pencarian terkait.
ImageShoppingSourcesAction

Menentukan tindakan sumber belanja.
ImagesImageMetadata

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

Menentukan daftar gambar.
ImageTag

Tag pencarian visual.
ImageTagRegion

Menentukan wilayah gambar yang relevan dengan ImageTag.
ItemAvailability

Ketersediaan item. Berikut ini adalah nilai yang mungkin: Dihentikan, InStock, InStoreOnly, LimitedAvailability, OnlineOnly, OutOfStock, PreOrder, SoldOut.
NormalizedQuadrilateral

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

Mendefinisikan penawaran pedagang.
Organization

Mendefinisikan organisasi.
Point2D

Menentukan titik 2D dengan koordinat X dan Y.
Query

Menentukan kueri pencarian.
Recipe

Mendefinisikan resep memasak.
RecipesModule

Mendefinisikan daftar resep.
RelatedSearchesModule

Menentukan daftar pencarian terkait.
SafeSearch

Filter hasil gambar dalam tindakan dengan jenis 'VisualSearch' untuk konten dewasa. Berikut ini adalah kemungkinan nilai filter. Nonaktif: Dapat mengembalikan gambar dengan konten dewasa. Sedang: Jangan mengembalikan gambar dengan konten dewasa. Ketat: Jangan mengembalikan gambar dengan konten dewasa. Defaultnya adalah Moderate. Jika permintaan berasal dari pasar yang Bing kebijakan dewasa mengharuskan safeSearch diatur ke Ketat, Bing mengabaikan nilai safeSearch dan menggunakan Strict. Jika Anda menggunakan situs: filter dalam permintaan pengetahuan, ada kemungkinan respons dapat berisi konten dewasa terlepas dari apa parameter kueri safeSearch diatur ke. Gunakan situs: hanya jika Anda mengetahui konten di situs dan skenario Anda mendukung kemungkinan konten dewasa.
Thing

Mendefinisikan sesuatu.
XBingApisSDK

Mengaktifkan kepatuhan swagger.

AggregateOffer

Mendefinisikan daftar penawaran dari pedagang yang terkait dengan gambar.

Name Type Default Value Description
aggregateRating

Peringkat agregat yang menunjukkan seberapa baik produk telah dinilai oleh orang lain.
availability

Ketersediaan item. Berikut ini adalah nilai yang mungkin: Dihentikan, InStock, InStoreOnly, LimitedAvailability, OnlineOnly, OutOfStock, PreOrder, SoldOut.
lastUpdated
  • string

Tanggal terakhir penawaran diperbarui. Tanggal dalam bentuk YYYY-MM-DD.
offers

Daftar penawaran dari pedagang yang memiliki penawaran yang terkait dengan gambar.
price
  • number

Harga item.
priceCurrency USD

Mata uang moneter. Misalnya, USD.
seller

Penjual untuk penawaran ini.

AggregateRating

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

Name Type Description
_type string:
  • Properties/Item
bestRating
  • number

Ulasan berperingkat tertinggi. Nilai yang mungkin adalah 1,0 hingga 5,0.
ratingValue
  • number

Peringkat rata-rata (rata-rata). Nilai yang mungkin adalah 1,0 hingga 5,0.
reviewCount
  • integer

Berapa kali resep telah dinilai atau ditinjau.
text
  • string

Representasi teks item.

Currency

Mata uang moneter. Misalnya, USD.

Name Type Description
AED
  • string
AFN
  • string
ALL
  • string
AMD
  • string
ANG
  • string
AOA
  • string
ARS
  • string
AUD
  • string
AWG
  • string
AZN
  • string
BAM
  • string
BBD
  • string
BDT
  • string
BGN
  • string
BHD
  • string
BIF
  • string
BMD
  • string
BND
  • string
BOB
  • string
BOV
  • string
BRL
  • string
BSD
  • string
BTN
  • string
BWP
  • string
BYR
  • string
BZD
  • string
CAD
  • string
CDF
  • string
CHE
  • string
CHF
  • string
CHW
  • string
CLF
  • string
CLP
  • string
CNY
  • string
COP
  • string
COU
  • string
CRC
  • string
CUC
  • string
CUP
  • string
CVE
  • string
CZK
  • string
DJF
  • string
DKK
  • string
DOP
  • string
DZD
  • string
EGP
  • string
ERN
  • string
ETB
  • string
EUR
  • string
FJD
  • string
FKP
  • string
GBP
  • string
GEL
  • string
GHS
  • string
GIP
  • string
GMD
  • string
GNF
  • string
GTQ
  • string
GYD
  • string
HKD
  • string
HNL
  • string
HRK
  • string
HTG
  • string
HUF
  • string
IDR
  • string
ILS
  • string
INR
  • string
IQD
  • string
IRR
  • string
ISK
  • string
JMD
  • string
JOD
  • string
JPY
  • string
KES
  • string
KGS
  • string
KHR
  • string
KMF
  • string
KPW
  • string
KRW
  • string
KWD
  • string
KYD
  • string
KZT
  • string
LAK
  • string
LBP
  • string
LKR
  • string
LRD
  • string
LSL
  • string
LYD
  • string
MAD
  • string
MDL
  • string
MGA
  • string
MKD
  • string
MMK
  • string
MNT
  • string
MOP
  • string
MRO
  • string
MUR
  • string
MVR
  • string
MWK
  • string
MXN
  • string
MXV
  • string
MYR
  • string
MZN
  • string
NAD
  • string
NGN
  • string
NIO
  • string
NOK
  • string
NPR
  • string
NZD
  • string
OMR
  • string
PAB
  • string
PEN
  • string
PGK
  • string
PHP
  • string
PKR
  • string
PLN
  • string
PYG
  • string
QAR
  • string
RON
  • string
RSD
  • string
RUB
  • string
RWF
  • string
SAR
  • string
SBD
  • string
SCR
  • string
SDG
  • string
SEK
  • string
SGD
  • string
SHP
  • string
SLL
  • string
SOS
  • string
SRD
  • string
SSP
  • string
STD
  • string
SYP
  • string
SZL
  • string
THB
  • string
TJS
  • string
TMT
  • string
TND
  • string
TOP
  • string
TRY
  • string
TTD
  • string
TWD
  • string
TZS
  • string
UAH
  • string
UGX
  • string
USD
  • string
UYU
  • string
UZS
  • string
VEF
  • string
VND
  • string
VUV
  • string
WST
  • string
XAF
  • string
XCD
  • string
XOF
  • string
XPF
  • string
YER
  • string
ZAR
  • string
ZMW
  • string

Error

Mendefinisikan kesalahan yang terjadi.

Name Type Default Value Description
code None

Kode kesalahan yang mengidentifikasi kategori kesalahan.
message
  • string

Deskripsi kesalahan.
moreDetails
  • string

Deskripsi yang menyediakan informasi tambahan tentang kesalahan tersebut.
parameter
  • string

Parameter dalam permintaan yang menyebabkan kesalahan.
subCode

Kode kesalahan yang selanjutnya membantu mengidentifikasi kesalahan.
value
  • string

Nilai parameter dalam permintaan yang tidak valid.

ErrorCode

Kode kesalahan yang mengidentifikasi kategori kesalahan.

Name Type Description
InsufficientAuthorization
  • string
InvalidAuthorization
  • string
InvalidRequest
  • string
None
  • string
RateLimitExceeded
  • string
ServerError
  • string

ErrorResponse

Respons tingkat atas yang mewakili permintaan yang gagal.

Name Type Description
_type
  • string
errors

Daftar kesalahan yang menjelaskan alasan permintaan gagal.
id
  • string

Pengidentifikasi string.
readLink
  • string

URL yang mengembalikan sumber daya ini. Untuk menggunakan URL, tambahkan parameter kueri yang sesuai dan sertakan header Ocp-Apim-Subscription-Key.
webSearchUrl
  • string

URL untuk Bing hasil pencarian untuk item ini.

ErrorSubCode

Kode kesalahan yang selanjutnya membantu mengidentifikasi kesalahan.

Name Type Description
AuthorizationDisabled
  • string
AuthorizationExpired
  • string
AuthorizationMissing
  • string
AuthorizationRedundancy
  • string
Blocked
  • string
HttpNotAllowed
  • string
NotImplemented
  • string
ParameterInvalidValue
  • string
ParameterMissing
  • string
ResourceError
  • string
UnexpectedError
  • string

ImageEntityAction

Menentukan tindakan entitas.

Name Type Description
_type string:

Menentukan sub-kelas tindakan.
actionType
  • string

String yang mewakili jenis tindakan.
datePublished
  • string

Tanggal di mana CreativeWork diterbitkan.
displayName
  • string

Nama tampilan untuk tindakan tersebut.
isTopAction
  • boolean

Boolean yang mewakili apakah hasil ini adalah tindakan teratas.
provider

Sumber karya kreatif.
result

Hasil yang dihasilkan dalam tindakan.
serviceUrl
  • string

Gunakan URL ini untuk mendapatkan data tambahan untuk menentukan cara mengambil tindakan yang sesuai. Misalnya, serviceUrl mungkin mengembalikan JSON bersama dengan URL gambar.
text
  • string

Konten teks karya kreatif ini.
thumbnailUrl
  • string

URL ke gambar mini item.

ImageKnowledge

Menentukan respons API pencarian visual.

Name Type Description
_type
  • string
id
  • string

Pengidentifikasi string.
image

Objek gambar yang berisi metadata tentang gambar yang diminta.
readLink
  • string

URL yang mengembalikan sumber daya ini. Untuk menggunakan URL, tambahkan parameter kueri yang sesuai dan sertakan header Ocp-Apim-Subscription-Key.
tags

Daftar tag pencarian visual.
webSearchUrl
  • string

URL untuk Bing hasil pencarian untuk item ini.

ImageModuleAction

Menentukan tindakan daftar gambar.

Name Type Description
_type string:

Menentukan sub-kelas tindakan.
actionType
  • string

String yang mewakili jenis tindakan.
data

Daftar gambar.
datePublished
  • string

Tanggal di mana CreativeWork diterbitkan.
displayName
  • string

Nama tampilan untuk tindakan tersebut.
isTopAction
  • boolean

Boolean yang mewakili apakah hasil ini adalah tindakan teratas.
provider

Sumber karya kreatif.
result

Hasil yang dihasilkan dalam tindakan.
serviceUrl
  • string

Gunakan URL ini untuk mendapatkan data tambahan untuk menentukan cara mengambil tindakan yang sesuai. Misalnya, serviceUrl mungkin mengembalikan JSON bersama dengan URL gambar.
text
  • string

Konten teks karya kreatif ini.
thumbnailUrl
  • string

URL ke gambar mini item.

ImageObject

Mendefinisikan gambar.

Name Type Description
accentColor
  • string

Angka heksadesimal tiga byte yang mewakili warna yang mendominasi gambar. Gunakan warna sebagai latar belakang sementara di klien Anda hingga gambar dimuat.
contentSize
  • string

Ukuran konten objek media. Gunakan format "unit nilai" (misalnya, "1024 B").
contentUrl
  • string

URL asli untuk mengambil sumber (file) untuk objek media (misalnya, URL sumber untuk gambar).
datePublished
  • string

Tanggal di mana CreativeWork diterbitkan.
encodingFormat
  • string

Format pengodean (misalnya, png, gif, jpeg, dll).
height
  • integer

Tinggi objek media, dalam piksel.
hostPageDisplayUrl
  • string

Tampilkan URL halaman yang menghosting objek media.
hostPageUrl
  • string

URL halaman yang menghosting objek media.
imageId
  • string

Id unik untuk gambar.
imageInsightsToken
  • string

Token yang Anda gunakan dalam panggilan berikutnya ke Visual Search API untuk mendapatkan informasi tambahan tentang gambar. Untuk informasi tentang menggunakan token ini, lihat bidang imageInsightsToken di dalam parameter permintaan knowledgeRequest.
insightsMetadata

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. Untuk menunjukkan jumlah penawaran di UX Anda, sertakan lencana seperti ikon keranjang belanja yang berisi hitungan. Saat pengguna mengklik ikon, gunakan imageInsightsToken dalam panggilan VISUAL Search API berikutnya untuk mendapatkan daftar situs web belanja.
provider

Sumber karya kreatif.
text
  • string

Konten teks karya kreatif ini.
thumbnail

URL ke gambar mini gambar.
thumbnailUrl
  • string

URL ke gambar mini item.
visualWords
  • string

Hanya untuk penggunaan internal.
width
  • integer

Lebar objek media, dalam piksel.

ImageRecipesAction

Mendefinisikan tindakan resep.

Name Type Description
_type string:

Menentukan sub-kelas tindakan.
actionType
  • string

String yang mewakili jenis tindakan.
data

Daftar resep yang terkait dengan gambar.
datePublished
  • string

Tanggal di mana CreativeWork diterbitkan.
displayName
  • string

Nama tampilan untuk tindakan tersebut.
isTopAction
  • boolean

Boolean yang mewakili apakah hasil ini adalah tindakan teratas.
provider

Sumber karya kreatif.
result

Hasil yang dihasilkan dalam tindakan.
serviceUrl
  • string

Gunakan URL ini untuk mendapatkan data tambahan untuk menentukan cara mengambil tindakan yang sesuai. Misalnya, serviceUrl mungkin mengembalikan JSON bersama dengan URL gambar.
text
  • string

Konten teks karya kreatif ini.
thumbnailUrl
  • string

URL ke gambar mini item.

ImageRelatedSearchesAction

Menentukan tindakan pencarian terkait.

Name Type Description
_type string:

Menentukan sub-kelas tindakan.
actionType
  • string

String yang mewakili jenis tindakan.
data

Daftar kueri yang terkait dengan gambar.
datePublished
  • string

Tanggal di mana CreativeWork diterbitkan.
displayName
  • string

Nama tampilan untuk tindakan tersebut.
isTopAction
  • boolean

Boolean yang mewakili apakah hasil ini adalah tindakan teratas.
provider

Sumber karya kreatif.
result

Hasil yang dihasilkan dalam tindakan.
serviceUrl
  • string

Gunakan URL ini untuk mendapatkan data tambahan untuk menentukan cara mengambil tindakan yang sesuai. Misalnya, serviceUrl mungkin mengembalikan JSON bersama dengan URL gambar.
text
  • string

Konten teks karya kreatif ini.
thumbnailUrl
  • string

URL ke gambar mini item.

ImageShoppingSourcesAction

Menentukan tindakan sumber belanja.

Name Type Description
_type string:

Menentukan sub-kelas tindakan.
actionType
  • string

String yang mewakili jenis tindakan.
data

Daftar pedagang yang menawarkan item yang terkait dengan gambar.
datePublished
  • string

Tanggal di mana CreativeWork diterbitkan.
displayName
  • string

Nama tampilan untuk tindakan tersebut.
isTopAction
  • boolean

Boolean yang mewakili apakah hasil ini adalah tindakan teratas.
provider

Sumber karya kreatif.
result

Hasil yang dihasilkan dalam tindakan.
serviceUrl
  • string

Gunakan URL ini untuk mendapatkan data tambahan untuk menentukan cara mengambil tindakan yang sesuai. Misalnya, serviceUrl mungkin mengembalikan JSON bersama dengan URL gambar.
text
  • string

Konten teks karya kreatif ini.
thumbnailUrl
  • string

URL ke gambar mini item.

ImagesImageMetadata

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

Name Type Description
aggregateOffer

Ringkasan penawaran online produk yang ditemukan dalam gambar. Misalnya, jika gambarnya adalah gaun, penawaran mungkin mengidentifikasi harga terendah dan jumlah penawaran yang ditemukan. Hanya wawasan produk yang mirip secara visual yang mencakup bidang ini. Penawaran ini mencakup bidang berikut: Nama, AgregatRating, OfferCount, dan LowPrice.
recipeSourcesCount
  • integer

Jumlah situs web yang menawarkan resep makanan yang terlihat dalam gambar.
shoppingSourcesCount
  • integer

Jumlah situs web yang menjual produk yang terlihat dalam gambar.

ImagesModule

Menentukan daftar gambar.

Name Type Description
value

Daftar gambar.

ImageTag

Tag pencarian visual.

Name Type Description
_type
  • string
actions ImageAction[]:

Tindakan dalam tag ini. Urutan item menunjukkan urutan peringkat default tindakan ini, dengan tindakan pertama menjadi niat pengguna yang paling mungkin.
alternateName
  • string

Alias untuk item.
bingId
  • string

ID yang secara unik mengidentifikasi item ini.
boundingBox

Kotak pembatas untuk tag ini. Untuk tag default, tidak ada kotak pembatas.
description
  • string

Deskripsi singkat tentang item.
displayName
  • string

Nama tampilan untuk tag ini. Untuk tag default, nama tampilan kosong.
id
  • string

Pengidentifikasi string.
image

Gambar item.
name
  • string

Nama benda yang diwakili oleh objek ini.
readLink
  • string

URL yang mengembalikan sumber daya ini. Untuk menggunakan URL, tambahkan parameter kueri yang sesuai dan sertakan header Ocp-Apim-Subscription-Key.
url
  • string

URL untuk mendapatkan informasi lebih lanjut tentang hal yang diwakili oleh objek ini.
webSearchUrl
  • string

URL untuk Bing hasil pencarian untuk item ini.

ImageTagRegion

Menentukan wilayah gambar yang relevan dengan ImageTag.

Name Type Description
displayRectangle

Persegi panjang yang direkomendasikan untuk ditampilkan kepada pengguna.
queryRectangle

Persegi panjang yang menguraikan area yang menarik untuk tag ini.

ItemAvailability

Ketersediaan item. Berikut ini adalah nilai yang mungkin: Dihentikan, InStock, InStoreOnly, LimitedAvailability, OnlineOnly, OutOfStock, PreOrder, SoldOut.

Name Type Description
Discontinued
  • string
InStock
  • string
InStoreOnly
  • string
LimitedAvailability
  • string
OnlineOnly
  • string
OutOfStock
  • string
PreOrder
  • string
SoldOut
  • string

NormalizedQuadrilateral

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

Name Type Description
_type
  • string
alternateName
  • string

Alias untuk item.
bingId
  • string

ID yang secara unik mengidentifikasi item ini.
bottomLeft

Koordinat sudut kiri bawah.
bottomRight

Koordinat sudut kanan bawah.
description
  • string

Deskripsi singkat tentang item.
id
  • string

Pengidentifikasi string.
image

Gambar item.
name
  • string

Nama benda yang diwakili oleh objek ini.
readLink
  • string

URL yang mengembalikan sumber daya ini. Untuk menggunakan URL, tambahkan parameter kueri yang sesuai dan sertakan header Ocp-Apim-Subscription-Key.
topLeft

Koordinat sudut kiri atas.
topRight

Koordinat sudut kanan atas.
url
  • string

URL untuk mendapatkan informasi lebih lanjut tentang hal yang diwakili oleh objek ini.
webSearchUrl
  • string

URL untuk Bing hasil pencarian untuk item ini.

Offer

Mendefinisikan penawaran pedagang.

Name Type Default Value Description
_type
  • string
aggregateRating

Peringkat agregat yang menunjukkan seberapa baik produk telah dinilai oleh orang lain.
alternateName
  • string

Alias untuk item.
availability

Ketersediaan item. Berikut ini adalah nilai yang mungkin: Dihentikan, InStock, InStoreOnly, LimitedAvailability, OnlineOnly, OutOfStock, PreOrder, SoldOut.
bingId
  • string

ID yang secara unik mengidentifikasi item ini.
description
  • string

Deskripsi singkat tentang item.
id
  • string

Pengidentifikasi string.
image

Gambar item.
lastUpdated
  • string

Tanggal terakhir penawaran diperbarui. Tanggal dalam bentuk YYYY-MM-DD.
name
  • string

Nama benda yang diwakili oleh objek ini.
price
  • number

Harga item.
priceCurrency USD

Mata uang moneter. Misalnya, USD.
readLink
  • string

URL yang mengembalikan sumber daya ini. Untuk menggunakan URL, tambahkan parameter kueri yang sesuai dan sertakan header Ocp-Apim-Subscription-Key.
seller

Penjual untuk penawaran ini.
url
  • string

URL untuk mendapatkan informasi lebih lanjut tentang hal yang diwakili oleh objek ini.
webSearchUrl
  • string

URL untuk Bing hasil pencarian untuk item ini.

Organization

Mendefinisikan organisasi.

Name Type Description
_type
  • string
alternateName
  • string

Alias untuk item.
bingId
  • string

ID yang secara unik mengidentifikasi item ini.
description
  • string

Deskripsi singkat tentang item.
id
  • string

Pengidentifikasi string.
image

Gambar item.
name
  • string

Nama benda yang diwakili oleh objek ini.
readLink
  • string

URL yang mengembalikan sumber daya ini. Untuk menggunakan URL, tambahkan parameter kueri yang sesuai dan sertakan header Ocp-Apim-Subscription-Key.
url
  • string

URL untuk mendapatkan informasi lebih lanjut tentang hal yang diwakili oleh objek ini.
webSearchUrl
  • string

URL untuk Bing hasil pencarian untuk item ini.

Point2D

Menentukan titik 2D dengan koordinat X dan Y.

Name Type Description
_type
  • string
alternateName
  • string

Alias untuk item.
bingId
  • string

ID yang secara unik mengidentifikasi item ini.
description
  • string

Deskripsi singkat tentang item.
id
  • string

Pengidentifikasi string.
image

Gambar item.
name
  • string

Nama benda yang diwakili oleh objek ini.
readLink
  • string

URL yang mengembalikan sumber daya ini. Untuk menggunakan URL, tambahkan parameter kueri yang sesuai dan sertakan header Ocp-Apim-Subscription-Key.
url
  • string

URL untuk mendapatkan informasi lebih lanjut tentang hal yang diwakili oleh objek ini.
webSearchUrl
  • string

URL untuk Bing hasil pencarian untuk item ini.
x
  • number

Koordinat x titik.
y
  • number

Koordinat y titik.

Query

Menentukan kueri pencarian.

Name Type Description
displayText
  • string

Versi tampilan istilah kueri.
searchLink
  • string

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 URL webSearchUrl.
text
  • string

String kueri. Gunakan string ini sebagai istilah kueri dalam permintaan pencarian baru.
thumbnail

URL ke gambar mini gambar terkait.
webSearchUrl
  • string

URL yang membawa pengguna ke halaman hasil pencarian Bing untuk kueri.

Recipe

Mendefinisikan resep memasak.

Name Type Description
cookTime
  • string

Jumlah waktu yang dibutuhkan makanan untuk memasak. Misalnya, PT25M. Untuk informasi tentang format waktu, lihat http://en.wikipedia.org/wiki/ISO_8601#Durations.
datePublished
  • string

Tanggal di mana CreativeWork diterbitkan.
prepTime
  • string

Jumlah waktu yang diperlukan untuk menyiapkan bahan-bahan. Misalnya, PT15M. Untuk informasi tentang format waktu, lihat http://en.wikipedia.org/wiki/ISO_8601#Durations.
provider

Sumber karya kreatif.
text
  • string

Konten teks karya kreatif ini.
thumbnailUrl
  • string

URL ke gambar mini item.
totalTime
  • string

Jumlah total waktu yang diperlukan untuk menyiapkan dan memasak resep. Misalnya, PT45M. Untuk informasi tentang format waktu, lihat http://en.wikipedia.org/wiki/ISO_8601#Durations.

RecipesModule

Mendefinisikan daftar resep.

Name Type Description
value

Daftar resep.

RelatedSearchesModule

Menentukan daftar pencarian terkait.

Name Type Description
value

Daftar pencarian terkait.

SafeSearch

Filter hasil gambar dalam tindakan dengan jenis 'VisualSearch' untuk konten dewasa. Berikut ini adalah kemungkinan nilai filter. Nonaktif: Dapat mengembalikan gambar dengan konten dewasa. Sedang: Jangan mengembalikan gambar dengan konten dewasa. Ketat: Jangan mengembalikan gambar dengan konten dewasa. Defaultnya adalah Moderate. Jika permintaan berasal dari pasar yang Bing kebijakan dewasa mengharuskan safeSearch diatur ke Ketat, Bing mengabaikan nilai safeSearch dan menggunakan Strict. Jika Anda menggunakan situs: filter dalam permintaan pengetahuan, ada kemungkinan respons dapat berisi konten dewasa terlepas dari apa parameter kueri safeSearch diatur ke. Gunakan situs: hanya jika Anda mengetahui konten di situs dan skenario Anda mendukung kemungkinan konten dewasa.

Name Type Description
Moderate
  • string
Off
  • string
Strict
  • string

Thing

Mendefinisikan sesuatu.

Name Type Description
_type
  • string
alternateName
  • string

Alias untuk item.
bingId
  • string

ID yang secara unik mengidentifikasi item ini.
description
  • string

Deskripsi singkat tentang item.
id
  • string

Pengidentifikasi string.
image

Gambar item.
name
  • string

Nama benda yang diwakili oleh objek ini.
readLink
  • string

URL yang mengembalikan sumber daya ini. Untuk menggunakan URL, tambahkan parameter kueri yang sesuai dan sertakan header Ocp-Apim-Subscription-Key.
url
  • string

URL untuk mendapatkan informasi lebih lanjut tentang hal yang diwakili oleh objek ini.
webSearchUrl
  • string

URL untuk Bing hasil pencarian untuk item ini.

XBingApisSDK

Mengaktifkan kepatuhan swagger.

Name Type Description
true
  • string