Получение набирающих популярность изображений из Интернета
Предупреждение
30 октября 2020 г. API Поиск Bing перенесены из служб ИИ Azure в Поиск Bing Services. Эта документация приводится только для справки. Обновленную информацию см. в документации по API Поиска Bing. Инструкции по созданию ресурсов Azure для Поиска MS Bing см. в статье о том, как создать ресурс для Поиска MS Bing с помощью Azure Marketplace.
Чтобы получить изображения, набирающие сегодня популярность, отправьте следующий запрос GET:
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
В настоящее время API поиска изображений, набирающих популярность, поддерживается только для следующих рынков:
- en-US (английский, США)
- en-CA (английский, Канада)
- en-AU (английский, Австралия)
- zh-CN (китайский, Китай)
Ответ содержит объект TrendingImages, который представляет собой список изображений, разделенных по категориям. Используйте параметр title
категории, чтобы сгруппировать изображения для удобства пользователей. Категории могут изменяться каждый день.
{
"_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
}
}
}]
}]
}
Каждый элемент содержит изображение и способы получения связанных изображений. Для получения связанных изображений можно использовать параметр запроса text
, чтобы вызвать API для поиска изображений и отобразить связанные изображения самостоятельно. Также можно использовать URL-адрес в параметре webSearchUrl
, чтобы перенаправить пользователя на страницу Bing с результатами поиска изображений, которая содержит связанные изображения.
Если для получения связанных изображений вы вызываете API для поиска изображений, то задайте для параметра запроса id значение идентификатора в поле id
. Указав идентификатор, вы гарантируете, что ответ будет содержать изображение (это первое изображение в ответе) и связанные с ним изображения. Кроме того, в качестве значения параметра запроса q укажите текст из поля text
объекта query
.
В приведенном ниже примере показано, как использовать идентификатор изображения для получения изображений, связанных с г-ном Смитом (Mr. Smith) из предыдущего ответа API для поиска изображений, набирающих популярность.
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