Rilevare le etichette in un'immagine utilizzando l'API Cloud Vision

Questa guida rapida mostra come:

  • Creare un bucket Cloud Storage.
  • Caricare l'immagine su Cloud Storage e rendere il file accessibile pubblicamente.
  • Effettuare una richiesta all'API Vision con questa immagine.

Il completamento di questi passaggi dovrebbe richiedere circa cinque minuti. Puoi archiviare fino a 5 GB di dati in Cloud Storage senza costi ed effettuare fino a 1000 richieste di funzionalità al mese all'API Vision senza costi.

Prima di iniziare

Se non l'hai ancora fatto, segui queste istruzioni per configurare il progetto e creare un bucket Cloud Storage.

Configura il progetto

  1. Accedi al tuo Google Cloud account. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Vision API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Vision API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

Ruoli obbligatori

  1. Assicurati di avere il seguente ruolo o i seguenti ruoli nel progetto: Storage Admin (roles/storage.admin)

    Controlla i ruoli

    1. Nella Google Cloud console vai alla pagina IAM.

      Vai a IAM
    2. Seleziona il progetto.

    3. Nella colonna Entità, trova tutte le righe che identificano te o un gruppo di cui fai parte. Per scoprire i gruppi di cui fai parte, contatta l' amministratore.

    4. Per tutte le righe che ti specificano o ti includono, controlla la colonna Ruolo per verificare se l'elenco dei ruoli include i ruoli richiesti.

    Concedi i ruoli

    1. Nella Google Cloud console vai alla pagina IAM.

      Vai a IAM
    2. Seleziona il progetto.
    3. Fai clic su Concedi l'accesso.

    4. Nel campo Nuove entità, inserisci il tuo identificatore dell'utente. In genere si tratta dell'indirizzo email di un Account Google.

    5. Fai clic su Seleziona un ruolo, quindi cerca il ruolo.
    6. Per concedere altri ruoli, fai clic su Aggiungi un altro ruolo e aggiungi ogni ruolo aggiuntivo.
    7. Fai clic su Salva.

Crea un bucket Cloud Storage

  1. Nella Google Cloud console, vai alla pagina Bucket in Cloud Storage.

    Vai a Bucket

  2. Fai clic su Crea.
  3. Nella pagina Crea un bucket, inserisci le informazioni del bucket. Per passare al passaggio successivo, fai clic su Continua.
    1. In Assegna un nome al bucket, inserisci un nome univoco per il bucket. Non includere informazioni sensibili nel nome del bucket, poiché lo spazio dei nomi dei bucket è globale e visibile pubblicamente.
    2. Nella sezione Scegli dove archiviare i tuoi dati, procedi nel seguente modo:
      1. Seleziona un tipo di località.
      2. Scegli una località in cui i dati del bucket vengono archiviati in modo permanente dal menu a discesa Tipo di località.
        • Se selezioni il tipo di località a due regioni, puoi anche scegliere di abilitare la replica turbo utilizzando la casella di controllo pertinente.
      3. Per configurare la replica tra bucket, seleziona Aggiungi una replica tra bucket mediante Storage Transfer Service e segui questi passaggi:

        Configura la replica tra bucket

        1. Nel menu Bucket, seleziona un bucket.

        2. Nella sezione Impostazioni di replica , fai clic su Configura per configurare le impostazioni del job di replica.

          Viene visualizzato il riquadro Configura replica tra bucket.

          • Per filtrare gli oggetti da replicare in base al prefisso del nome dell'oggetto, inserisci un prefisso da includere o escludere dagli oggetti, quindi fai clic su Aggiungi un prefisso.
          • Per impostare una classe di archiviazione per gli oggetti replicati, seleziona una classe di archiviazione dal menu Classe di archiviazione. Se salti questo passaggio, gli oggetti replicati utilizzeranno per impostazione predefinita la classe di archiviazione del bucket di destinazione.
          • Fai clic su Fine.
    3. Nella sezione Scegli come archiviare i tuoi dati, procedi nel seguente modo:
      1. Nella sezione Imposta una classe predefinita, seleziona Standard.
      2. Per abilitare lo spazio dei nomi gerarchico, nella sezione Ottimizza l'archiviazione per i workload con uso intensivo dei dati, seleziona Abilita uno spazio dei nomi gerarchico in questo bucket.
    4. Nella sezione Scegli come controllare l'accesso agli oggetti, seleziona se il bucket applica o meno la prevenzione dell'accesso pubblico, e seleziona un metodo di controllo dell'accesso per gli oggetti del bucket.
    5. Nella sezione Scegli come proteggere i dati degli oggetti, procedi nel seguente modo:
      • Seleziona una delle opzioni in Protezione dei dati che vuoi impostare per il bucket.
        • Per abilitare l'eliminazione temporanea, fai clic sulla casella di controllo Policy di eliminazione temporanea (per il recupero dati) e specifica il numero di giorni per cui vuoi conservare gli oggetti dopo l'eliminazione.
        • Per impostare il controllo delle versioni degli oggetti, fai clic sulla casella di controllo Controllo delle versioni degli oggetti (per il controllo delle versioni) e specifica il numero massimo di versioni per oggetto e il numero di giorni dopo i quali le versioni non correnti scadono.
        • Per abilitare il criterio di conservazione su oggetti e bucket, fai clic sulla casella di controllo Conservazione (per la conformità) e poi procedi nel seguente modo:
          • Per abilitare il blocco della conservazione degli oggetti, fai clic sulla casella di controllo Abilita la conservazione degli oggetti.
          • Per abilitare il blocco del bucket, fai clic sulla casella di controllo Imposta la policy di conservazione del bucket e scegli un'unità di tempo e una durata per il periodo di conservazione.
      • Per scegliere come criptare i dati degli oggetti, espandi la la sezione Criptaggio dei dati () e seleziona un metodo di criptaggio dei dati.
  4. Fai clic su Crea.

Effettua una richiesta a Cloud Vision

  1. Salva una versione locale del seguente file immagine di esempio (demo-img.jpg).

    Due donne in bicicletta a Giacarta.
    Crediti immagine: Rohiim Ariful su Unsplash.

  2. Nella Google Cloud console, vai alla pagina Bucket in Cloud Storage.

    Vai a Bucket

  3. Seleziona il bucket che hai creato nella sezione precedente.

  4. Fai clic su Carica file e seleziona la versione locale del file demo-img.jpg da caricare nel bucket Cloud Storage.

  5. Dopo aver caricato il file e visualizzato nel bucket Cloud Storage, condividi l'immagine pubblicamente.

  6. Nella sezione Prova questo metodo, completa il modello interattivo di Explorer API sostituendo cloud-samples-data/vision nel campo image.source.imageUri con il nome del bucket Cloud Storage in cui hai caricato il file demo-img.jpg. Il corpo della richiesta dovrebbe avere il seguente aspetto: 

    {
  "requests": [
    {
      "features": [
        {
          "type": "LABEL_DETECTION"
        }
      ],
      "image": {
        "source": {
          "imageUri": "gs://cloud-samples-data/vision/demo-img.jpg"
        }
      }
    }
  ]
}

  7. Fai clic su Esegui per inviare la richiesta al servizio. La risposta JSON viene visualizzata dopo il corpo della richiesta.

Complimenti! Hai effettuato la tua prima richiesta images.annotate a Cloud Vision.

Libera spazio

Per evitare addebiti non necessari Google Cloud di, utilizza la Google Cloud console per eliminare il bucket Cloud Storage (e il progetto) se non ti servono.

Passaggi successivi

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