クイック スタート:Bing Image Search REST API と Node.js を使用してイメージを検索する
警告
2020 年 10 月 30 日に、Bing Search API は Azure AI サービスから Bing Search サービスに移行されました。 このドキュメントは、参考用としてのみ提供されています。 更新されたドキュメントについては、Bing search API のドキュメントを参照してください。 Bing 検索用の新しい Azure リソースを作成する手順については、「Azure Marketplace から Bing Search リソースを作成する」を参照してください。
このクイックスタートでは、Bing Image Search API に検索要求を送信する方法について説明します。 この JavaScript アプリケーションは、検索クエリを API に送信し、その結果から最初の画像の URL を表示します。 このアプリケーションは JavaScript で記述されていますが、この API はほとんどのプログラミング言語と互換性のある RESTful Web サービスです。
前提条件
最新バージョンの Node.js。
詳細については、Azure AI サービスの価格 - Bing Search API に関するページを参照してください。
アプリケーションを作成して初期化する
好みの IDE またはエディターで新しい JavaScript ファイルを作成し、厳格度と HTTPS の要件を設定します。
'use strict'; let https = require('https');API エンドポイント、画像 API 検索パス、サブスクリプション キー、および検索用語の変数を作成します。
hostには、次のコードのグローバル エンドポイントか、Azure portal に表示される、対象のリソースのカスタム サブドメイン エンドポイントを使用できます。let subscriptionKey = 'enter key here'; let host = 'api.cognitive.microsoft.com'; let path = '/bing/v7.0/images/search'; let term = 'tropical ocean';
検索要求とクエリを構築します。
最後の手順の変数を使用して、API 要求の検索 URL の書式を設定します。 API に送信する前に、検索語句を URL エンコードします。
let request_params = { method : 'GET', hostname : host, path : path + '?q=' + encodeURIComponent(search), headers : { 'Ocp-Apim-Subscription-Key' : subscriptionKey, } };要求ライブラリを使用してクエリを API に送信します。
let req = https.request(request_params, response_handler); req.end();
応答の処理と解析
HTTP 呼び出し
responseをパラメーターとして受け取るresponse_handlerという名前の関数を定義します。この関数内で、JSON 応答の本文を含む変数を定義します。
let response_handler = function (response) { let body = ''; };dataフラグが呼び出されたら、応答の本文を格納します。response.on('data', function (d) { body += d; });endフラグが通知されたら、JSON 応答から最初の結果を取得します。 返された画像の総数と共に、最初の画像の URL を出力します。response.on('end', function () { let firstImageResult = imageResults.value[0]; console.log(`Image result count: ${imageResults.value.length}`); console.log(`First image thumbnail url: ${firstImageResult.thumbnailUrl}`); console.log(`First image web search url: ${firstImageResult.webSearchUrl}`); });
JSON の応答例
Bing Image Search API からの応答は、JSON として返されます。 このサンプル応答は、1 つの結果だけを表示するように切り詰められています。
{
"_type":"Images",
"instrumentation":{
"_type":"ResponseInstrumentation"
},
"readLink":"images\/search?q=tropical ocean",
"webSearchUrl":"https:\/\/www.bing.com\/images\/search?q=tropical ocean&FORM=OIIARP",
"totalEstimatedMatches":842,
"nextOffset":47,
"value":[
{
"webSearchUrl":"https:\/\/www.bing.com\/images\/search?view=detailv2&FORM=OIIRPO&q=tropical+ocean&id=8607ACDACB243BDEA7E1EF78127DA931E680E3A5&simid=608027248313960152",
"name":"My Life in the Ocean | The greatest WordPress.com site in ...",
"thumbnailUrl":"https:\/\/tse3.mm.bing.net\/th?id=OIP.fmwSKKmKpmZtJiBDps1kLAHaEo&pid=Api",
"datePublished":"2017-11-03T08:51:00.0000000Z",
"contentUrl":"https:\/\/mylifeintheocean.files.wordpress.com\/2012\/11\/tropical-ocean-wallpaper-1920x12003.jpg",
"hostPageUrl":"https:\/\/mylifeintheocean.wordpress.com\/",
"contentSize":"897388 B",
"encodingFormat":"jpeg",
"hostPageDisplayUrl":"https:\/\/mylifeintheocean.wordpress.com",
"width":1920,
"height":1200,
"thumbnail":{
"width":474,
"height":296
},
"imageInsightsToken":"ccid_fmwSKKmK*mid_8607ACDACB243BDEA7E1EF78127DA931E680E3A5*simid_608027248313960152*thid_OIP.fmwSKKmKpmZtJiBDps1kLAHaEo",
"insightsMetadata":{
"recipeSourcesCount":0,
"bestRepresentativeQuery":{
"text":"Tropical Beaches Desktop Wallpaper",
"displayText":"Tropical Beaches Desktop Wallpaper",
"webSearchUrl":"https:\/\/www.bing.com\/images\/search?q=Tropical+Beaches+Desktop+Wallpaper&id=8607ACDACB243BDEA7E1EF78127DA931E680E3A5&FORM=IDBQDM"
},
"pagesIncludingCount":115,
"availableSizesCount":44
},
"imageId":"8607ACDACB243BDEA7E1EF78127DA931E680E3A5",
"accentColor":"0050B2"
}]
}