Tutorial sul rilevamento facciale

Obiettivi

In questo esempio, utilizzerai l'API Google Vision per rilevare i volti in un'immagine. Per dimostrare che i volti sono stati rilevati correttamente, utilizzerai questi dati per disegnare un riquadro intorno a ogni volto.

Costi

In questo documento vengono utilizzati i seguenti componenti fatturabili di Google Cloud:

• Cloud Vision

Per generare una stima dei costi in base all'utilizzo previsto, utilizza il calcolatore prezzi.

Prima di iniziare

Accedi al tuo account Google Cloud . 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.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Google Cloud Vision API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

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

Verify that billing is enabled for your Google Cloud project.

Enable the Google Cloud Vision API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

1. Configura l'ambiente per l'utilizzo delle credenziali predefinite dell'applicazione.
2. Configura attività e strumenti specifici per la lingua:

   C#

   • Installa la libreria client Google
   • Installa Visual Studio 2012/2015.

   Java

   • Installa Java.
   • Riferimento API.

   • Scarica e installa il sistema di compilazione Apache Maven. Maven si assicurerà che la libreria client delle API di Google e le librerie client dell'API Vision vengano installate durante la creazione del progetto, perché le abbiamo incluse in pom.xml.

     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-vision</artifactId>
       <version>v1-rev20231219-2.0.0</version>
     </dependency>
     <dependency>
       <groupId>com.google.auth</groupId>
       <artifactId>google-auth-library-oauth2-http</artifactId>
     </dependency>
     <dependency>
       <groupId>com.google.guava</groupId>
       <artifactId>guava</artifactId>
     </dependency>
     <dependency>
       <groupId>com.google.http-client</groupId>
       <artifactId>google-http-client-jackson2</artifactId>
     </dependency>

     ...

   Node.js

   • Installa la libreria client Google
   • Installa node.js.
   • Riferimento API.

   • Installa npm e node-canvas. Il codice campione include un package.json per installare tutte le dipendenze utilizzando il comando: npm install. Tieni presente che node-canvas ha dipendenze aggiuntive che potresti dover installare. Per saperne di più, consulta la documentazione sull'installazione di node-canvas.

     {
       "name": "nodejs-docs-samples-vision",
       "private": true,
       "license": "Apache-2.0",
       "author": "Google LLC",
       "engines": {
         "node": ">=20.0.0"
       },
       "files": [
         "*.js"
       ],
       "scripts": {
         "test": "c8 mocha -p -j 2 system-test --timeout 600000"
       },
       "dependencies": {
         "@google-cloud/vision": "^4.0.0",
         "natural": "^8.0.0",
         "pureimage": "^0.3.17",
         "redis": "^4.6.5",
         "yargs": "^17.7.1"
       },
       "devDependencies": {
         "@google-cloud/storage": "^7.0.0",
         "@types/uuid": "^10.0.0",
         "@types/yargs": "^17.0.22",
         "c8": "^10.0.0",
         "chai": "^4.5.0",
         "mocha": "^10.2.0",
         "uuid": "^11.1.1"
       }
     }
     

   PHP

   • Installa la libreria client Google
   • Installa PHP e Composer.
   • Riferimento API.
   • Installa e attiva GD per PHP.

   Python

   • Installa la libreria client Google
   • Installa Python.
   • Riferimento API.
   • Installa pillow.

   Ruby

   • Installa la libreria client Google
   • Installa Ruby e Bundler.
   • Riferimento API.
   • Installa ImageMagick.