Abrufen von Trendbildern aus dem Web

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.

Um die aktuellen trendigen Bilder abzurufen, senden Sie die folgende GET-Anforderung:

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  

Die Trending Images-API unterstützt derzeit nur die folgenden Märkte:

• en-US (Englisch, USA)
• en-CA (Englisch, Kanada)
• en-AU (Englisch, Australien)
• zh-CN (Chinesisch, China)

Die Antwort enthält ein TrendingImages -Objekt, das Bilder nach Kategorie auflistet. Verwenden Sie die Kategorie title , um die Bilder in Ihrer Benutzeroberfläche zu gruppieren. Die Kategorien können täglich geändert werden.

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

Jede Kachel enthält ein Bild und Optionen zum Abrufen verwandter Bilder. Um die zugehörigen Bilder abzurufen, können Sie die Abfrage text verwenden, um die Bildsuch-API aufzurufen und die zugehörigen Bilder selbst anzuzeigen. Alternativ können Sie die URL webSearchUrl verwenden, um den Benutzer zur Suchergebnisseite von Bing zu bringen, die die zugehörigen Bilder enthält.

Wenn Sie die Bildsuche-API aufrufen, um die zugehörigen Bilder abzurufen, legen Sie den ID-Abfrageparameter auf die ID im id Feld fest. Durch Angeben der ID wird sichergestellt, dass die Antwort das Bild (das erste Bild in der Antwort) und die zugehörigen Bilder enthält. Legen Sie außerdem den q-Abfrageparameter auf den Text im Feld des querytext Objekts fest.

Das folgende Beispiel zeigt, wie Sie die Bild-ID verwenden, um verwandte Bilder von Mr. Smith in der vorherigen Antwort "Trending Images API" abzurufen.

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