Краткое руководство. Поиск изображений с помощью REST API Bing для поиска изображений и PHP

  • Статья

Предупреждение

30 октября 2020 г. API-интерфейсы Поиск Bing перемещены из служб ИИ Azure в службы Поиск Bing. Эта документация приводится только для справки. Обновленную информацию см. в документации по API Поиска Bing. Инструкции по созданию ресурсов Azure для Поиска Bing приведены в статье Создание ресурса для Поиска Bing с помощью Azure Marketplace.

Используйте это краткое руководство, чтобы вызвать API Bing для поиска изображений и получить ответ в формате JSON. Простое приложение в этой статье отправляет поисковый запрос и отображает необработанные результаты.

Хотя это приложение написано на PHP, API является веб-службой RESTful, совместимой с любым языком программирования, который может выполнять HTTP-запросы и анализировать JSON.

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

Дополнительные сведения см. в статье Цены на службы ИИ Azure — API Поиск Bing.

Создание и инициализация приложения

Чтобы запустить это приложение, сделайте следующее:

  1. Убедитесь, что поддержка безопасного HTTP включена в файле php.ini. В Windows этот файл находится в каталоге C:\windows.

  2. Создайте проект PHP в используемой вами интегрированной среде разработки или редакторе.

  3. Определите конечную точку API, ключ подписки и условие поиска. Эта конечная точка может быть глобальной конечной точкой в следующем коде или конечной точкой личного поддомена, отображаемой на портале Azure для вашего ресурса.

    $endpoint = 'https://api.cognitive.microsoft.com/bing/v7.0/images/search';
// Replace the accessKey string value with your valid access key.
$accessKey = 'enter key here';
$term = 'tropical ocean';

Создание и выполнение HTTP-запроса

  1. Используйте переменные из последнего шага, чтобы подготовить HTTP-запрос к API для поиска изображений.

    $headers = "Ocp-Apim-Subscription-Key: $key\r\n";
$options = array ( 'http' => array (
                        'header' => $headers,
                        'method' => 'GET' ));

  2. Отправьте веб-запрос и получите ответ в формате JSON.

    $context = stream_context_create($options);
$result = file_get_contents($url . "?q=" . urlencode($query), false, $context);

Обработка и вывод JSON

Обработайте и выведите ответ в формате JSON.

$headers = array();
    foreach ($http_response_header as $k => $v) {
        $h = explode(":", $v, 2);
        if (isset($h[1]))
            if (preg_match("/^BingAPIs-/", $h[0]) || preg_match("/^X-MSEdge-/", $h[0]))
                $headers[trim($h[0])] = trim($h[1]);
    }
    return array($headers, $result);

Пример ответа в формате 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"
    }]
}

Дальнейшие действия

Руководство по одностраничным приложениям для API Bing для поиска изображений

См. также раздел