1. Antes de começar
No início do programa de aprendizado da pesquisa de imagens de produtos, você aprendeu a chamar um back-end de pesquisa de produtos criado com o Product Search da API Vision para produtos visualmente semelhantes a partir de um catálogo de produtos.
Neste codelab, você aprenderá a criar um back-end semelhante, mas com seu catálogo de produtos.
O que você aprenderá
- Como criar um back-end de pesquisa de produtos com a Pesquisa de produtos da API Vision
- Como configurar a chave de API para acessar a API Vision em apps para dispositivos móveis
Pré-requisitos
- Uma conta do Google Cloud com faturamento ativado (pode ser uma conta de teste gratuita)
2. Sobre a Pesquisa de produtos da API Vision
A Pesquisa de produtos da API Vision é um recurso do Google Cloud que permite que os varejistas criem produtos, cada um com imagens de referência que descrevem visualmente o produto com base em um conjunto de pontos de vista. Os varejistas podem adicionar esses produtos aos conjuntos de produtos. Atualmente, a Pesquisa de produtos da API Vision é compatível com as seguintes categorias de produtos: artigos domésticos, vestuário, brinquedos, produtos embalados e produtos em geral.
Quando os usuários consultam o conjunto de produtos com as próprias imagens, a Pesquisa de produtos da API Vision aplica o aprendizado de máquina para comparar o produto na imagem de consulta do usuário com as imagens no conjunto de produtos do varejista. Em seguida, ela retorna uma lista classificada de resultados visualmente e semânticos semelhantes.
3. Crie o back-end com o Google Cloud
Antes no programa de aprendizado da pesquisa de imagens do produto, você usou um back-end de pesquisa de produtos de demonstração criado com a Pesquisa de produtos da API Vision. Crie o mesmo back-end na sua conta do Google Cloud seguindo este tutorial:
Depois de concluir o tutorial, siga as etapas abaixo para configurar uma chave de API e chamar o back-end dos seus apps para dispositivos móveis.
4. Configurar chave de API
No guia de início rápido da Pesquisa de produtos da API Vision, você criou um back-end de pesquisa de produtos que pode usar uma imagem de consulta para retornar produtos visualmente semelhantes. Para chamar a API Product Search de um app para dispositivos móveis, você precisa configurar uma chave de API e restringir o acesso dela aos seus próprios apps para dispositivos móveis a fim de evitar uso não autorizado.
Criar uma chave de API
- Acesse Console do Cloud > APIs e serviços > Credenciais. Você também pode clicar neste URL e selecionar o projeto usado no guia de início rápido do Google Shopping.
- Selecione Criar credenciais > Chave de API. Você verá esta caixa de diálogo se sua chave de API tiver sido criada corretamente:
Anote essa chave de API. Ele será usado mais adiante neste codelab.
Restrinja o acesso à chave de API
Ao ver a solicitação acima, selecione Restringir chave.
Siga as instruções na tela para aplicar essas restrições:
- Restrições de aplicativos > Apps Android
- Restrições de API > Chave de restrição > API Cloud Vision
5. Fazer o download e executar o app para dispositivos móveis
É possível fazer o download do app para Android que você criou anteriormente que usava o back-end de pesquisa do produto de demonstração e alterá-lo para usar o novo back-end que acabou de criar.
Fazer o download do código
Clique no link abaixo para fazer o download de todo o código para este codelab:
Descompacte o arquivo ZIP transferido por download. Isso descompactará uma pasta raiz (odml-pathway-codelabs) com todos os recursos necessários. Neste codelab, você só precisará das origens no subdiretório product-search/codelab2/android/final.
O app usa a API ML Kit Object Detection and Tracking e um back-end de pesquisa de produto de demonstração criado com a Vision API Product Search para que os usuários possam foto e pesquisa produtos visualmente semelhantes no catálogo de produtos de demonstração.
Importar o app para o Android Studio
Para começar, importe o app starter para o Android Studio.
Acesse o Android Studio, selecione Import Project (Gradle, Eclipse ADT, etc.) e escolha a pasta product-search/codelab2/android/final no código-fonte que você transferiu por download anteriormente.
Executar o app inicial
Agora que você importou o projeto para o Android Studio, está pronto para executar o app pela primeira vez.
Conecte o dispositivo Android via USB ao seu host ou Iniciar o Android Studio e clique em Run ( 
) na barra de ferramentas do Android Studio.
Se esse botão estiver desativado, importe apenas o arquivo final/app/build.gradle, e não o repositório inteiro.
Agora, o app deve ter sido aberto no seu dispositivo Android. Já está funcionando, mas usa o back-end de pesquisa de produto demo que o Google implantou para você.
Em seguida, você atualizará o app para usar o back-end criado anteriormente neste codelab.
6. Atualizar os endpoints da API
Alterar as configurações da API
Na classe ProductSearchAPIClient, você verá as configurações do back-end da pesquisa de produtos já definidas. Comente as configurações do back-end de demonstração:
// Define the product search backend
// Option 1: Use the demo project that we have already deployed for you
// const val VISION_API_URL =
"https://us-central1-odml-codelabs.cloudfunctions.net/productSearch"
// const val VISION_API_KEY = ""
// const val VISION_API_PROJECT_ID = "odml-codelabs"
// const val VISION_API_LOCATION_ID = "us-east1"
// const val VISION_API_PRODUCT_SET_ID = "product_set0"
Em seguida, substitua-os pela sua configuração:
// Option 2: Go through the Vision API Product Search quickstart and deploy to your project.
// Fill in the const below with your project info.
const val VISION_API_URL = "https://vision.googleapis.com/v1"
const val VISION_API_KEY = "YOUR_API_KEY"
const val VISION_API_PROJECT_ID = "YOUR_PROJECT_ID"
const val VISION_API_LOCATION_ID = "YOUR_LOCATION_ID"
const val VISION_API_PRODUCT_SET_ID = "YOUR_PRODUCT_SET_ID"
- VISION_API_URL é o endpoint da API Cloud Vision.
- VISION_API_KEY é a chave de API que você criou anteriormente neste codelab.
- VISION_API_PROJECT_ID , VISION_API_LOCATION_ID , VISION_API_PRODUCT_SET_ID são os valores que você usou no guia de início rápido da Pesquisa de produtos da API Vision neste codelab.
Executar
Agora, clique em Run ( ) na barra de ferramentas do Android Studio. Depois que o app for carregado, toque em qualquer imagem predefinida, selecione um objeto detectado e toque no botão Pesquisar para ver os resultados da pesquisa. Agora, o aplicativo está usando o back-end de pesquisa de produtos que você acabou de criar.
7. Parabéns!
Você aprendeu a criar um back-end de pesquisa de produtos usando a Pesquisa de produtos da API Vision.
Isso é tudo o que você precisa para começar a usar.
O que vimos
- Como criar um back-end de pesquisa de produto usando seu catálogo de produtos e a Pesquisa de produtos da API Vision
- Como configurar uma chave de API para chamar o back-end da Pesquisa de produtos de um app para dispositivos móveis
- Como chamar o back-end de um app para dispositivos móveis
Próximas etapas
- Assista a este vídeo sobre como usar a Pesquisa de produtos da API Vision para criar um closet inteligente.
- Confira o programa de aprendizado de ML no dispositivo do Google Shopping para conhecer todas as etapas necessárias para criar uma pesquisa de produtos
- Aplique o que você aprendeu no seu próprio app