Mendapatkan gambar yang sedang tren dari web

Peringatan

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

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