Aracılığıyla paylaş

Bing Resim Arama API'siyle web'den görüntü 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.

Bing Resim Arama REST API'sini kullandığınızda, aşağıdaki GET isteğini göndererek web'den arama teriminizle ilgili görüntüler 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 ile kodlanmış arama teriminiz için q sorgu parametresini kullanın. Örneğin, yelkenli dinghies girerseniz veya sailing%20dinghiesolarak sailing+dinghies ayarlayınq.

Önemli

  • Tüm istekler istemciden değil sunucudan yapılmalıdır.
  • Bing arama API'lerinden herhangi birini ilk kez çağırıyorsanız istemci kimliği üst bilgisini eklemeyin. İstemci kimliğini yalnızca daha önce kullanıcı ve cihaz birleşimi için bir istemci kimliği döndüren bir Bing API'si çağırdıysanız ekleyin.

Belirli bir web etki alanından görüntü alma

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

işlecini site: kullanan sorgulara verilen yanıtlar , güvenli Arama ayarından bağımsız olarak yetişkinlere yönelik içerik içerebilir. Yalnızca etki alanındaki içeriği biliyorsanız kullanın site: .

Görüntüleri filtreleme

Varsayılan olarak, Görüntü Arama API'si sorguyla ilgili 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 arka plana veya belirli bir 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—Resimleri baskın renge veya siyah beyaza göre filtreleyin.
  • freshness—Resimleri yaşa göre filtreleyin (örneğin, Bing tarafından geçen hafta bulunan görüntüler).
  • height, width—Resimleri 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 resimler).
  • imageType—Resimleri türe göre filtreleyin (örneğin, küçük resim, animasyonlu GIF'ler veya saydam arka planlar).
  • license—Görüntüleri siteyle ilişkilendirilmiş lisans türüne göre filtreleyin.
  • size—Resimleri 200x200 piksele kadar küçük resimler 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 keşfettiği ContosoSailing.com küçük görüntülerin nasıl alındığı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 gelen yanıt iletisi, Azure AI hizmetlerinin sorguyla ilgili olduğunu belirlediği görüntülerin listesini içeren bir Görüntüler yanıtı içerir. Listedeki her Image nesnesi resim hakkında şu bilgileri içerir: URL, boyutu, boyutları, kodlama biçimi, resmin küçük resminin URL'si ve küçük resmin boyutları.

Not

  • Görüntüler yanıtta sağlanan sırayla görüntülenmelidir.
  • URL biçimleri ve parametreleri önceden haber veremeden değiştirilebilir olduğundan, tüm URL'leri olduğu gibi kullanın. Url biçimine veya parametrelere bağımlılıkları not edilen durumlar dışında almamalı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. Diğer görüntülerde sayfalandırma hakkında ayrıntılı bilgi için bkz. Resimleri Sayfalama.

Sonraki adımlar

Bing Resim Arama API'sini daha önce denemediyseniz bir hızlı başlangıç deneyin. Daha karmaşık bir şey arıyorsanız, tek sayfalı bir web uygulaması oluşturmak için öğreticiyi deneyin.