Краткое руководство. Поиск изображений с помощью REST API Bing для поиска изображений и Node.jsQuickstart: Search for images using the Bing Image Search REST API and Node.js

В этом кратком руководстве описано, как отправлять поисковые запросы к API Поиска изображений Bing.Use this quickstart to start sending search requests to the Bing Image Search API. Это приложение на JavaScript отправляет поисковый запрос к API и отображает URL-адрес первого возвращенного в результатах изображения.This JavaScript application sends a search query to the API, and displays the URL of the first image in the results. Хотя это приложение создается на языке JavaScript, API представляет собой веб-службу RESTful, совместимую с большинством языков программирования.While this application is written in Javascript, the API is a RESTful web service compatible with most programming languages.

Исходный код, используемый в данном примере, вместе с дополнительной обработкой ошибок и аннотациями можно получить на GitHub.The source code for this sample is available on GitHub with additional error handling and annotations.

Предварительные требованияPrerequisites

См. также Цены на Cognitive Services. API-интерфейсы поиска Bing.See also Cognitive Services Pricing - Bing Search API.

Создание и инициализация приложенияCreate and initialize the application

  1. Создайте файл JavaScript в избранной интегрированной среде разработки или редакторе и установите степень строгости, а также требования к HTTPS.Create a new JavaScript file in your favorite IDE or editor, and set the strictness and https requirements.

    'use strict';
    let https = require('https');
    
  2. Создайте переменные для конечной точки API, пути поиска изображения API, ключа подписки, а также условия поиска.Create variables for the API endpoint, image API search path, your subscription key, and search term.

    let subscriptionKey = 'enter key here';
    let host = 'api.cognitive.microsoft.com';
    let path = '/bing/v7.0/images/search';
    let term = 'tropical ocean';
    

Создание поискового запроса и запросаConstruct the search request and query.

  1. Используйте переменные из последнего шага для форматирования искомого URL-адреса для запроса API.Use the variables from the last step to format a search URL for the API request. Поисковый термин нужно зашифровать в URL-адресе, прежде чем отправлять его в API.Your search term must be URL-encoded before being sent to the API.

    let request_params = {
        method : 'GET',
        hostname : host,
        path : path + '?q=' + encodeURIComponent(search),
        headers : {
        'Ocp-Apim-Subscription-Key' : subscriptionKey,
        }
    };
    
  2. Используйте библиотеку запроса для отправки запроса к API.Use the request library to send your query to the API. response_handler определится в следующем разделе.response_handler will be defined in the next section.

    let req = https.request(request_params, response_handler);
    req.end();
    

Обработка и анализ ответаHandle and parse the response

  1. Определите функцию с именем response_handler, принимающую HTTP-вызов response как параметр.define a function named response_handler that takes an HTTP call, response, as a parameter. Выполните следующие действия в этой функции:Do the following steps within this function:

    1. Определите переменную для хранения текста ответа JSON.Define a variable to contain the body of the JSON response.

      let response_handler = function (response) {
          let body = '';
      };
      
    2. Сохраните текст ответа при вызове флага data.Store the body of the response when the data flag is called

      response.on('data', function (d) {
          body += d;
      });
      
    3. При возврате флага end переводится в сигнальное получите первый результат из ответа JSON.When an end flag is signaled, get the first result from the JSON response. Выведите URL-адрес для первого изображения, а также общее число возвращенных изображений.Print the URL for the first image, along with the total number of returned images.

      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}`);
       });
      

Пример ответа в формате JSONExample JSON response

Ответы из API Bing для поиска изображений возвращаются в формате JSON.Responses from the Bing Image Search API are returned as JSON. Представленный пример сокращен для отображения только одного результата.This sample response has been truncated to show a single result.

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

Дополнительная информацияNext steps

См. такжеSee also