Bing Görsel Arama API'si arama sorguları gönderme

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.

Bu makalede, yanıt nesnesi ve Bing Görsel Arama API'si gönderilen isteklerin parametreleri ve öznitelikleri açıklanmaktadır.

Bir görüntüyle ilgili öngörüleri üç şekilde edinebilirsiniz:

  • Bing resim arama API'si uç noktalarından birine yapılan önceki bir çağrıdan bir görüntüden aldığınız Öngörüler belirtecini kullanma.
  • Bir görüntünün URL 'sini gönderme.
  • Görüntü karşıya yükleniyor (ikili biçimde).

Bing Görsel Arama istekleri

Görsel Arama bir görüntü belirteci veya URL gönderirseniz, aşağıdaki kod parçacığı GÖNDERI gövdesine dahil etmeniz gereken JSON nesnesini gösterir:

{
    "imageInfo" : {
        "url" : "",
        "imageInsightsToken" : "",
        "cropArea" : {
            "top" : 0.1,
            "left" : 0.5,
            "right" : 0.9,
            "bottom" : 0.9
        }
    },
    "knowledgeRequest" : {
      "filters" : {
        "site" : ""
      }
    }
}

imageInfo nesnesi url veya imageInsightsToken alanını içermelidir ama ikisini birden içermemelidir. urlAlanı Internet erişimli bir görüntünün URL 'si olarak ayarlayın. Desteklenen resim boyutu üst sınırı 1 MB'tır.

imageInsightsToken, içgörü belirtecine ayarlanmalıdır. İçgörü belirtecini almak için, Bing Resim API'sini çağırın. Yanıt bir Image nesneleri listesi içerir. Her Image nesnesinde belirteci içeren bir imageInsightsToken alanı vardır.

cropArea alanı isteğe bağlıdır. Kırpma alanı, ilgilendiğiniz bölgenin sol üst köşesini ve sağ alt köşesini belirtir. 0,0 ile 1,0 arasında değerler belirtin. Değerler bütün genişliğin veya yüksekliğin oranıdır. Örneğin, yukarıdaki örnek ilgilenilen bölge olarak resmin sağ yarısını işaretler. İçgörü isteğini ilgilenilen bölgeyle sınırlandırmak istiyorsanız bunu ekleyin.

filters nesnesi, benzer resim ve benzer ürün sonuçlarını belirli bir etki alanıyla sınırlandırmak için kullanabileceğiniz bir site filtresi içerir (site alanına bakın). Örneğin, görüntü bir yüzey defteridir olarak ayarlayabilirsiniz site www.microsoft.com .

Bir resmin yerel kopyasıyla ilgili içgörüler almak istiyorsanız, resmi ikili veri olarak karşıya yükleyin.

Bu seçenekleri POST’un gövdesine ekleme hakkındaki ayrıntılar için bkz. İçerik formu türleri.

Uç nokta ara

Görsel Arama uç noktası şudur: https://api.cognitive.microsoft.com/bing/v7.0/images/visualsearch.

İstekler yalnızca HTTP POST istekleri olarak gönderilmelidir.

Sorgu parametreleri

Aşağıdakiler, isteğinizde belirtilmesi gereken sorgu parametreleridir. En azından, mkt sorgu parametresini eklemeniz gerekir:

Name Değer Tür Gerekli
cc Sonuçların nereden geldiği temsil eden iki karakterli bir ülke kodu.

Bu parametreyi ayarlarsanız, Accept-Language üst bilgisini de belirtmelisiniz. Bing dil listesinde bulduğu ilk desteklenen dili kullanır ve dili sizin belirttiğiniz ülke koduyla birleştirerek sonuçları hangi pazardan döndüreceğini saptar. Dil listesi desteklenen bir dil içermiyorsa, Bing isteği destekleyen en yakın dili ve pazarı bulur. Öte yandan, sonuçlarda belirtilen pazar yerine toplu veya varsayılan bir pazarı da kullanılabilir.

Bu sorgu parametresini ve Accept-Language sorgu parametresini ancak birden çok dil belirttiyseniz kullanmalısınız; aksi takdirde mkt ve setLang sorgu parametrelerini kullanmanız gerekir.

Bu parametre ve mkt— sorgu parametresi karşılıklı olarak birbirini dışlar. İkisini birlikte belirtmeyin.
Dize No
mkt Sonuçların geldiği pazar.

Note: Biliniyorsa, her zaman pazarı belirtmeniz gerekir. Pazarın belirtilmesi Bing’in isteği yönlendirmesine, uygun ve en iyi yanıtı döndürmesine yardımcı olur.

Bu parametre ve cc— sorgu parametresi karşılıklı olarak birbirini dışlar. İkisini birlikte belirtmeyin.
Dize Yes
safeSearch Yetişkinlere yönelik içerik için bir filtre. Aşağıdakiler, büyük/küçük harfe duyarlı olmayan olası filtre değerleridir.
  • Off—Yetişkinlere yönelik metin veya resim içeren web sayfalarını döndürür.

  • Moderate—Yetişkinlere yönelik metin içeren web sayfalarını döndürür ama yetişkinlere yönelik resim içerenleri döndürmez.

  • Strict—Yetişkinlere yönelik metin veya resim içeren web sayfalarını döndürmez.

Varsayılan ayar Moderate değeridir.

NOT: İstek, Bing'in yetişkinlere yönelik içerik ilkesinin safeSearch parametresinde Strict ayarlanmasını gerektirdiği bir pazardan geliyorsa, Bing safeSearch değerini yoksayar ve Strict değerini kullanır.

Note: site: Sorgu işlecini kullanırsanız, yanıt, safeSearch sorgu parametresinin ne şekilde ayarlandığına bakılmaksızın yetişkinlere yönelik içerik içerebilen bir şansınız olabilir. site: işlecini yalnızca sitenin içeriği hakkında bilgi sahibiyseniz ve senaryonuz, yetişkinlere yönelik içeriğin mevcut olma ihtimalini destekliyorsa kullanın.
Dize No
setLang Kullanıcı arabirimi dizelerinde kullanılacak dil. ISO 639-1 iki harfli dil kodunu kullanarak dili belirtin. Örneğin, Türkçe için dil kodu TR'dir. Varsayılan değer EN (İngilizce) ayarıdır.

İsteğe bağlı olsa da, her zaman dil belirtmelisiniz. Kullanıcı tarafından kullanıcı arabirimi dizelerinin farklı dilde görüntülenmesi istenmediği sürece, normalde setLang parametresini mkt parametresiyle aynı dile ayarlarsınız.

Bu parametre ve Accept-Language— üst bilgisi karşılıklı olarak birbirini dışlar. İkisini birlikte belirtmeyin.

Kullanıcı arabirimi dizesi, kullanıcı arabiriminde etiket olarak kullanılan dizedir. JSON yanıt nesnelerinde çok az kullanıcı arabirimi dizesi vardır. Ayrıca, yanıt nesnelerinde Bing.com özelliklerine yönelik bağlantılar da belirtilen dildedir.
Dize No

Üst Bilgiler

Aşağıdakiler, isteğinizde belirtilmesi gereken üst bilgilerdir. Content-TypeVe Ocp-Apim-Subscription-Key üst bilgileri yalnızca gerekli olan başlıklardır, ancak,, ve de dahil etmelisiniz User-Agent X-MSEdge-ClientID X-MSEdge-ClientIP X-Search-Location .

Üst bilgi Description
Accept-Language İsteğe bağlı istek üst bilgisi.

Kullanıcı arabirimi dizelerinde kullanılacak virgülle sınırlanmış bir dil listesi. Liste, tercih edilme durumuna göre azalan düzende sıralanır. Beklenen biçim de içinde olmak üzere daha fazla bilgi için bkz. RFC2616.

Bu üst bilgi ve setLang— sorgu parametresi karşılıklı olarak birbirini dışlar. İkisini birlikte belirtmeyin.

Bu üst bilgiyi ayarlarsanız, cc sorgu parametresini de belirtmelisiniz. Hangi pazardan sonuç döndürüleceğini belirlemek için, Bing listeden bulduğu ilk desteklenen dili kullanır ve bunu cc parametresinin değeriyle birleştirir. Liste desteklenen bir dil içermiyorsa, Bing isteği destekleyen en yakın dili ve pazarı bulur ya da sonuçlar için toplu veya varsayılan bir pazar kullanır. Bing tarafından kullanılan pazarı öğrenmek için BingAPIs-Market başlığına bakın.

Ancak birden çok dil belirtirseniz bu üst bilgiyi ve cc sorgu parametresini kullanın. Aksi takdirde, mkt ile setLang sorgu parametrelerini kullanın.

Kullanıcı arabirimi dizesi, kullanıcı arabiriminde etiket olarak kullanılan dizedir. JSON yanıt nesnelerinde çok az kullanıcı arabirimi dizesi vardır. Yanıt nesnelerinde Bing.com özelliklerine yönelik bağlantılar da belirtilen dildedir.
Content-Type
BingAPIs-Market Yanıt üst bilgisi.

İstek tarafından kullanılan pazar. Form <languageCode> - <countryCode> . Örneğin, tr-TR.
BingAPIs-TraceId Yanıt üst bilgisi.

İsteğin ayrıntılarını içeren günlük girdisinin kimliği. Hata oluştuğunda, bu kimliği yakalayın. Sorunu belirleyemez ve çözemezseniz, Destek ekibine diğer bilgilerle birlikte bu kimliği de sağlayın.
Ocp-Apim-Subscription-Key Gerekli istek üst bilgisi.

Bilişsel Hizmetler'de bu hizmete kaydolduğunuzda aldığınız abonelik anahtarı.
Pragma
User-Agent İsteğe bağlı istek üst bilgisi.

İsteği başlatan kullanıcı aracısı. Bing, mobil kullanıcılara iyileştirilmiş bir deneyim sağlamak için kullanıcı aracısını kullanır. İsteğe bağlı olsa da, bu üst bilgiyi her zaman belirtmeniz önerilir.

User-agent, yaygın olarak kullanılan tarayıcılardan gönderilen dizeyle aynı olmalıdır. Kullanıcı aracıları hakkında daha fazla bilgi için bkz. RFC 2616.

Aşağıda örnek user-agent dizelerini bulabilirsiniz.
  • Windows Phone—Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)

  • Android—Mozilla/5.0 (Linux; U; Android 2.3.5; en-us; SCH-I500 Build/GINGERBREAD) AppleWebKit/533.1 (KHTML; like Gecko) Version/4.0 Mobile Safari/533.1

  • iPhone—Mozilla/5.0 (iPhone; CPU iPhone OS 6_1 like Mac OS X) AppleWebKit/536.26 (KHTML; like Gecko) Mobile/10B142 iPhone4;1 BingWeb/3.03.1428.20120423

  • PC—Mozilla/5.0 (Windows NT 6.3; WOW64; Trident/7.0; Touch; rv:11.0) like Gecko

  • iPad—Mozilla/5.0 (iPad; CPU OS 7_0 like Mac OS X) AppleWebKit/537.51.1 (KHTML, like Gecko) Version/7.0 Mobile/11A465 Safari/9537.53
X-MSEdge-ClientID İsteğe bağlı istek ve yanıt üst bilgisi.

Bing, kullanıcılara tüm Bing API çağrılarında tutarlı bir davranış sağlamak için bu üst bilgiyi kullanır. Bing sık sık yeni özellikler ve geliştirmeler dağıtır ve farklı dağıtımlarda trafik ataması yapmak için anahtar olarak istemci kimliğini kullanır. Bir kullanıcı için birden çok istekte aynı istemci kimliğini kullanmazsanız, Bing kullanıcıyı birden çok çakışan dağıtıma atayabilir. Birden çok çakışan dağıtıma eklenmek, tutarsız bir kullanıcı deneyimine yol açabilir. Örneğin, ikinci isteğin dağıtım ataması ilkinden farklıysa, beklenmeyen bir deneyim yaşanabilir. Ayrıca, Bing istemci kimliğini kullanarak web sonuçlarını istemci kimliğinin arama geçmişine uyarlayabilir ve bu sayede kullanıcıya daha zengin bir deneyim sağlayabilir.

Bing, istemci kimliği tarafından oluşturulan etkinliği analiz ederek sonuç derecelendirmelerini geliştirmeye yardımcı olması için de bu üst bilgiyi kullanabilir. İlgi geliştirmeleri Bing API'lerinin daha kaliteli sonuçlar vermesine yardımcı olur ve böylelikle API tüketicisi için daha yüksek tıklama oranları getirir.

ÖNEMLİ: İsteğe bağlı olsa da, bu üst bilgiyi gerekli olarak kabul edebilirsiniz. Aynı son kullanıcı ile cihaz bileşimi için birden çok istekte aynı istemci kimliğini kullanıldığında, 1) API tüketicisi tutarlı bir kullanıcı deneyimi elde eder ve 2) Bing API'lerinden daha kaliteli sonuçlar alındığından tıklama oranları daha yüksek olur.

Bu üst bilgi için geçerli olan temel kullanım kuralları şunlardır:
  • Cihazda uygulamanızı kullanan her kullanıcının Bing tarafından oluşturulan benzersiz bir istemci kimliği olmalıdır.

    İsteğe bu üst bilgiyi eklemezseniz, Bing bir kimlik oluşturur ve bu kimliği X-MSEdge-ClientID yanıt üst bilgisinde döndürür. İsteğe bu üst bilgiyi EKLEMEMENİZ gereken tek durum, söz konusu cihazda kullanıcının uygulamanızı ilk kez kullanmasıdır.

  • DİKKAT: Bu İstemci Kimliğinin, kimliği doğrulanmış hiçbir kullanıcı hesabı bilgisine bağlanabilir olmadığından emin olmalısınız.
  • Cihazda uygulamanızın bu kullanıcı için yaptığı her Bing API'si isteğinde istemci kimliğini kullanın.

  • İstemci kimliğinin kalıcı olmasını sağlayın. Tarayıcı uygulamasında kimliği kalıcı hale getirmek için, tüm oturumlarda kimliğin kullanmasını sağlayacak bir kalıcı HTTP tanımlama bilgisi kullanın. Oturum tanımlama bilgisi kullanmayın. Mobil uygulamalar gibi diğer uygulamalarda, kimliği kalıcı hale getirmek için cihazın kalıcı depolamasını kullanın.

    Kullanıcı o cihazda uygulamanızı yeniden kullandığında, kalıcı hale getirdiğiniz istemci kimliğini alın.

NOT: Bing yanıtları bu üst bilgiyi içerebilir veya içermeyebilir. Yanıt bu üst bilgiyi içeriyorsa, istemci kimliğini yakalayın ve o cihazda kullanıcı için bunu izleyen tüm Bing isteklerinde onu kullanın.

NOT: X-MSEdge-ClientID üst bilgisini eklerseniz, isteğe tanımlama bilgileri eklememelisiniz.
X-MSEdge-ClientIP İsteğe bağlı istek üst bilgisi.

İstemci cihazının IPv4 veya IPv6 adresi. IP adresi, kullanıcının konumunu bulmak için kullanılır. Bing konum bilgisini kullanarak güvenli arama davranışını saptar.

NOT: İsteğe bağlı olsa da, bu üst bilgiyi ve X-Search-Location üst bilgisini her zaman belirtmeniz önerilir.

Adresi karartmayın (örneğin, son sekiz karakteri 0'la değiştirerek). Adresin karartılması, cihazın gerçek konumuna yakın olmayan bir konum sonucu verir ve bu da Bing'in hatalı sonuçlar sağlamasına yol açabilir.
X-Search-Location İsteğe bağlı istek üst bilgisi.

İstemcinin coğrafi konumunu açıklayan noktalı virgülle sınırlanmış anahtar/değer çifti listesi. Bing konum bilgisini kullanarak güvenli arama davranışını saptar ve ilgili yerel içeriği döndürür. Anahtar/değer çiftini şöyle belirtin <key> : <value> . Aşağıda, kullanıcının konumunu belirtmek için kullandığınız anahtarlar gösterilir.

  • lat—Gerekli. İstemcinin konumunun derece cinsinden enlemi. Enlem -90,0 değerinden büyük veya bu değere eşit ve +90,0 değerinden küçük veya bu değere eşit olmalıdır. Negatif değerler güney enlemlerini ve pozitif değerler de kuzey enlemlerini gösterir.

  • long—Gerekli. İstemcinin konumunun derece cinsinden boylamı. Boylam -180,0 değerinden büyük veya bu değere eşit ve +180,0 değerinden küçük veya bu değere eşit olmalıdır. Negatif değerler batı boylamlarını ve pozitif değerler de doğu boylamlarını gösterir.

  • re—Gerekli. Koordinatların yatay doğruluğunu belirten metre cinsinden yarıçap. Cihazın konum hizmeti tarafından döndürülen değeri geçirin. Normal değerler, GPS/Wi-Fi için 22 milyon, hücre kule çapraz düzeni için 380, ters IP araması için 18.000 d olabilir.

  • ts—İsteğe bağlı. İstemcinin ne zaman konumda olduğunu gösteren UTC UNIX zaman damgası. (UNIX zaman damgası 1 Ocak 1970'den başlayarak saniye sayısıdır.)

  • head—İsteğe bağlı. İstemcinin göreli seyahat yönü. Gerçek kuzeye göre saat yönünün tersine 0 ile 360 derece arasında bir seyahat yönü belirtin. Bu anahtarı ancak sp anahtarı sıfırdan farklı bir değer olduğunda belirtin.

  • sp—İsteğe bağlı. Saniyedeki metre cinsinden istemci cihazının seyahat ettiği yatay hız.

  • alt—İsteğe bağlı. İstemci cihazının metre cinsinden deniz seviyesinden yüksekliği.

  • are—İsteğe bağlı. Koordinatların dikey doğruluğunu belirten metre cinsinden yarıçap. Bu anahtarı ancak alt anahtarı belirttiğiniz durumda belirtin.

NOT: Anahtarların çoğu isteğe bağlı olsa da, ne kadar çok bilgi sağlarsanız konum sonuçları o kadar doğru olur.

NOT: İsteğe bağlı olsa da, kullanıcının coğrafi konumunu her zaman belirtmeniz önerilir. İstemcinin IP adresi kullanıcının fiziksel konumunu doğru yansıtmıyorsa (örneğin istemci VPN kullanıyorsa), konumun belirtilmesi özellikle önemlidir. En iyi sonuçlar için, bu üstbilgiyi ve üstbilgiyi eklemeniz gerekir X-MSEdge-ClientIP , ancak en azından bu üstbilgiyi dahil etmelisiniz.

Not

BING arama API kullanımı ve görüntüleme gereksinimlerinin , bu üstbilgilerin kullanımı dahil olmak üzere tüm geçerli yasaların uyumluluk gerektirdiğini unutmayın. Örneğin, Avrupa gibi bazı yasama bölgelerinde kullanıcı cihazlarına izleme cihazları takmadan önce kullanıcının iznini almak gerekir.

İçerik formu türleri

Her istek Content-Type üst bilgisi içermelidir. Üst bilgi: multipart/form-data; boundary=\<boundary string\> olarak ayarlanmalıdır, burada <boundary string> form verilerinin sınırlarını tanımlayan benzersiz ve donuk bir dizedir. Örneğin, boundary=boundary_1234-abcd.

Görsel Arama bir görüntü belirteci veya URL gönderirseniz, aşağıdaki kod parçacığı GÖNDERI gövdesine dahil etmeniz gereken form verilerini gösterir. Form verileri Content-Disposition üstbilgiyi içermeli ve name parametresini "knowledgeRequest" olarak ayarlamanız gerekir. Nesneyle ilgili ayrıntılar için imageInfo , isteğe bakın.

--boundary_1234-abcd
Content-Disposition: form-data; name="knowledgeRequest"

{
    "imageInfo" : {
        "url" : "https://contoso.com/2018/05/fashion/red.jpg"
    }
}

--boundary_1234-abcd--

enableEntityData true Web ve atısyon bilgilerine bağlantılar da dahil olmak üzere, karşıya yüklediğiniz görüntüde ana varlıkla ilgili ayrıntılı bilgi için başlıktaki özniteliğini isteğe bağlı olarak ayarlayabilirsiniz. Bu alan false Varsayılan olarak olur.

--boundary_1234-abcd
Content-Disposition: form-data; name="knowledgeRequest"

{
  "imageInfo" : {
      "url" : "https://contoso.com/2018/05/fashion/red.jpg"
  },
  "knowledgeRequest" : {
    "invokedSkillsRequestData" : {
        "enableEntityData" : "true"
    }
  }
}

--boundary_1234-abcd--

Yerel bir görüntüyü karşıya yüklerseniz, aşağıdaki kod parçacığı GÖNDERI gövdesine dahil etmeniz gereken form verilerini gösterir. Form verileri Content-Disposition üst bilgisi içermelidir. name parametresi "image" olarak ayarlanmalıdır, filename parametresi ise herhangi bir dizeye ayarlanabilir. Content-TypeÜst bilgi, yaygın olarak kullanılan herhangi bir resim MIME türüne ayarlanabilir. Formun içeriği görüntünün ikili verileri olur. Karşıya yükleyebileceğiniz resim boyutu üst sınırı 1 MB'tır. Genişlik veya yükseklik üst sınırı ise 1.500 pikseldir.

--boundary_1234-abcd
Content-Disposition: form-data; name="image"; filename="myimagefile.jpg"
Content-Type: image/jpeg

ÿØÿà JFIF ÖÆ68g-¤CWŸþ29ÌÄøÖ‘º«™æ±èuZiÀ)"óÓß°Î= ØJ9á+*G¦...

--boundary_1234-abcd--

Aşağıdaki kod parçacığında karşıya yüklenen bir görüntünün ilgilendiğiniz bölgenin nasıl belirtildiği gösterilmektedir:

--boundary_1234-abcd
Content-Disposition: form-data; name="knowledgeRequest"

{
    "imageInfo" : {
        "cropArea" : {
            "top" : 0.2,
            "left" : 0.3,
            "bottom" : 0.7,
            "right" : 0.6
        }
    }
}

--boundary_1234-abcd
Content-Disposition: form-data; name="image"; filename="image"
Content-Type: image/jpeg


ÿØÿà JFIF ÖÆ68g-¤CWŸþ29ÌÄøÖ‘º«™æ±èuZiÀ)"óÓß°Î= ØJ9á+*G¦...

--boundary_1234-abcd--

Örnek istek

Aşağıdaki kod parçacığında, bir resim belirtecini ve ilgilendiğiniz bölgeyi ileten tüm görüntü öngörüleri isteği gösterilmektedir. Daha önceki bir/Imate/Search çağrısından Öngörüler belirtecini alırsınız:

POST https://api.cognitive.microsoft.com/bing/v7.0/images/visualsearch?mkt=en-us HTTP/1.1  
Content-Type: multipart/form-data; boundary=boundary_1234-abcd
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 

--boundary_1234-abcd
Content-Disposition: form-data; name="knowledgeRequest"

{
    "imageInfo" : {
        "imageInsightsToken" : "mid_D6426898706EC7..."
        "cropArea" : {
            "top" : 0.1,
            "left" : 0.2,
            "bottom" : 0.7,
            "right" : 0.5
        }
    }
}

--boundary_1234-abcd--

Bing Görsel Arama yanıtları

Not

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.

Resim için içgörüler varsa, yanıtta içgörüleri içeren bir veya birden çok tags bulunur. imageAlan, giriş görüntüsü için Öngörüler belirtecini içerir:

{
  "_type" : "ImageKnowledge",
  "tags" : [
    {...},
    {...},
    {...},
    {...},
    {...}
  ],
  "image" : {
    "imageInsightsToken" : "bcid_AF8C9CA409421B..."
  }
}

tags alanı, görünen adı ve eylem (içgörü) listesini içerir. Etiketlerden birinin boş dizeye ayarlanmış bir displayName alanı vardır. Bu etiket resmi, görsel olarak benzer resimleri ve resimde bulunan öğelerin alışveriş kaynaklarını içeren web sayfaları gibi varsayılan içgörüleri içerir. Görüntünün tamamı ilgilendiğiniz için, varsayılan Öngörüler etiketi ilgilendiğiniz bölgelere yönelik sınırlayıcı kutular içermez:

{
  "_type" : "ImageKnowledge",
  "tags" : [
    {
      "displayName" : "",
      "actions" : [
        {...},
        {...},
        {...},
        {...}
      ]
    },
    {...},
    {...},
    {...},
    {...}
  ],
  "image" : {
    "imageInsightsToken" : "bcid_AF8C9CA409421B..."
  }
}

Varsayılan Öngörüler listesi için bkz. Default Insights etiketi.

Kalan etiketler kullanıcının ilgisini çekebilecek diğer içgörüleri içerir. Örneğin resimde metin varsa, etiketlerden biri tanınan metnin bulunduğu TextResults içgörüsünü içerebilir. Ya da, görüntüde bir varlığı (yani, tam olarak tanınmış/popüler bir kişi, yer veya bir şey) tanırsa, etiketlerden biri varlığı tanımlayabilir. Görsel Arama giriş resminden türetilen çeşitli terimler (etiketler) de döndürür. Bu Etiketler, kullanıcıların görüntüde bulunan kavramları keşfetmesine olanak tanır. Örneğin giriş resmi ünlü bir sporcuya aitse, etiketlerden biri Spor olabilir ve spor resimlerinin bağlantılarını içerebilir.

Her etiket içgörüyü kategorilere ayırmak için kullanabileceğiniz bir görünen adı, içgörünün geçerli olduğu ilgilenilen bölgeyi tanımlayan sınırlayıcı kutuyu, içgörüleri ve resmin bir küçük resmini içerir. Örneğin resim spor forması giymiş birine aitse, etiketlerden biri formayı sınırlayan bir sınırlayıcı kutu ile VisualSearch ve ProductVisualSearch içgörülerini içerebilir. Bir diğer etikette de konuları bakımından birbiriyle ilgili resimleri almaya yönelik /images/search API isteğinin URL'sini içeren bir ImageResults içgörüsü veya kullanıcıyı Bing.com resim arama sonuçlarına götüren Bing.com arama URL'si bulunabilir.

Varsayılan içgörü etiketleri dışındaki tüm etiketlerde, resimde ilgilenilen bölgeyi tanımlayan sınırlayıcı kutular vardır. Örneğin resimde tanınan birden çok kişi varsa, etiketler kişilerden her biri için sınırlayıcı kutular içerebilir veya resimde tanınan giyim eşyaları varsa, etiketlerde tanınan her giyim eşyası için sınırlayıcı kutular bulunabilir. Sınırlayıcı kutuları kullanarak, tıklandığında resmin ilgili bölgesinin içeriği hakkında ayrıntılar sağlayan etkin noktalar oluşturabilirsiniz. Resmin tamamını tanımlayan sınırlayıcı kutular için etkin nokta eklememelisiniz.

Metin tanıma

Resim hizmetin tanıdığı metinler içeriyorsa, etiketlerden biri bir TextResults içgörüsü (eylemi) içerir. Öngörüler displayName tanınan metni içerir:

    {
        "image" : {
            "thumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?q=%23%23Text..."
        },
        "displayName" : "##TextRecognition",
        "boundingBox" : {
            "queryRectangle" : {
                "topLeft" : {"x" : 0, "y" : 0},
                "topRight" : {"x" : 1, "y" : 0},
                "bottomRight" : {"x" : 1, "y" : 1},
                "bottomLeft" : {"x" : 0, "y" : 1}
            },
            "displayRectangle" : {
                "topLeft" : {"x" : 0, "y" : 0},
                "topRight" : {"x" : 1, "y" : 0},
                "bottomRight" : {"x" : 1, "y" : 1},
                "bottomLeft" : {"x" : 0, "y" : 1}
            }
        },
        "actions" : [{
            "displayName" : "WALK BIKE ACROSS BRIDGE",
            "actionType" : "TextResults"
        }],
        "sources" : ["OCR"]
    }

Etiketin displayName alanı ##TextRecognition öğesini içereceğinden, UX'te bunu bir kategori başlığı olarak kullanmayın. Bu durum ## ile başlayan tüm görünen adlar için geçerlidir. Bunun yerine, eylemin görünen adını kullanın.

Metin tanıma, kartvizitlerin üzerindeki telefon numarası ve e-posta adresi gibi kişi bilgilerini de tanıyabilir. Sınırlayıcı kutu, kartvizitte kişi bilgilerinin konumunu belirler.

    {
      "image" : {
        "thumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?q=%23%23TextRecognition..."
      },
      "displayName" : "##TextRecognition",
      "boundingBox" : {
        "queryRectangle" : {
          "topLeft" : {"x" : 0.635, "y" : 0},
          "topRight" : {"x" : 0.77, "y" : 0},
          "bottomRight" : {"x" : 0.77, "y" : 0.4873333},
          "bottomLeft" : {"x" : 0.635, "y" : 0.4873333}
        },
        "displayRectangle" : {
          "topLeft" : {"x" : 0.635, "y" : 0},
          "topRight" : {"x" : 0.77, "y" : 0},
          "bottomRight" : {"x" : 0.77, "y" : 0.4873333},
          "bottomLeft" : {"x" : 0.635, "y" : 0.4873333}
        }
      },
      "actions" : [
        {
          "url" : "tel:888%20555%201212",
          "actionType" : "Uri"
        }
      ],
      "sources" : ["OCR"]
    },
    {
      "image" : {
        "thumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?q=%23%23TextRecognition..."
      },
      "displayName" : "##TextRecognition",
      "boundingBox" : {
        "queryRectangle" : {
          "topLeft" : {"x" : 0.63, "y" : 0},
          "topRight" : {"x" : 0.866, "y" : 0},
          "bottomRight" : {"x" : 0.866, "y" : 0.5553334},
          "bottomLeft" : {"x" : 0.63, "y" : 0.5553334}
        },
        "displayRectangle" : {
          "topLeft" : {"x" : 0.63, "y" : 0},
          "topRight" : {"x" : 0.866, "y" : 0},
          "bottomRight" : {"x" : 0.866, "y" : 0.5553334},
          "bottomLeft" : {"x" : 0.63, "y" : 0.5553334}
        }
      },
      "actions" : [
        {
          "url" : "mailto:someone@outlook.com",
          "actionType" : "Uri"
        }
      ],
      "sources" : ["OCR"]
    },
    {
      "image" : {
        "thumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?q=%23%23TextRecognition..."
      },
      "displayName" : "##TextRecognition",
      "boundingBox" : {
        "queryRectangle" : {
          "topLeft" : {"x" : 0, "y" : 0},
          "topRight" : {"x" : 1, "y" : 0},
          "bottomRight" : {"x" : 1, "y" : 1},
          "bottomLeft" : {"x" : 0, "y" : 1}
        },
        "displayRectangle" : {
          "topLeft" : {"x" : 0, "y" : 0},
          "topRight" : {"x" : 1, "y" : 0},
          "bottomRight" : {"x" : 1, "y" : 1},
          "bottomLeft" : {"x" : 0, "y" : 1}
        }
      },
      "actions" : [
        {
          "displayName" : "CHARLENE WHITNEY Graphic Designer 888 555 1212 someone@outlook.com www.contoso.com",
          "actionType" : "TextResults"
        }
      ],
      "sources" : ["OCR"]
    }

Görüntü, tam olarak tanınmış/popüler kişi, yer veya bir şey gibi tanınan bir varlık içeriyorsa, etiketlerden biri bir varlık öngörüsi içerebilir. mainEntityVe data alanları yalnızca enableEntityData Content-Type başlıktaki özniteliği olarak ayarlanmışsa kullanılabilir true .

{
  "image" : {
    "thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?q=Statue+of+Liberty..."
  },
  "displayName" : "Statue of Liberty",
  "boundingBox" : {
    "queryRectangle" : {
      "topLeft" : {"x" : 0.40625, "y" : 0.1757813},
      "topRight" : {"x" : 0.6171875, "y" : 0.1757813},
      "bottomRight" : {"x" : 0.6171875, "y" : 0.3867188},
      "bottomLeft" : {"x" : 0.40625, "y" : 0.3867188}
    },
    "displayRectangle" : {
      "topLeft" : {"x" : 0.40625, "y" : 0.1757813},
      "topRight" : {"x" : 0.6171875, "y" : 0.1757813},
      "bottomRight" : {"x" : 0.6171875, "y" : 0.3867188},
      "bottomLeft" : {"x" : 0.40625, "y" : 0.3867188}
    }
  },
  "actions" : [
    {
      "_type" : "ImageEntityAction",
      "webSearchUrl" : "https:\/\/www.bing.com\/search?q=Statue+of+Liberty",
      "displayName" : "Statue of Liberty",
      "actionType" : "Entity",
      "mainEntity" : {
        "name" = "Statue of liberty",
        "bingId" : "..."
      },
      "data" : {
        "id" : "https://api.cognitive.microsoft.com/api/v7/entities/...",
        "readLink": "https://www.bingapis.com/api/v7/search?q=...",
        "readLinkPingSuffix": "...",
        "contractualRules": [
          {
            "_type": "ContractualRules/LicenseAttribution",
            "targetPropertyName": "description",
            "mustBeCloseToContent": true,
            "license": {
                "name": "CC-BY-SA",
                "url": "http://creativecommons.org/licenses/by-sa/3.0/",
                "urlPingSuffix": "..."
            },
            "licenseNotice": "Text under CC-BY-SA license"
          },
          {
            "_type": "ContractualRules/LinkAttribution",
            "targetPropertyName": "description",
            "mustBeCloseToContent": true,
            "text": "Wikipedia",
            "url": "http://en.wikipedia.org/wiki/...",
            "urlPingSuffix": "..."
          }
        ],
        "webSearchUrl": "https://www.bing.com/entityexplore?q=...",
        "webSearchUrlPingSuffix": "...",
        "name": "Statue of Liberty",
        "image": {
          "thumbnailUrl": "https://tse1.mm.bing.net/th?id=...",
          "hostPageUrl": "http://upload.wikimedia.org/wikipedia/...",
          "hostPageUrlPingSuffix": "...",
          "width": 50,
          "height": 50,
          "sourceWidth": 474,
          "sourceHeight": 598
        },
        "description" : "...",
        "bingId": "..."
        }
      }
  ]
}

Ayrıca bkz.