Aracılığıyla paylaş

Web'den popüler görüntüler alma

  • Makale

Uyarı

30 Ekim 2020'de Bing Arama API'leri Azure yapay zeka hizmetlerinden Bing Arama Hizmetlerine taşındı. Bu belgeler yalnızca başvuru için sağlanır. Güncelleştirilmiş belgeler için Bing arama API'sinin belgelerine bakın. Bing araması için yeni Azure kaynakları oluşturma yönergeleri için bkz. Azure Market aracılığıyla Bing Arama kaynağı oluşturma.

Günümüzün popüler görüntülerini almak için aşağıdaki GET isteğini gönderin:

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

Popüler Görüntüler API'si şu anda yalnızca aşağıdaki pazarları destekler:

  • tr-TR (İngilizce, Birleşik Devletler)
  • en-CA (İngilizce, Kanada)
  • en-AU (İngilizce, Avustralya)
  • zh-CN (Çince, Çin)

Yanıt, resimleri kategoriye göre listeleyen bir TrendingImages nesnesi içerir. Kullanıcı deneyiminizdeki görüntüleri gruplandırmak için kategorilerini title kullanın. Kategoriler günlük olarak değişebilir.

{
    "_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  
                }  
            }  
        }]  
    }]  
}

Her kutucuk, ilgili görüntüleri almak için bir görüntü ve seçenekler içerir. İlgili görüntüleri almak için sorguyu text kullanarak Görüntü Arama API'sini çağırabilir ve ilgili görüntüleri kendiniz görüntüleyebilirsiniz. İsterseniz, kullanıcıyı ilgili görüntüleri içeren Bing'in resim arama sonuçları sayfasına götürmek için içindeki webSearchUrl URL'yi kullanabilirsiniz.

İlgili görüntüleri almak için Görüntü Arama API'sini çağırırsanız , id sorgu parametresini alandaki id id olarak ayarlayın. Kimliğin belirtilmesi, yanıtın görüntüyü (yanıttaki ilk görüntüdür) ve ilgili görüntüleri içermesini sağlar. Ayrıca, q sorgu parametresini nesnenin text alanındaki metne query ayarlayın.

Aşağıdaki örnekte, önceki Popüler Görüntüler API'si yanıtında Bay Smith'in ilgili görüntülerini almak için görüntü kimliğinin nasıl kullanılacağı gösterilmektedir.

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