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. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

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

  4. Enable the Cloud Vision API.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

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

  7. Enable the Cloud Vision API.

    Enable the 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