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

  1. 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.

  2. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  4. Ative a API Cloud Vision.

    Ative a API

    5.

  5. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  6. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  7. Ative a API Cloud Vision.

    Ative a API

    8.

Criar um bucket do Cloud Storage

  1. No console do Cloud, acesse a página Buckets do Cloud Storage.

    Acessar a página "Buckets"

  2. Clique em Criar bucket.
  3. 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.
  4. Clique em Criar.

Fazer uma solicitação ao serviço da API Cloud Vision

  1. Download demo-img.jpg. Talvez seja necessário clicar com o botão direito do mouse no link.

  2. Abra a página "Buckets do Cloud Storage".

  3. Selecione o bucket que você criou na seção anterior.

  4. Clique em Enviar arquivos e selecione o arquivo demo-img.jpg para fazer upload da sua máquina local ao bucket do Cloud Storage.

    Botão "Fazer upload de arquivos".
    Este é o arquivo de imagem que você acabou de enviar:
    Duas mulheres andando de bicicleta em Jacarta.
    Crédito da imagem: Rohiim Ariful em Unsplash.

  5. Depois que o arquivo for enviado e aparecer no bucket do Cloud Storage, compartilhe a imagem publicamente.

  6. Na seção Testar este método, preencha o modelo interativo do API Explorer substituindo cloud-samples-data/vision no campo image.source.imageUri pelo nome do bucket do Cloud Storage enviado. o arquivo demo-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"
        }
      }
    }
  ]
}

  7. 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