Trending afbeeldingen ophalen van het web

Waarschuwing

Op 30 oktober 2020 zijn de Zoeken in Bing API's verplaatst van Azure AI-services naar Zoeken in Bing Services. Deze documentatie is alleen bedoeld ter referentie. Zie de bing zoek-API-documentatie voor bijgewerkte documentatie. Zie Een Zoeken in Bing resource maken via de Azure Marketplace voor instructies voor het maken van nieuwe Azure-resources voor Bing Search.

Als u de huidige trending afbeeldingen wilt ophalen, verzendt u de volgende GET-aanvraag:

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  

De Trending Images-API ondersteunt momenteel alleen de volgende markten:

• en-US (Engels, Verenigde Staten)
• en-CA (Engels, Canada)
• en-AU (Engels, Australië)
• zh-CN (Chinees, China)

Het antwoord bevat een TrendingImages-object dat afbeeldingen per categorie weergeeft. Gebruik de categorie om title de afbeeldingen in uw gebruikerservaring te groepeer. De categorieën kunnen dagelijks worden gewijzigd.

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

Elke tegel bevat een afbeelding en opties voor het ophalen van gerelateerde afbeeldingen. Als u de gerelateerde afbeeldingen wilt ophalen, kunt u de query text gebruiken om de Afbeeldingen zoeken-API aan te roepen en de gerelateerde afbeeldingen zelf weer te geven. U kunt ook de URL in webSearchUrl gebruiken om de gebruiker naar de pagina met zoekresultaten voor afbeeldingen van Bing te leiden, die de gerelateerde afbeeldingen bevat.

Als u de Afbeeldingen zoeken-API aanroept om de gerelateerde afbeeldingen op te halen, stelt u de id-queryparameter in op de id in het id veld. Als u de id opgeeft, zorgt u ervoor dat het antwoord de afbeelding (het is de eerste afbeelding in het antwoord) en de bijbehorende afbeeldingen bevat. Stel ook de queryparameter q in op de tekst in het veld van text het query object.

In het volgende voorbeeld ziet u hoe u de afbeeldings-id gebruikt om gerelateerde afbeeldingen van Mr. Smith op te halen in het voorgaande api-antwoord van Trending Images.

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