Início Rápido: Procurar imagens com a API REST e o PHP da Pesquisa de Imagens do Bing
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 guia de início rápido para fazer a sua primeira chamada à API de Pesquisa de Imagens do Bing e receber uma resposta JSON. A aplicação simples neste artigo envia uma consulta de pesquisa e mostra os resultados não processados.
Embora esta aplicação esteja escrita no PHP, a API é um serviço Web RESTful compatível com qualquer linguagem de programação que possa fazer pedidos HTTP e analisar JSON.
Pré-requisitos
Para obter mais informações, veja Preços dos serviços de IA do Azure - Pesquisa do Bing API.
Criar e inicializar a aplicação
Para executar esta aplicação, siga estes passos:
Certifique-se de que o suporte HTTP seguro está ativado no seu ficheiro
php.ini
. Para o Windows, este ficheiro está localizado em C:\windows.Crie um novo projeto PHP no seu IDE ou editor preferido.
Defina o ponto final da API, a sua chave de subscrição e o termo de pesquisa. O ponto final pode ser o ponto final global no código seguinte ou o ponto final de subdomínio personalizado apresentado no portal do Azure do recurso.
$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';
Construir e efetuar um pedido HTTP
Utilize as variáveis do último passo para preparar um pedido HTTP para a API de Pesquisa de Imagens.
$headers = "Ocp-Apim-Subscription-Key: $key\r\n"; $options = array ( 'http' => array ( 'header' => $headers, 'method' => 'GET' ));
Envie o pedido Web e obtenha a resposta JSON.
$context = stream_context_create($options); $result = file_get_contents($url . "?q=" . urlencode($query), false, $context);
Processar e imprimir o JSON
Processe e imprima a resposta JSON devolvida.
$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);
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)
Ver também
- O que é a API de Pesquisa de Imagens do Bing?
- Experimentar uma demonstração interativa online
- 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)