Képek lekérése az internetről a Bing Image Search API-val

Figyelmeztetés

2020. október 30-án a Bing Search API-k átkerültek az Azure AI-szolgáltatásokból a Bing Search Servicesbe. Ez a dokumentáció csak referenciaként szolgál. 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 útmutatásért lásd: Bing Search-erőforrás létrehozása a Azure Marketplace keresztül.

A Bing Image Search REST API használatakor a keresési kifejezéshez kapcsolódó képeket az alábbi GET-kérés elküldésével szerezheti be a webről:

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

Használja a q lekérdezési paramétert az URL-kódolású keresési kifejezéshez. Ha például vitorlás inghies értéket ad meg, állítsa a q vagy sailing%20dinghiesértékresailing+dinghies.

Fontos

• Minden kérést kiszolgálóról kell intézni, nem pedig ügyféltől.
• Ha első alkalommal hívja meg valamelyik Bing keresési API-t, ne adja meg az ügyfélazonosító fejlécét. Csak akkor adja meg az ügyfél-azonosítót, ha korábban olyan Bing API-t hívott meg, amely visszaadott egy ügyfél-azonosítót a felhasználó és az eszköz kombinációjához.

Képek lekérése egy adott webtartományból

Ha egy konkrét tartományban található képeket szeretne lekérni, használja a site: lekérdezési operátort.

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

Megjegyzés

Az operátort használó site: lekérdezésekre adott válaszok tartalmazhatnak felnőtt tartalmakat a safeSearch beállítástól függetlenül. Csak akkor használja site: , ha ismeri a tartomány tartalmát.

Képek szűrése

Alapértelmezés szerint a Image Search API a lekérdezés szempontjából releváns összes képet visszaadja. Ha szűrni szeretné a Bing által visszaadott képeket (például ha csak átlátszó háttérrel vagy adott méretű képeket szeretne visszaadni), használja a következő lekérdezési paramétereket:

• aspect – Képek szűrése méretarány szerint (például standard vagy széles képernyős képek).
• szín – Képek szűrése domináns szín vagy fekete-fehér alapján.
• frissesség – Képek szűrése kor szerint (például a Bing által az elmúlt héten felfedezett képek).
• magasság, szélesség – Képek szűrése szélesség és magasság szerint.
• imageContent – Képek szűrése tartalom alapján (például olyan képek, amelyek csak egy személy arcát jelenítik meg).
• imageType – Képek szűrése típus szerint (például ClipArt-elemek, animált GIF-ek vagy átlátszó hátterek).
• licenc – A rendszerképek szűrése a webhelyhez társított licenc típusa alapján.
• méret – Képek szűrése méret szerint, például 200x200 képpontig kis méretű képek.

Ha egy konkrét tartományban található képeket szeretne lekérni, használja a site: lekérdezési operátort.

Az alábbi példa bemutatja, hogyan szerezhet be kisebb képeket ContosoSailing.com, amelyeket a Bing az elmúlt héten észlelt.

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 Image Search válaszformátum

A Bing válaszüzenete tartalmaz egy Képek választ, amely tartalmazza az Azure AI-szolgáltatások által a lekérdezés szempontjából relevánsnak ítélt képek listáját. A listában szereplő képobjektumok a következő információkat tartalmazzák a képről: az URL-cím, a méret, a méretei, a kódolási formátuma, a kép miniatűrjének URL-címe és a miniatűr méretei.

Megjegyzés

• A képeket a válaszban megadott sorrendben kell megjeleníteni.
• Mivel az URL-formátumok és a paraméterek értesítés nélkül változhatnak, használja az összes URL-címet. Az URL-formátumtól vagy paraméterekből csak a feljegyzett adatoktól függhet.

{
    "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"
},

Amikor meghívja a Bing Image Search API-t, a Bing visszaad egy eredménylistát. A lista a lekérdezéshez kapcsolódó összes találat egy részét tartalmazza. A válasz totalEstimatedMatches mezője az összes megtekinthető kép becsült számát adja meg. A többi kép lapozásával kapcsolatos részletekért lásd: Lapozóképek.

Következő lépések

Ha még nem próbálta ki a Bing Image Search API-t, próbálkozzon egy rövid útmutatóval. Ha összetettebb megoldást keres, próbálja ki az oktatóanyagot egyoldalas webalkalmazás létrehozásához.