Pobieranie popularnych obrazów z Internetu

Ostrzeżenie

30 października 2020 r. interfejsy API Wyszukiwanie Bing zostały przeniesione z usług Azure AI do usług Wyszukiwanie Bing Services. Ta dokumentacja jest udostępniana tylko do celów referencyjnych. Aby uzyskać zaktualizowaną dokumentację, zobacz dokumentację interfejsu API wyszukiwania Bing. Aby uzyskać instrukcje dotyczące tworzenia nowych zasobów platformy Azure na potrzeby wyszukiwania Bing, zobacz Tworzenie zasobu Wyszukiwanie Bing za pośrednictwem Azure Marketplace.

Aby uzyskać dzisiejsze popularne obrazy, wyślij następujące żądanie GET:

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  

Interfejs API trendów obrazów obsługuje obecnie tylko następujące rynki:

• en-US (angielski, Stany Zjednoczone)
• en-CA (angielski, Kanada)
• en-AU (angielski, Australia)
• zh-CN (chiński, Chiny)

Odpowiedź zawiera obiekt TrendingImages , który wyświetla listę obrazów według kategorii. Użyj kategorii title , aby pogrupować obrazy w środowisku użytkownika. Kategorie mogą zmieniać się codziennie.

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

Każdy kafelek zawiera obraz i opcje pobierania powiązanych obrazów. Aby uzyskać powiązane obrazy, możesz użyć zapytania text do wywołania interfejsu API wyszukiwania obrazów i wyświetlenia powiązanych obrazów samodzielnie. Możesz też użyć adresu URL w webSearchUrl pliku , aby przejąć użytkownika na stronę wyników wyszukiwania obrazów usługi Bing, która zawiera powiązane obrazy.

Jeśli wywołasz interfejs API wyszukiwania obrazów, aby pobrać powiązane obrazy, ustaw parametr zapytania id na identyfikator w id polu. Określenie identyfikatora gwarantuje, że odpowiedź zawiera obraz (jest to pierwszy obraz w odpowiedzi) i powiązane obrazy. Ponadto ustaw parametr zapytania q na tekst w query polu obiektu text .

W poniższym przykładzie pokazano, jak za pomocą identyfikatora obrazu uzyskać powiązane obrazy pana Smitha w poprzedniej odpowiedzi interfejsu API 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