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

Criar um bucket do Cloud Storage

  1. In the Google Cloud console, go to the Cloud Storage Buckets page.

    Go to Buckets page

  2. Click Create bucket.
  3. On the Create a bucket page, enter your bucket information. To go to the next step, click Continue.
    • For Name your bucket, enter a unique bucket name. Don't include sensitive information in the bucket name, because the bucket namespace is global and publicly visible.
    • For Choose where to store your data, do the following:
      • Select a Location type option.
      • Select a Location option.
    • For Choose a default storage class for your data, select the following: Standard.
    • For Choose how to control access to objects, select an Access control option.
    • For Advanced settings (optional), specify an encryption method, a retention policy, or bucket labels.
  4. Click Create.

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