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 l'integrazione semplice del riconoscimento visivo di Google tecnologie in applicazioni per 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_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_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 Prima di iniziare, puoi usa 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 file 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 caratteristica specifico. Puoi richiedere più tipi di caratteristiche per una singola immagine.
• type - Il valore enum che specifica una funzionalità.
• (Facoltativo) maxResults: un valore limite per i risultati restituito.
• (Facoltativo) model - Se applicabile, puoi specificare builtin/stable (valore predefinito se non viene configurato) oppure builtin/latest per scegliere un modello di machine learning. Fai riferimento all'Release note 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 sul tuo 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 che utilizzi l'opzione -d (per "dati") e precede il nome del file con una @. Questo file deve trovarsi nella stessa directory in cui tu esegui il comando curl.

Interpreta la risposta

Dovresti vedere 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 localizedObjectAnnotations risultato

Risposta

Nota: valori di coordinate pari a zero omessi. Quando l'API rileva un valore di coordinata ("x" o "y") pari a 0, la coordinata viene omessa nella risposta JSON. Pertanto, una risposta con un poligono di delimitazione intorno all'intera immagine sarebbe
[{},{"x": 100},{"x": 100,"y": 100},{"y": 100}] per un'immagine di 100 pixel per 100 pixel. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API.

{
  "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

• Consulta l'elenco di tutti i tipi di funzionalità e dei relativi usi.
• Inizia a utilizzare l'API Vision nella lingua che preferisci utilizzando un Client API Vision Raccolta.
• Utilizza 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.