Rileva le etichette in un'immagine utilizzando la riga di comando

Rileva le etichette in un'immagine utilizzando la riga di comando

Questa pagina mostra come inviare tre richieste di rilevamento e annotazione delle funzionalità all'API Vision utilizzando l'interfaccia REST e il comando curl.

L'API Vision consente di integrare facilmente le tecnologie di riconoscimento visivo di Google nelle applicazioni degli sviluppatori. Puoi inviare dati immagine e tipi di elementi desiderati all'API Vision, che restituisce una risposta corrispondente in base agli attributi dell'immagine che ti interessano. Per ulteriori informazioni sui tipi di funzionalità offerti, consulta l'elenco di tutte le funzionalità dell'API Vision.

Prima di iniziare

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. Install the Google Cloud CLI.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

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

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Vision API:

   gcloud services enable vision.googleapis.com

7. 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 PROJECT_ID with your project ID.

   • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:[e-mail].

   • Replace ROLE with each individual role.
8. Install the Google Cloud CLI.

9. To initialize the gcloud CLI, run the following command:

   gcloud init

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

11. Make sure that billing is enabled for your Google Cloud project.

12. Enable the Vision API:

    gcloud services enable vision.googleapis.com

13. 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 PROJECT_ID with your project ID.

    • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:[e-mail].

    • Replace ROLE with each individual role.

Invia una richiesta di annotazione di immagine

Dopo aver completato i passaggi descritti in Prima di iniziare, puoi utilizzare l'API Vision per annotare un file immagine.

In questo esempio utilizzi curl per inviare una richiesta all'API Vision utilizzando la seguente immagine:

URI 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

Credito immagine: Steve Long su Unsplash.

Crea il file JSON della richiesta

Il seguente file request.json mostra come richiedere tre funzionalità images:annotate e limitare i risultati nella risposta.

Crea il file di richiesta JSON con il testo seguente e salvalo come request.json file di testo normale nella directory di lavoro:

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"
        }
      ]
    }
  ]
}

Dettagli del valore del campo

• image.source.gcsImageUri: indica l'immagine archiviata in un bucket Cloud Storage. Modifica questa richiesta in image.source.imageUri per un URI disponibile pubblicamente o in image.content per passare una rappresentazione di stringa codificata Base64 di un'immagine.
• features: un oggetto che rappresenta un tipo di elemento specifico. Puoi richiedere più tipi di funzionalità per una singola immagine.
• type: il valore enum che specifica una funzionalità.
• maxResults (facoltativo): un valore limite per i risultati restituiti.
• model (facoltativo) - Se applicabile, puoi specificare builtin/stable (il valore predefinito se non impostato) o builtin/latest per scegliere il modello. Consulta l'argomento Note di rilascio per un elenco dei modelli aggiornati di recente.

Invia la richiesta

Utilizzi curl e i contenuti del corpo di request.json per inviare la richiesta all'API Vision. Inserisci quanto segue nella riga di comando:

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

• Il comando curl di esempio utilizza il comando gcloud auth print-access-token per ottenere un token di autenticazione.
• Tieni presente che per passare un nome file a curl devi utilizzare l'opzione -d (per "data") e precedere il nome file con un segno @. Questo file deve trovarsi nella stessa directory in cui esegui il comando curl.

Interpreta la risposta

Dovresti visualizzare una risposta JSON simile a quella riportata di seguito.

Il corpo JSON della richiesta ha specificato maxResults per ogni tipo di annotazione. Di conseguenza, nel JSON della risposta vedrai quanto segue:

• Tre risultati labelAnnotations
• un risultato textAnnotations (abbreviato per chiarezza)
• un risultato localizedObjectAnnotations

Risposta

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
              }
            ]
          }
        }
      ]
    }
  ]
}

Risultati del rilevamento etichette

1. descrizione: "Persone", punteggio: 0,950
2. descrizione: "Strada", punteggio: 0,891
3. descrizione: "Mezzo di trasporto", punteggio: 0,890

Credito immagine: Steve Long su Unsplash (annotazioni aggiunte).

Risultati del rilevamento testo

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

Credito immagine: Steve Long su Unsplash (annotazioni aggiunte).

Risultati del rilevamento oggetti

• nome: "Persona", punteggio: 0,944
• vertici normalizzati: (x: 0,260, y: 0,468), (x: 0,407, y: 0,468), (x: 0,407, y: 0,895), (x: 0,260, y: 0,895)

Credito immagine: Steve Long su Unsplash (annotazioni aggiunte).

Complimenti! Hai inviato la tua prima richiesta all'API Vision.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate su questa pagina, elimina il progetto Google Cloud con le risorse.

Optional: Revoke credentials from the gcloud CLI.

gcloud auth revoke

Passaggi successivi

• Visualizza un elenco di tutti i tipi di elementi e dei relativi utilizzi.
• Inizia a utilizzare l'API Vision nella lingua che preferisci utilizzando una libreria client dell'API Vision.
• Consulta le guide pratiche per scoprire di più su funzionalità specifiche, visualizzare esempi di annotazioni e ottenere annotazioni per un singolo file o un'immagine.
• Scopri di più sull'annotazione collettiva di immagini e file (PDF/TIFF/GIF).
• Sfoglia un elenco completo di esempi di codice della libreria client.