Mendapatkan gambar yang sedang tren dari web

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.

Untuk mendapatkan gambar yang sedang tren hari ini, kirim permintaan GET berikut:

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

Trending Images API saat ini hanya mendukung pasar berikut:

  • en-US (Inggris, Amerika Serikat)
  • en-CA (Inggris, Kanada)
  • en-AU (Inggris, Australia)
  • zh-CN (Tionghoa, Tiongkok)

Respons berisi objek TrendingImages yang mencantumkan gambar menurut kategori. Gunakan title kategori untuk mengelompokkan gambar dalam pengalaman pengguna Anda. Kategori dapat berubah setiap hari.

{
    "_type" : "TrendingImages",  
    "categories" : [{  
        "title" : "Popular people searches",  
        "tiles" : [{  
            "query" : {  
                "text" : "Smith",  
                "displayText" : "Mr. Smith",  
                "webSearchUrl" : "https:\/\/www.bing.com\/images\/search?q=smith&FORM=..."
            },  
            "image" : {  
                "id" : "C3C60AE779A054D5CD80D3CACF0F3",  
                "thumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?id=OIP.M2532...",  
                "contentUrl" : "http:\/\/www.contoso.com.au\/assets\/Uploads\/smith-SH01.jpg",  
                "thumbnail" : {  
                    "width" : 288,  
                    "height" : 300  
                }  
            }  
        },  
        . . .  
        ]  
    },  
    . . .  
    {  
        "title" : "Popular Halloween searches",  
        "tiles" : [{  
            "query" : {  
                "text" : "Halloween costumes for adults",  
                "displayText" : "Halloween costumes for adults",  
                "webSearchUrl" : "https:\/\/www.bing.com\/images\/search?q=Halloween+costumes..."
            },  
            "image" : {  
                "id" : "0F3395F2983003F89DCEE711B55D7FA53E4",  
                "thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?id=OIP.Me429c...",  
                "contentUrl" : "http:\/\/images.domain.com\/products\/8179\/1-1\/adult-squirrel...",  
                "thumbnail" : {  
                    "width" : 336,  
                    "height" : 480  
                }  
            }  
        }]  
    }]  
}  

Setiap petak peta berisi gambar dan opsi untuk mendapatkan gambar terkait. Untuk mendapatkan gambar terkait, Anda dapat menggunakan kueri text untuk memanggil Image Search API dan menampilkan sendiri gambar terkait. Atau, Anda dapat menggunakan URL di webSearchUrl untuk mengarahkan pengguna ke halaman hasil pencarian gambar Bing, yang berisi gambar terkait.

Jika Anda memanggil Image Search API untuk mendapatkan gambar terkait, atur parameter kueri id ke ID di bidang id. Menentukan ID memastikan bahwa respons berisi gambar (ini adalah gambar pertama dalam respons) dan gambar terkait. Selain itu, atur parameter kueri q ke teks di bidang text objek query.

Contoh berikut menunjukkan cara menggunakan ID gambar untuk mendapatkan gambar terkait Mr. Smith dalam respons Trending Images API sebelumnya.

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