Detecte rótulos em uma imagem usando a API Cloud Vision
Este guia de início rápido detalha os seguintes processos:
- criação de um bucket do Cloud Storage
- upload da imagem para o Cloud Storage e como torná-la pública
- solicitação para a Vision API com essa imagem
Essas etapas devem demorar cerca de 5 minutos para serem concluídas. É possível armazenar gratuitamente até 5 GB de dados no Cloud Storage e fazer até 1.000 solicitações de recursos para a API Vision por mês, sem custo nenhum.
Antes de começar
Se você ainda não tiver feito isso, configure seu projeto e crie um bucket do Google Cloud Storage, conforme explicado abaixo.
Criar o projeto
- Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
-
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Ative a API Cloud Vision.
-
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Ative a API Cloud Vision.
Criar um bucket do Cloud Storage
- No console do Cloud, acesse a página Buckets do Cloud Storage.
- Clique em Criar bucket.
- Na página Criar um bucket, insira as informações do seu bucket. Para ir à próxima
etapa, clique em Continuar.
- Em Nomear o bucket, insira um nome exclusivo. Não inclua informações confidenciais no nome do bucket já que o namespace dele é global e visível para o público.
-
Em Escolha um local para armazenar seus dados, faça o seguinte:
- Selecione uma opção de Tipo de local.
- Escolha uma opção de Local.
- Em Escolha uma classe de armazenamento padrão para seus dados, selecione o seguinte: Standard.
- Em Escolha como controlar o acesso a objetos, selecione uma opção de Controle de acesso.
- Em Configurações avançadas (opcional), especifique um método de criptografia, uma política de retenção ou rótulos de bucket.
- Clique em Criar.
Fazer uma solicitação ao serviço da API Cloud Vision
Download
demo-img.jpg
. Talvez seja necessário clicar com o botão direito do mouse no link.Selecione o bucket que você criou na seção anterior.
Clique em Enviar arquivos e selecione o arquivo
Este é o arquivo de imagem que você acabou de enviar:demo-img.jpg
para fazer upload da sua máquina local ao bucket do Cloud Storage.Depois que o arquivo for enviado e aparecer no bucket do Cloud Storage, compartilhe a imagem publicamente.
Na seção Testar este método, preencha o modelo interativo do API Explorer substituindo
cloud-samples-data/vision
no campoimage.source.imageUri
pelo nome do bucket do Cloud Storage enviado. o arquivodemo-img.jpg
. O corpo da solicitação deve ter a seguinte aparência:{ "requests": [ { "features": [ { "type": "LABEL_DETECTION" } ], "image": { "source": { "imageUri": "gs://cloud-samples-data/vision/demo-img.jpg" } } } ] }
Clique em Executar para enviar a solicitação ao serviço. A resposta JSON é mostrada acima.
Parabéns! Você fez sua primeira solicitação images.annotate
ao serviço da API Cloud Vision.
Limpar
Para evitar cobranças desnecessárias do Google Cloud Platform, use o console do Google Cloud para excluir seu bucket do Cloud Storage (e seu projeto) se você não precisar deles.
A seguir
- Veja uma lista de todos os tipos de recurso e os respectivos usos.
- Comece a usar a API Vision no idioma que preferir usando uma biblioteca de cliente da API Vision.
- Use os guias de instrução para saber mais sobre recursos específicos, ver anotações de exemplo e anotações para um arquivo ou imagem individual.
- Saiba mais sobre a anotação de imagem e arquivo (PDF/TIFF/GIF) em lote.
- Navegue por uma lista abrangente de amostras de código de biblioteca de cliente.