Získat obrázky z vývoje z webu

Upozornění

Bing rozhraní api pro vyhledávání se pohybují z Cognitive Services na služby Vyhledávání Bingu. od 30. října 2020 musí být všechny nové instance Vyhledávání Bingu zřízené podle popsaného procesu. Bing rozhraní api pro vyhledávání zřízená pomocí Cognitive Services budou podporována v následujících třech letech nebo do konce smlouva Enterprise, podle toho, co nastane dříve. pokyny k migraci najdete v tématu Vyhledávání Bingu Services.

Pokud chcete získat dnešní vývojové obrázky, pošlete následující požadavek GET:

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  

Rozhraní API pro vývojové obrázky aktuálně podporuje jenom tyto trhy:

  • EN-US (angličtina, USA)
  • en-CA (angličtina, Kanada)
  • EN-AU (angličtina, Austrálie)
  • zh-CN (čínština, Čína)

Odpověď obsahuje objekt TrendingImages , který obsahuje obrázky podle kategorie. titleK seskupení imagí v uživatelském prostředí použijte kategorii. Kategorie se můžou každý den měnit.

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

Každá dlaždice obsahuje obrázek a možnosti pro získání souvisejících imagí. Chcete-li získat související image, můžete použít dotaz text pro volání rozhraní API vyhledávání obrázků a zobrazení souvisejících imagí sami. nebo můžete použít adresu URL v aplikaci webSearchUrl a získat uživatele, aby se na stránce výsledků hledání imagí Bing, který obsahuje související obrázky.

Pokud zavoláte rozhraní API Vyhledávání obrázků, abyste získali související image, nastavte parametr dotazu ID na ID v id poli. Zadání ID zajistí, že odpověď obsahuje obrázek (Jedná se o první obrázek v odpovědi) a jeho související obrázky. Také nastavte parametr dotazu q na text v query text poli objektu.

Následující příklad ukazuje, jak použít ID obrázku k získání souvisejících imagí Mr. Smith v předchozí reakci rozhraní API pro vývojové obrázky.

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