Início Rápido: Procurar imagens com a API REST da Pesquisa de Imagens do Bing e o Python
Aviso
A 30 de outubro de 2020, as APIs de Pesquisa do Bing passaram dos serviços de IA do Azure para os Serviços Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, veja a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a pesquisa do Bing, veja Criar um recurso de Pesquisa do Bing através do Azure Marketplace.
Utilize este início rápido para saber como enviar pedidos de pesquisa para a API de Pesquisa de Imagens do Bing. Esta aplicação Python envia uma consulta de pesquisa para a API e apresenta o URL da primeira imagem nos resultados. Embora esta aplicação esteja escrita no Python, a API é um serviço Web RESTful compatível com a maioria das linguagens de programação.
Pré-requisitos
Criar e inicializar a aplicação
Crie um novo ficheiro Python no seu IDE ou editor favorito e importe os seguintes módulos. Crie uma variável para a sua chave de subscrição, ponto final de pesquisa e termo de pesquisa. No
search_url
, pode utilizar o ponto final global no seguinte código ou utilizar o ponto final de subdomínio personalizado apresentado no portal do Azure do recurso.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"
Adicione a chave de subscrição ao
Ocp-Apim-Subscription-Key
cabeçalho ao criar um dicionário e ao adicionar a chave como um valor.headers = {"Ocp-Apim-Subscription-Key" : subscription_key}
Criar e enviar um pedido de pesquisa
Crie um dicionário para os parâmetros do pedido de pesquisa. Adicione o termo de pesquisa ao
q
parâmetro . Defina olicense
parâmetro parapublic
procurar imagens no domínio público. Defina oimageType
paraphoto
para procurar apenas fotografias.params = {"q": search_term, "license": "public", "imageType": "photo"}
Utilize a
requests
biblioteca para chamar a API de Pesquisa de Imagens do Bing. Adicione o cabeçalho e os parâmetros ao pedido e devolva a resposta como um objeto JSON. Obtenha os URLs para várias imagens em miniatura do campo dathumbnailUrl
resposta.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]]
Ver a resposta
Crie uma nova figura com quatro colunas e quatro linhas com a biblioteca matplotlib.
Itere através das linhas e colunas da figura e utilize o método da
Image.open()
biblioteca PIL para adicionar uma miniatura de imagem a cada espaço.Utilize
plt.show()
para desenhar a figura e apresentar as imagens.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()
Resposta JSON de exemplo
As respostas da API de Pesquisa de Imagens do Bing são devolvidas como JSON. Esta resposta de amostra foi truncada para mostrar um único resultado.
{
"_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"
}]
}
Passos seguintes
Bing Image Search single-page app tutorial (Tutorial de aplicação de página única da Pesquisa de Imagens do Bing)
- O que é a API de Pesquisa de Imagens do Bing?
- Detalhes dos preços das APIs Pesquisa do Bing
- Documentação dos serviços de IA do Azure
- Bing Image Search API reference (Referência da API de Pesquisa de Imagens do Bing)