Pontos finais para a API de 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.
A API de Pesquisa de Imagens inclui três pontos finais. O ponto final 1 devolve imagens da Web com base numa consulta. O ponto final 2 devolve ImageInsights. O ponto final 3 devolve imagens populares.
Pontos Finais
Para obter resultados de imagens com a API do Bing, envie um pedido para um dos seguintes pontos finais. Utilize os cabeçalhos e os parâmetros de URL para definir mais especificações.
Ponto final 1: Devolve imagens relevantes para a consulta de pesquisa do utilizador definida por ?q=""
.
GET https://api.cognitive.microsoft.com/bing/v7.0/images/search
Ponto final 2: Devolve informações sobre uma imagem, utilizando ou GET
POST
.
GET or POST https://api.cognitive.microsoft.com/bing/v7.0/images/details
Um pedido GET devolve informações sobre uma imagem, como páginas Web que incluem a imagem. Inclua o parâmetro insightsToken com um GET
pedido.
Em alternativa, pode incluir uma imagem binária no corpo de um POST
pedido e definir o parâmetro modules como RecognizedEntities
. Isto devolverá um insightsToken para utilizar como parâmetro num pedido subsequente GET
, que devolve informações sobre pessoas na imagem. Defina modules
como para obter todas as informações, exceto RecognizedEntities
nos resultados do POST
sem efetuar outra chamada com o insightsToken
All
.
Ponto final 3: Devolve imagens que estão em tendência com base nos pedidos de pesquisa feitos por outras pessoas. As imagens são separadas em diferentes categorias, por exemplo, com base em pessoas ou eventos notáveis.
GET https://api.cognitive.microsoft.com/bing/v7.0/images/trending
Para obter uma lista de mercados que suportam imagens populares, consulte Imagens Populares.
Para obter detalhes sobre cabeçalhos, parâmetros, códigos de mercado, objetos de resposta, erros, etc., veja a referência da API de Pesquisa de Imagens do Bing v7 .
JSON de Resposta
A resposta a um pedido de pesquisa de imagens inclui resultados como objetos JSON. Para obter exemplos de análise dos resultados, veja o tutorial e o código fonte.
Passos seguintes
As APIs do Bing suportam ações de pesquisa que devolvem resultados de acordo com o respetivo tipo. Todos os pontos finais de pesquisa devolvem resultados como objetos de resposta JSON. Todos os pontos finais suportam consultas que devolvem um idioma e/ou localização específicos por longitude, latitude e raio de pesquisa.
Para obter informações completas sobre os parâmetros suportados por cada ponto final, consulte as páginas de referência para cada tipo. Para obter exemplos de pedidos básicos com a API de pesquisa de imagens, veja Inícios Rápidos da Pesquisa de Imagens.