Objetivos
En esta muestra, se usará la API de Vision de Google para detectar rostros en una imagen. A fin de comprobar que los rostros se detectaron de forma correcta, luego usarás esos datos para dibujar un recuadro alrededor de cada rostro.
Costos
En este documento, usarás los siguientes componentes facturables de Google Cloud:
- Cloud Vision
Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios.
Antes de comenzar
- Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Enable the Google Cloud Vision API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Enable the Google Cloud Vision API.
- Configura el entorno para usar las credenciales predeterminadas de la aplicación.
- Configura tareas y herramientas específicas del lenguaje:
C#
- Instala la biblioteca cliente de Google.
- Instala Visual Studio 2012/2015.
Java
- Instala Java.
- Referencia de API.
Descarga e instala el sistema de compilación de Apache Maven. Maven se asegurará de que la biblioteca cliente de la API de Google y las bibliotecas cliente de la API de Vision se instalen cuando se compile el proyecto, ya que las incluimos en
pom.xml
....
Node.js
- Instala la biblioteca cliente de Google.
- Instala node.js.
- Referencia de API.
Instala npm y node-canvas. En el código de muestra, se incluye un
package.json
para instalar todas las dependencias mediante el comandonpm install
. Ten en cuenta que node-canvas tiene dependencias adicionales que tal vez debas instalar. Consulta el documento de instalación de node-canvas para obtener más información.
PHP
- Instala la biblioteca cliente de Google.
- Instala PHP y Composer.
- Referencia de API.
- Instala y habilita GD para PHP.
Python
- Instala la biblioteca cliente de Google.
- Instala Python.
- Referencia de API.
- Instala Pillow.
Ruby
- Instala la biblioteca cliente de Google.
- Instala Ruby y Bundler.
- Referencia de API.
- Instala ImageMagick.
Crea el objeto de servicio
Para acceder a las API de Google con los SDK cliente oficiales, crea un objeto de servicio basado en el documento de descubrimiento de las API, que describe la API al SDK. Tendrás que recuperarlo desde el servicio de descubrimiento de la API de Vision con tus credenciales:
Java
Node.js
Python
Envía una solicitud de detección de rostro
A fin de construir una solicitud para la API de Vision, primero debes consultar la documentación de la API. En este caso, le pedirás al recurso images
que haga una operación annotate
en tu imagen. Una solicitud a esta API adopta la forma de un objeto con una lista de requests
. Todos los elementos de esta lista incluyen dos tipos de información:
- Los datos de la imagen codificados en base64
- Una lista de características para las que querrías tener anotaciones respecto de la imagen
Para este ejemplo, tan solo solicitarás la anotación de FACE_DETECTION
en una imagen, y se mostrarán las partes pertinentes de la respuesta:
Java
Node.js
Python
Procesa la respuesta
¡Felicitaciones! Detectaste los rostros en tu imagen. La respuesta a nuestra solicitud de anotación de rostros contiene un conjunto de metadatos sobre los rostros detectados, que incluyen coordenadas de un polígono que abarca el rostro. Sin embargo, en este punto, solo es una lista de números. Los usaremos para confirmar que efectivamente encontraste los rostros en tu imagen. Dibujaremos polígonos en una copia de la imagen mediante las coordenadas que muestra la API de Vision:
Combina todas las opciones
Java
...
Para compilar y ejecutar la muestra, ejecuta los siguientes comandos desde el directorio del código de muestra:
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
Para ejecutar la muestra, ejecuta el siguiente comando desde el directorio del código de muestra:
node faceDetection resources/face.png
Python
Limpia
Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos usados en este instructivo, borra el proyecto que contiene los recursos o conserva el proyecto y borra los recursos individuales.
- En la consola de Google Cloud, ve a la página Administrar recursos.
- En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
- En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.