Быстрый старт: поиск изображений с использованием REST API Bing и Python

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

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

Используйте это краткое руководство, чтобы узнать, как отправлять поисковые запросы в API поиска изображений Bing. Это приложение Python отправляет поисковый запрос в API и отображает URL-адрес первого изображения в результатах. Хотя это приложение написано на Python, API — это веб-служба RESTful, совместимая с большинством языков программирования.

Предпосылки

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

Создайте новый файл Python в любимой интегрированной среде разработки или редакторе и импортируйте следующие модули. Создайте переменную для ключа подписки, конечной точки поиска и термина поиска. Для search_urlэтого можно использовать глобальную конечную точку в следующем коде или использовать конечную точку индивидуального поддомена, отображаемую на портале Azure для ресурса.
```
import requests
import matplotlib.pyplot as plt
from PIL import Image
from io import BytesIO

subscription_key = "your-subscription-key"
search_url = "https://api.cognitive.microsoft.com/bing/v7.0/images/search"
search_term = "puppies"
```
Добавьте ключ подписки в Ocp-Apim-Subscription-Key заголовок, создав словарь и добавив ключ в качестве значения.
```
headers = {"Ocp-Apim-Subscription-Key" : subscription_key}
```

Создание и отправка поискового запроса

Создайте словарь для параметров запроса поиска. Добавьте термин поиска q в параметр. Установите параметр license в значение public, чтобы искать изображения в общедоступном домене. Настройте imageType на photo, чтобы искать только фотографии.
```
params  = {"q": search_term, "license": "public", "imageType": "photo"}
```
Используйте библиотеку requests для вызова API поиска изображений Bing. Добавьте в запрос заголовок и параметры и верните ответ в виде объекта JSON. Получите URL-адреса для нескольких эскизов из поля ответа thumbnailUrl .
```
response = requests.get(search_url, headers=headers, params=params)
response.raise_for_status()
search_results = response.json()
thumbnail_urls = [img["thumbnailUrl"] for img in search_results["value"][:16]]
```

Просмотр ответа

Создайте новую фигуру с четырьмя столбцами и четырьмя строками с помощью библиотеки matplotlib.
Выполните итерацию по строкам и столбцам рисунка и используйте метод библиотеки Image.open() PIL для добавления эскиза изображения в каждое пространство.

Используется plt.show() для рисования фигуры и отображения изображений.

f, axes = plt.subplots(4, 4)
for i in range(4):
    for j in range(4):
        image_data = requests.get(thumbnail_urls[i+4*j])
        image_data.raise_for_status()
        image = Image.open(BytesIO(image_data.content))        
        axes[i][j].imshow(image)
        axes[i][j].axis("off")
plt.show()

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

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

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

Last updated on 2022-01-05