Bom dia, boa tarde, boa noite!
Essa é a sexta parte da série sobre o projeto Video Creator, onde mostrarei um pouco sobre o Bing Custom Search.
Se você entrou direto nesse post, te aconselho a começar por aqui, para entender exatamente do que se trata essa série.
Sobre essa parte
Aqui resolvi seguir um caminho um pouco diferente do projeto original, que utilizou o Custom Search do Google, e resolvi utilizar o Bing Custom Search para realizar a busca pelas imagens.
Nos testes que realizei, os resultados do Google não foram satisfatórios, trazendo imagens completamente sem ligação com o conteúdo. Não sei o porquê!
Então resolvi pesquisar outras formas de buscar imagens e gostei muito do Bing, tanto na acurácia dos resultados, quando nas opções de filtros disponíveis.
Requisitos:
O caminho não é muito diferente do Google, você precisará de:
1) Criar conta em https://portal.azure.com/
2) Criar uma subscription pay as you go
3) Criar o bing resource com Free Tier
4) Criar uma instancia do bing custom search
Criando a conta na Azure:
Este passo é muito simples, basta entrar nesse endereço: https://portal.azure.com e clicar em criar conta:
Os próximos passos, é o mesmo de qualquer serviço web.
Criar uma subscription pay as you go
Ao finalizar a criação da conta e realizar o login, você verá as seguinte tela:
Clique em Subscriptions e depois, na opção Add +. Na tela que abrir, escolha Pay as you Go. Você pode criar uma Free trial se quiser. Como o recurso possui um Free tier, se você ficar dentro dos limites, você não será cobrado.
Agora vem uma parte um pouco mais chata, que é onde você precisa preencher alguns dados pessoais, e os dados da forma de pagamento.
Reforçando: Para este recurso que utilizei no projeto, vamos usar a camada de Free tier. Se você respeitar os limites dessa camada, você não será cobrado.
Criar o Bing Custom Search
Após a criação da subscription, busque por bing resource no topo da pagina, e escolha a opção Bing Resources na seção Services
Na tela que abrir, clique em Add+ e depois em Bing Custom Search.
Na nova tela, dê um nome para o recurso, selecione a subscription, e no Pricing Tier, selecione a opção F0, essa opção é referente ao Free Tier. Lembre-se de respeitar os limites de chamada.
Após tudo preenchido, clique em criar. Pronto :D.
Agora entre na página do recurso que você acabou de criar, e procure por Manage keys e clique em click here to manage keys.
Na tela que abrir você terá acesso a 2 chaves, você precisará delas para fazer as chamadas.
Eu salvei a Key 1 dentro do atributo azure_subscription_key no meu arquivo credentials.yml.
Criar uma instancia do bing custom search
Acesso a página https://www.customsearch.ai/applications e faça login com sua conta Azure.
Clique em New Instance. Na tela que abrir, digite um nome para a nova instancia.
Após a nova instancia criada, clique nela e vc entrará na tela de configuração dessa instancia. No topo da página, clique em Production:
Precisaremos apenas guardar a Custom Configuration ID. Criei uma variável dentro do arquivo credentials.yml chamada bing_custom_config_id, onde eu guardei esse ID.
E agora?!
Nesse momento, já temos os recursos necessários para realizar a pesquisa das imagens.
Mas se quiser testar, na página do recurso no Portal Azure, vai ter uma aba chamada Sample code, onde você terá alguns exemplos de código para testar.
Você precisará apenas da subscription key, que é a Key do recurso, o endpoint e o id da instancia do Custom Search que criamos logo acima.
Próximo passo? Buscar as imagens 😀
Abraço