Detecte rótulos em uma imagem usando a API Cloud Vision

Neste guia de início rápido, você aprende a:

  • Criar um bucket do Cloud Storage.
  • Fazer upload da imagem no Cloud Storage e torne o arquivo acessível publicamente.
  • Fazer uma solicitação para a API Vision com a imagem

Essas etapas levam cerca de cinco minutos para serem concluídas. É possível armazenar até 5 GB de dados no Cloud Storage sem custo financeiro e fazer até 1.000 solicitações de recursos por mês para a API Vision sem custo financeiro.

Antes de começar

Se você ainda não tiver feito isso, use as instruções a seguir para configurar o projeto e criar um bucket do Cloud Storage.

Crie 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 Cloud Vision

  1. Salve uma versão local do arquivo de imagem de exemplo (demo-img.jpg).

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

    Acessar buckets

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

  4. Clique em Fazer upload de arquivos e selecione a versão local do arquivo demo-img.jpg para fazer upload para o 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 no qual foi feito upload do 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 aparece após o corpo da solicitação.

Parabéns! Você fez sua primeira solicitação images.annotate ao Cloud Vision.

Limpar

Para evitar cobranças desnecessárias do Google Cloud, use o console do Google Cloud para excluir o bucket do Cloud Storage e seu projeto se não precisar deles.

A seguir