Web から注目の画像を取得するGet trending images from the web

警告

Bing Search API は、Cognitive Services から Bing Search Services に移行されます。Bing Search APIs are moving from Cognitive Services to Bing Search Services. 2020 年 10 月 30 日 以降、Bing Search の新しいインスタンスは、こちらに記載されているプロセスに従ってプロビジョニングする必要があります。Starting October 30, 2020, any new instances of Bing Search need to be provisioned following the process documented here. Cognitive Services を使用してプロビジョニングされた Bing Search API は、次の 3 年間、または Enterprise Agreement の終わり (どちらか先に発生した方) までサポートされます。Bing Search APIs provisioned using Cognitive Services will be supported for the next three years or until the end of your Enterprise Agreement, whichever happens first. 移行手順については、Bing Search Services に関する記事を参照してください。For migration instructions, see Bing Search Services.

今日の注目の画像を取得するには、次の GET 要求を送信します。To get today's trending images, send the following GET request:

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  

Trending Images API では、現在、次の市場のみがサポートされています。The Trending Images API currently supports only the following markets:

  • en-US (英語、米国)en-US (English, United States)
  • en-CA (英語、カナダ)en-CA (English, Canada)
  • en-AU (英語、オーストラリア)en-AU (English, Australia)
  • zh-CN (中国語、中国)zh-CN (Chinese, China)

応答には、画像をカテゴリ別に一覧表示する TrendingImages オブジェクトが含まれています。The response contains a TrendingImages object that lists images by category. カテゴリの title を使用して、ユーザー エクスペリエンスの画像をグループ化します。Use the category's title to group the images in your user experience. カテゴリは、毎日変わる可能性があります。The categories may change daily.

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

各タイルには、画像と、関連画像を取得するオプションが含まれています。Each tile contains an image and options for getting related images. 関連画像を取得するには、クエリ text を使用して Image Search API を呼び出し、関連画像を自分で表示します。To get the related images, you can use the query text to call the Image Search API and display the related images yourself. または、webSearchUrl 内の URL を使用して、関連画像を含む Bing の画像検索結果ページに移動することもできます。Or, you can use the URL in webSearchUrl to take the user to Bing's images search results page, which contains the related images.

Image Search API を呼び出して関連画像を取得する場合は、id クエリ パラメーターを id フィールド内の ID に設定します。If you call the Image Search API to get the related images, set the id query parameter to the ID in the id field. ID を指定すると、応答に画像 (応答内の最初の画像) とその関連画像が含まれます。Specifying the ID ensures that the response contains the image (it is the first image in the response) and its related images. また、q クエリ パラメーターを query オブジェクトの text フィールドのテキストに設定します。Also, set the q query parameter to the text in the query object's text field.

次の例は、画像 ID を使用して、前の Trending Images API の応答の Mr. Smith の関連画像を取得する方法を示します。The following example shows how to use the image ID to get related images of Mr. Smith in the preceding Trending Images API response.

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