Abrufen von Bildern aus dem Web mit der Bing Image Search-API

Warnung

Am 30. Oktober 2020 wurden die Bing Search-APIs von Azure AI-Diensten zu Bing Search Services verschoben. Diese Dokumentation wird nur zur Referenz bereitgestellt. Eine aktualisierte Dokumentation finden Sie in der Dokumentation zu den Bing-Suche-APIs. Anweisungen zum Erstellen neuer Azure-Ressourcen für die Bing-Suche finden Sie unter Erstellen einer Ressource für die Bing-Suche über Azure Marketplace.

Wenn Sie die REST-API der Bing-Bildsuche verwenden, können Sie Bilder aus dem Web abrufen, die mit Ihrem Suchbegriff zusammenhängen, indem Sie die folgende GET-Anforderung senden:

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

Verwenden Sie den q Abfrageparameter für ihren url-codierten Suchbegriff. Wenn Sie beispielsweise Segeljolleneingeben, stellen Sie q auf sailing+dinghies oder sailing%20dinghiesein.

Wichtig

• Alle Anforderungen müssen von einem Server und nicht von einem Client erfolgen.
• Wenn Sie zum ersten Mal eine der Bing-Such-APIs aufrufen, schließen Sie nicht den Client-ID-Header ein. Schließen Sie die Client-ID nur ein, wenn Sie zuvor eine Bing-API aufgerufen haben, die eine Client-ID für den Benutzer und die Gerätekombination zurückgegeben hat.

Abrufen von Bildern aus einer bestimmten Webdomäne

Um Bilder aus einer bestimmten Domäne abzurufen, verwenden Sie den site: Abfrageoperator.

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

Hinweis

Antworten auf Abfragen, die den site:-Operator verwenden, können erwachsene Inhalte enthalten, unabhängig von der Einstellung safeSearch. Verwenden Sie site: nur, wenn Sie den Inhalt der Domäne kennen.

Filtern von Bildern

Standardmäßig gibt die Bildsuche-API alle Bilder zurück, die für die Abfrage relevant sind. Wenn Sie die von Bing zurückgegebenen Bilder filtern möchten (um z. B. nur Bilder mit einem transparenten Hintergrund oder einer bestimmten Größe zurückzugeben), verwenden Sie die folgenden Abfrageparameter:

• Aspekt– Bilder nach Seitenverhältnis filtern (z. B. Standard- oder Breitbildbilder).
• Farbe– Filtert Bilder nach dominanter Farbe oder Schwarzweiß.
• Aktualität– Bilder nach Alter filtern (z. B. Bilder, die in der letzten Woche von Bing entdeckt wurden).
• HöheBreite– Bilder nach Breite und Höhe filtern.
• imageContent-– Bilder nach Inhalt filtern (z. B. Bilder, die nur das Gesicht einer Person anzeigen).
• imageType-– Bilder nach Typ filtern (z. B. ClipArt, animierte GIFs oder transparente Hintergründe).
• Lizenz– Filtern Sie Bilder nach dem Lizenztyp, der der Website zugeordnet ist.
• Größe– Bilder nach Größe filtern, z. B. kleine Bilder bis zu 200 x 200 Pixel.

Zum Abrufen von Bildern aus einer bestimmten Domäne verwenden Sie den Abfrageoperator site:.

Das folgende Beispiel zeigt, wie Sie kleine Bilder von ContosoSailing.com abrufen, die Bing in der letzten Woche entdeckt hat.

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  

Antwortformat der Bing-Bildsuche

Die Antwortnachricht von Bing enthält eine Bilder Antwort, die eine Liste der Bilder enthält, die Azure AI-Dienste als relevant für die Abfrage ermittelt haben. Jedes Bild--Objekt in der Liste enthält die folgenden Informationen zum Bild: die URL, die Größe, die Abmessungen, das Codierungsformat, eine URL zu einer Miniaturansicht des Bilds und die Abmessungen der Miniaturansicht.

Hinweis

• Bilder müssen in der in der Antwort angegebenen Reihenfolge angezeigt werden.
• Da die URL-Formate und Parameter ohne Ankündigung geändert werden können, verwenden Sie alle URLs as-is. Sie sollten keine Abhängigkeiten vom URL-Format oder den Parametern verwenden, außer wenn angegeben.

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

Wenn Sie die Bing-Bildsuche-API aufrufen, gibt Bing eine Liste der Ergebnisse zurück. Die Liste ist eine Teilmenge der Gesamtanzahl der Ergebnisse, die für die Abfrage relevant sind. Das feld "totalEstimatedMatches" der Antwort enthält eine Schätzung der Anzahl der Bilder, die zum Anzeigen verfügbar sind. Ausführliche Informationen zum Blättern durch die restlichen Bilder finden Sie unter Paging Images.

Nächste Schritte

Wenn Sie die Bing-Bildsuche-API noch nicht ausprobiert haben, probieren Sie es mit einem Schnellstartaus. Wenn Sie nach etwas Komplexerem suchen, probieren Sie das Tutorial aus, um eine Einzelseitenanwendungzu erstellen.