Népszerű képek lekérése az internetről
Figyelmeztetés
2020. október 30-án a Bing Search API-k átkerültek az Azure AI-szolgáltatásokból a Bing Search-szolgáltatásokba. Ez a dokumentáció csak referenciaként érhető el. A frissített dokumentációt a Bing search API dokumentációjában találja. Az új Azure-erőforrások Bing-kereséshez való létrehozásával kapcsolatos utasításokért lásd: Bing Search-erőforrás létrehozása a Azure Marketplace keresztül.
A mai népszerű képek beszerzéséhez küldje el a következő GET kérést:
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
A Trending Images API jelenleg csak a következő piacokat támogatja:
- en-US (angol, Egyesült Államok)
- en-CA (angol, kanada)
- en-AU (angol, Ausztrália)
- zh-CN (kínai, Kína)
A válasz tartalmaz egy TrendingImages objektumot, amely kategóriák szerint listázza a képeket. A kategória title
használatával csoportosíthatja a képeket a felhasználói élményben. A kategóriák naponta változhatnak.
{
"_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
}
}
}]
}]
}
Minden csempe tartalmaz egy képet és a kapcsolódó képek lekérésének lehetőségeit. A kapcsolódó képek lekéréséhez a lekérdezéssel text
meghívhatja az Image Search API-t , és megjelenítheti a kapcsolódó képeket. Vagy használhatja az URL-címet webSearchUrl
, amellyel a felhasználó a Bing képek keresési eredményeinek lapjára irányítja, amely a kapcsolódó képeket tartalmazza.
Ha meghívja az Image Search API-t a kapcsolódó képek lekéréséhez, állítsa az id query paramétert a mezőben található id
azonosítóra. Az azonosító megadása biztosítja, hogy a válasz tartalmazza a képet (ez a válasz első képe) és a kapcsolódó képeket. Emellett állítsa a q lekérdezési paramétert az objektum text
mezőjében lévő query
szövegre.
Az alábbi példa bemutatja, hogyan használhatja a képazonosítót Mr. Smith kapcsolódó képeinek lekéréséhez az előző Trending Images API-válaszban.
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