Bing Resim Arama API'si Web 'den resimleri alın

Uyarı

Bing Arama API'leri bilişsel hizmetlerden Bing Arama hizmetlere taşınıyor. 30 ekim 2020 ' den itibaren, buradabelgelenen işlem sonrasında Bing arama yeni örneklerin sağlanması gerekir. Bilişsel hizmetler kullanılarak sağlanan Bing Arama API'leri, sonraki üç yıl boyunca veya Kurumsal Anlaşma sonuna kadar, hangisi önce gerçekleşene kadar desteklenecektir. Geçiş yönergeleri için bkz. Bing arama Services.

Bing Resim Arama REST API kullandığınızda, aşağıdaki GET isteğini göndererek arama teriminizle ilgili Web 'den görüntü alabilirsiniz:

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies&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

URL kodlamalı arama teriminizle ilgili q sorgu parametresini kullanın. Örneğin, SAI dingerleri girerseniz, q veya olarak ayarlayın sailing+dinghies sailing%20dinghies .

Önemli

  • Tüm isteklerin bir istemciden değil, bir sunucudan yapılması gerekir.
  • Bing arama API 'Lerinden birini ilk kez arıyorsanız, istemci KIMLIĞI üst bilgisini eklemeyin. Yalnızca daha önce Kullanıcı ve cihaz birleşimi için istemci KIMLIĞI döndüren bir Bing API 'SI çağrılırsa, istemci KIMLIĞINI ekleyin.

Belirli bir Web etki alanındaki görüntüleri al

Belirli bir etki alanındaki görüntüleri almak için site: dize işlecini kullanın.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us HTTP/1.1

Not

İşleci kullanarak sorgulara verilen yanıtlar site: , SafeSearch ayarından bağımsız olarak yetişkinlere yönelik içerik içerebilir. Yalnızca site: etki alanındaki içeriğin farkında değilseniz kullanın.

Görüntüleri filtrele

Varsayılan olarak, Resim Arama API 'SI sorguyla ilgili olan tüm görüntüleri döndürür. Bing 'in döndürdüğü görüntüleri filtrelemek istiyorsanız (örneğin, yalnızca saydam bir arka plana veya belirli boyuta sahip görüntüleri döndürmek için) aşağıdaki sorgu parametrelerini kullanın:

  • en boy— görüntüleri en boy oranına göre filtreleyin (örneğin, standart veya geniş ekran görüntüleri).
  • Color— görüntüleri baskın renge veya siyaha ve beyaza göre filtreleyin.
  • yenilik— resimleri yaş (örneğin, son hafta içinde Bing tarafından bulunan görüntüler) olarak filtreleyin.
  • Yükseklik, Genişlik— görüntüleri genişliğe ve yüksekliğe göre filtreleyin.
  • ImageContent— görüntüleri içeriğe göre filtreleyin (örneğin, yalnızca bir kişinin yüzünü gösteren görüntüler).
  • ImageType— görüntüleri türe göre filtreleyin (örneğin, küçük resim, animasyonlu GIF 'ler veya saydam arka planlar).
  • Lisans— görüntüleri siteyle ilişkili lisans türüne göre filtreleyin.
  • Boyut— görüntüleri, 200 x 200 piksel kadar küçük görüntüler gibi boyuta göre filtreleyin.

Belirli bir etki alanındaki görüntüleri almak için site: dize işlecini kullanın.

Aşağıdaki örnek, Bing 'in geçen hafta içinde bulduğu ContosoSailing.com 'tan küçük görüntülerin nasıl alınacağını gösterir.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&size=small&freshness=week&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  

Bing Resim Arama yanıt biçimi

Bing 'den yanıt iletisi, bilişsel hizmetler 'in sorguyla ilgili olduğunu belirlenen görüntülerin listesini içeren bir görüntü yanıtı içerir. Listedeki her görüntü nesnesi, görüntü hakkında şu bilgileri IÇERIR: URL, boyutu, boyutları, kodlama biçimi, görüntünün küçük resminin URL 'si ve küçük resmin boyutları.

Not

  • Görüntülerin yanıtta belirtilen sırada görüntülenmesi gerekir.
  • URL biçimleri ve parametreleri bildirimde bulunulmadan değişikliğe tabi olduğundan, tüm URL 'Leri olduğu gibi kullanın. URL biçimi veya parametreler üzerinde belirtilenler dışında bağımlılık kullanmamalısınız.
{
    "name": "Rich Passage Sailing Dinghy",
    "webSearchUrl": "https:\/\/www.bing.com\/cr?IG=73118C8B4E3...",
    "thumbnailUrl": "https:\/\/tse1.mm.bing.net\/th?id=OIP.GNarK7m...",
    "datePublished": "2011-10-29T11:26:00",
    "contentUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3...",
    "hostPageUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3687...",
    "contentSize": "79239 B",
    "encodingFormat": "jpeg",
    "hostPageDisplayUrl": "en.contoso.org\/wiki\/File:Rich_Passage...",
    "width": 526,
    "height": 688,
    "thumbnail": {
        "width": 229,
        "height": 300
    },
    "imageInsightsToken": "ccid_GNarK7ma*mid_CCF85447ADA6...",
    "insightsSourcesSummary": {
        "shoppingSourcesCount": 0,
        "recipeSourcesCount": 0
    },
    "imageId": "CCF85447ADA6FFF9E96E7DF0B796F7A86E34593",
    "accentColor": "376094"
},

Bing Resim Arama API'sini çağırdığınızda Bing, sonuç listesini döndürür. Bu liste sorguyla ilgili tüm sonuçların alt kümesidir. Yanıtın totalEstimatedMatches alanı, görüntülenebilecek tahmini görüntü sayısını içerir. Görüntülerin geri kalanı hakkında daha fazla bilgi için bkz. sayfalama görüntüleri.

Sonraki adımlar

Daha önce Bing Resim Arama API'si denemediyseniz hızlıbaşlangıcı deneyin. Daha karmaşık bir şeyler arıyorsanız, tek sayfalı bir Web uygulamasıOluşturma öğreticisini deneyin.