Objectifs
Dans cet exemple, vous utiliserez l'API Google Vision pour détecter les visages dans une image. Pour confirmer que les visages ont été correctement détectés, vous utiliserez ensuite ces données pour tracer un cadre autour de chaque visage.
Coûts
Dans ce document, vous utilisez les composants facturables suivants de Google Cloud :
- Cloud Vision
Obtenez une estimation des coûts en fonction de votre utilisation prévue à l'aide du simulateur de coût.
Avant de commencer
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.
-
Vérifiez que la facturation est activée pour votre projet Google Cloud.
-
Activez l'API Google Cloud Vision
-
Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.
-
Vérifiez que la facturation est activée pour votre projet Google Cloud.
-
Activez l'API Google Cloud Vision
- Configurez votre environnement pour utiliser les identifiants par défaut de l'application.
- Configurez les tâches et les outils spécifiques au langage de programmation utilisé :
C#
- Installez la bibliothèque cliente Google.
- Installez Visual Studio 2012/2015.
Java
- Installez Java.
- Document de référence sur les API
Téléchargez et installez le système de compilation Apache Maven. Maven veillera à ce que les bibliothèques clientes des API Google et les bibliothèques clientes de l'API Vision soient installées lors de la création du projet, car nous les avons incluses dans la valeur
pom.xml
....
Node.js
- Installez la bibliothèque cliente Google.
- Installez Node.js.
- Document de référence sur les API
Installez npm et node-canvas. L'exemple de code comprend une valeur
package.json
pour installer toutes les dépendances à l'aide de la commande :npm install
. Notez que node-canvas comporte des dépendances supplémentaires que vous devrez peut-être installer. Pour en savoir plus, consultez le document d'installation de node-canvas.
PHP
- Installez la bibliothèque cliente Google.
- Installez PHP et Composer.
- Document de référence sur les API
- Installez et activez l'extension GD pour PHP.
Python
- Installez la bibliothèque cliente Google.
- Installez Python.
- Document de référence sur les API
- Installez pillow.
Ruby
- Installez la bibliothèque cliente Google.
- Installez Ruby et Bundler.
- Document de référence sur les API
- Installez ImageMagick.
Créer l'objet de service
Pour accéder aux API Google à l'aide des SDK clients officiels, vous créez un objet de service basé sur le document de découverte de l'API, qui décrit l'API au SDK. Vous devez le récupérer à partir du service de découverte de l'API Vision en utilisant vos identifiants :
Java
Node.js
Python
Envoyer une requête de détection de visage
Pour créer une requête adressée à l'API Vision, consultez d'abord la documentation de l'API. Dans ce cas, vous demanderez la ressource images
à votre image annotate
. Une requête envoyée à cette API se présente sous la forme d'un objet avec une liste requests
. Chaque élément de cette liste contient deux types d’informations :
- les données d'image encodées en base64 ;
- une liste des fonctionnalités que vous souhaitez annoter à propos de cette image.
Pour cet exemple, vous demanderez simplement l'annotation FACE_DETECTION
sur une image et renverrez la partie correspondante de la réponse :
Java
Node.js
Python
Traiter la réponse
Félicitations, vous avez détecté les visages dans votre image ! La réponse à notre requête d'annotation de visage comprend un ensemble de métadonnées relatives aux visages détectés, ces métadonnées incluant les coordonnées d'un polygone englobant le visage. À ce stade, il ne s’agit que d’une série de chiffres. Nous allons les utiliser pour confirmer que vous avez bien trouvé les visages dans votre image. Nous allons dessiner des polygones sur une copie de l'image, en utilisant les coordonnées renvoyées par l'API Vision :
Faire la synthèse
Java
...
Pour compiler et exécuter l'exemple, exécutez les commandes suivantes à partir du répertoire de l'exemple de code :
mvn clean compile assembly:single java -cp target/vision-face-detection-1.0-SNAPSHOT-jar-with-dependencies.jar \ com.google.cloud.vision.samples.facedetect.FaceDetectApp \ data/face.jpg \ output.jpg
Node.js
Pour exécuter l'exemple, lancez la commande suivante à partir du répertoire de l'exemple de code :
node faceDetection resources/face.png
Python
Effectuer un nettoyage
Pour éviter que les ressources utilisées lors de ce tutoriel soient facturées sur votre compte Google Cloud, supprimez le projet contenant les ressources, ou conservez le projet et les ressources individuelles.
- Dans la console Google Cloud, accédez à la page Gérer les ressources.
- Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
- Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.