Краткое руководство. Поиск изображений с помощью REST API Bing для поиска изображений и Node.js
Предупреждение
30 октября 2020 г. API Поиск Bing перенесены из служб ИИ Azure в Поиск Bing Services. Эта документация приводится только для справки. Обновленную информацию см. в документации по API Поиска Bing. Инструкции по созданию ресурсов Azure для Поиска MS Bing см. в статье о том, как создать ресурс для Поиска MS Bing с помощью Azure Marketplace.
Узнайте, как отправлять поисковые запросы к API Поиска изображений Bing. Это приложение на JavaScript отправляет поисковый запрос к API и отображает URL-адрес первого возвращенного в результатах изображения. Хотя приложение написано на JavaScript, API представляет собой веб-службу RESTful, совместимую с большинством языков программирования.
Предварительные требования
Последняя версия Node.js.
Дополнительные сведения см. в статье Цены на службы ИИ Azure — API Поиск Bing.
Создание и инициализация приложения
Создайте файл JavaScript в используемых вами интегрированной среде разработки или редакторе, а также укажите степень строгости и требования к HTTPS.
'use strict'; let https = require('https');
Создайте переменные для конечной точки API, пути поиска изображения API, ключа подписки, а также условия поиска. Для
host
можно использовать глобальную конечную точку в следующем коде или конечную точку личного поддомена, отображаемую на портале Azure для вашего ресурса.let subscriptionKey = 'enter key here'; let host = 'api.cognitive.microsoft.com'; let path = '/bing/v7.0/images/search'; let term = 'tropical ocean';
Создание поискового запроса и запроса
Используйте переменные из последнего шага для форматирования искомого URL-адреса для запроса API. Закодируйте поисковый запрос с использованием URL-адреса, прежде чем отправлять его в API.
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();
Обработка и анализ ответа
Определите функцию с именем
response_handler
, принимающую HTTP-вызовresponse
как параметр.В этой функции определите переменную для хранения текста ответа в формате 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
Ответы из API Bing для поиска изображений возвращаются в формате JSON. Представленный пример сокращен для отображения только одного результата.
{
"_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"
}]
}