Detete etiquetas numa imagem através da linha de comandos

Detete etiquetas numa imagem através da linha de comandos

Esta página mostra como enviar três pedidos de deteção e anotação de funcionalidades para a API Vision através da interface REST e do comando curl.

A API Vision permite a integração fácil das tecnologias de reconhecimento de visão da Google nas aplicações dos programadores. Pode enviar dados de imagens e tipos de funcionalidades desejados para a API Vision, que devolve uma resposta correspondente com base nos atributos de imagem nos quais tem interesse. Para mais informações sobre os tipos de funcionalidades oferecidos, consulte a lista de todas as funcionalidades da API Vision.

Antes de começar

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.
Install the Google Cloud CLI.
Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro, tem de iniciar sessão na CLI gcloud com a sua identidade federada.
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
Create or select a Google Cloud project.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.
Verify that billing is enabled for your Google Cloud project.
Enable the Vision API:
gcloud services enable vision.googleapis.com
Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/storage.objectViewer
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Replace the following:
• PROJECT_ID: your project ID.
• USER_IDENTIFIER: the identifier for your user account—for example, [e-mail].
• ROLE: the IAM role that you grant to your user account.

Install the Google Cloud CLI.

Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro, tem de iniciar sessão na CLI gcloud com a sua identidade federada.

Para inicializar a CLI gcloud, execute o seguinte comando:

gcloud init

Create or select a Google Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.

Verify that billing is enabled for your Google Cloud project.

Enable the Vision API:

gcloud services enable vision.googleapis.com

Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/storage.objectViewer

gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

Replace the following:

• PROJECT_ID: your project ID.
• USER_IDENTIFIER: the identifier for your user account—for example, [e-mail].
• ROLE: the IAM role that you grant to your user account.

Faça um pedido de anotação de imagem

Depois de concluir os passos em Antes de começar, pode usar a API Vision para anotar um ficheiro de imagem.

Neste exemplo, usa o curl para enviar um pedido para a API Vision com a seguinte imagem:

URI do Cloud Storage:

gs://cloud-samples-data/vision/using_curl/shanghai.jpeg

URL HTTPS:

https://console.cloud.google.com/storage/browser/cloud-samples-data/vision/using_curl/shanghai.jpeg



Créditos da imagem: Steve Long no Unsplash.

Crie o JSON do pedido

O ficheiro request.json seguinte demonstra como pedir três images:annotate funcionalidades e limitar os resultados na resposta.

Crie o ficheiro de pedido JSON com o seguinte texto e guarde-o como um request.json ficheiro de texto simples no seu diretório de trabalho:

request.json

{
  "requests": [
    {
      "image": {
        "source": {
          "imageUri": "gs://cloud-samples-data/vision/using_curl/shanghai.jpeg"
        }
      },
      "features": [
        {
          "type": "LABEL_DETECTION",
          "maxResults": 3
        },
        {
          "type": "OBJECT_LOCALIZATION",
          "maxResults": 1
        },
        {
          "type": "TEXT_DETECTION",
          "maxResults": 1,
          "model": "builtin/latest"
        }
      ]
    }
  ]
}

Detalhes do valor do campo

• image.source.gcsImageUri - Indica a imagem armazenada num contentor do Cloud Storage. Altera este pedido para image.source.imageUri para um URI disponível publicamente ou image.content para transmitir uma representação de uma imagem como uma string codificada em base64.
• features - Um objeto que representa um tipo de elemento específico. Pode pedir vários tipos de funcionalidades para uma única imagem.
• type - O valor enum que especifica uma funcionalidade.
• maxResults (opcional) – Um valor limitador dos resultados devolvidos.
• model (opcional) – Se aplicável, pode especificar builtin/stable (a predefinição se não estiver definida) ou builtin/latest para escolher o seu modelo. Consulte o tópico Notas de lançamento para ver uma lista de modelos atualizados recentemente.

Envie o pedido

Usa o curl e o conteúdo do corpo de request.json para enviar o pedido à API Vision. Introduza o seguinte na linha de comandos:

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "x-goog-user-project: PROJECT_ID" \
    -H "Content-Type: application/json; charset=utf-8" \
    https://vision.googleapis.com/v1/images:annotate -d @request.json

• O comando curl de exemplo usa o comando gcloud auth print-access-token para obter um token de autenticação.
• Tenha em atenção que, para transmitir um nome de ficheiro para curl, usa a opção -d (para "data") e precede o nome de ficheiro com um sinal @. Este ficheiro deve estar no mesmo diretório em que executa o comando curl.

Interprete a resposta

Deve ver uma resposta JSON semelhante à apresentada abaixo.

O corpo JSON do pedido especificado maxResults para cada tipo de anotação. Consequentemente, verá o seguinte no JSON de resposta:

• três labelAnnotations resultados
• um textAnnotations resultado (abreviado para maior clareza)
• um localizedObjectAnnotations resultado

Resposta

Note: Zero coordinate values omitted. When the API detects a coordinate ("x" or "y") value of 0, that coordinate is omitted in the JSON response. Thus, a response with a bounding poly around the entire image would be
[{},{"x": 100},{"x": 100,"y": 100},{"y": 100}] for an image that is 100 pixels by 100 pixels. For more information, see the API Reference documentation.

{
  "responses": [
    {
      "labelAnnotations": [
        {
          "mid": "/m/09g5pq",
          "description": "People",
          "score": 0.9504782,
          "topicality": 0.9504782
        },
        {
          "mid": "/m/01c8br",
          "description": "Street",
          "score": 0.8911568,
          "topicality": 0.8911568
        },
        {
          "mid": "/m/079bkr",
          "description": "Mode of transport",
          "score": 0.89089024,
          "topicality": 0.89089024
        }
      ],
      "textAnnotations": [
        {
          "locale": "zh",
          "description": "牛牛面馆\n",
          "boundingPoly": {
            "vertices": [
              {
                "x": 159,
                "y": 212
              },
              {
                "x": 947,
                "y": 212
              },
              {
                "x": 947,
                "y": 354
              },
              {
                "x": 159,
                "y": 354
              }
            ]
          }
        },
        ...
      ],
      "fullTextAnnotation": {
        "pages": [
          {
            ...
                "paragraphs": [
                  {
                    ...
                    "words": [
                      {
                        ...
                        "symbols": [
                          {
                            ...
                ],
                "blockType": "TEXT"
              }
            ]
          }
        ],
        "text": "牛牛面馆\n"
      },
      "localizedObjectAnnotations": [
        {
          "mid": "/m/01g317",
          "name": "Person",
          "score": 0.94413143,
          "boundingPoly": {
            "normalizedVertices": [
              {
                "x": 0.26063988,
                "y": 0.46869153
              },
              {
                "x": 0.40736017,
                "y": 0.46869153
              },
              {
                "x": 0.40736017,
                "y": 0.8957791
              },
              {
                "x": 0.26063988,
                "y": 0.8957791
              }
            ]
          }
        }
      ]
    }
  ]
}

Resultados da deteção de etiquetas

1. description: "People", score: 0.950
2. description: "Street", score: 0.891
3. description: "Mode of transport", score: 0.890



Créditos da imagem: Steve Long no Unsplash (anotações adicionadas).

Resultados da deteção de texto

• text: 牛牛面馆\n
• vertices: (x: 159, y: 212), (x: 947, y: 212), (x: 947, y: 354), (x: 159, y: 354 )



Créditos da imagem: Steve Long no Unsplash (anotações adicionadas).

Resultados da deteção de objetos

• name: "Person", score: 0.944
• normalized vertices: (x: 0.260, y: 0.468), (x: 0.407, y: 0.468), (x: 0.407, y: 0.895), (x: 0.260, y: 0.895)



Créditos da imagem: Steve Long no Unsplash (anotações adicionadas).

Parabéns! Enviou o seu primeiro pedido à API Vision.

Limpar

Para evitar incorrer em custos na sua Google Cloud conta pelos recursos usados nesta página, elimine o Google Cloud projeto com os recursos.

Optional: Revoke credentials from the gcloud CLI.

gcloud auth revoke

O que se segue?

• Veja uma lista de todos os tipos de elementos e as respetivas utilizações.
• Comece a usar a Vision API no seu idioma preferencial através de uma biblioteca cliente da Vision API.
• Use os guias de instruções para saber mais sobre funcionalidades específicas, ver exemplos de anotações e obter anotações para um ficheiro ou uma imagem individual.
• Saiba mais sobre a anotação em lote de imagens e ficheiros (PDF/TIFF/GIF).
• Procure numa lista abrangente de exemplos de código da biblioteca cliente.