Detecta etiquetas en una imagen mediante la API de Cloud Vision

Esta guía de inicio rápido te muestra cómo hacer lo siguiente:

  • Crear un bucket de Cloud Storage
  • Sube tu imagen a Cloud Storage y habilita el acceso público al archivo.
  • Realizar una solicitud a la API de Vision con dicha imagen

Completar estos pasos lleva unos 5 minutos. Puedes almacenar hasta 5 GB de datos en Cloud Storage sin cargo y realizar hasta 1000 solicitudes de función por mes a Vision API sin cargo.

Antes de comenzar

Si aún no lo hiciste, sigue las siguientes instrucciones para configurar tu proyecto y crear un bucket de Cloud Storage.

Configura tu proyecto

  1. Accede a tu Google Cloud cuenta de. 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.

  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.

Roles obligatorios

  1. Asegúrate de tener el siguiente rol o roles en el proyecto: Administrador de Storage (roles/storage.admin)

    Verifica los roles

    1. En la Google Cloud consola de, dirígete a la página IAM.

      Ir a IAM
    2. Selecciona el proyecto.

    3. En la columna Principal, busca todas las filas que te identifiquen a ti o a un grupo en el que se te incluya. Para saber en qué grupos estás incluido, comunícate con tu administrador.

    4. Para todas las filas en las que se te especifique o se te incluya, verifica la columna Rol para ver si la lista de roles incluye los roles necesarios.

    Otorga los roles

    1. En la Google Cloud consola de, dirígete a la página IAM.

      Ir a IAM
    2. Selecciona el proyecto.
    3. Haz clic en Grant access.

    4. En el campo Principales nuevas, ingresa tu identificador de usuario. Esta suele ser la dirección de correo electrónico de una Cuenta de Google.

    5. Haz clic en Selecciona un rol y, luego, busca el rol.
    6. Para otorgar roles adicionales, haz clic en Agregar otro rol y agrega uno más.
    7. Haz clic en Guardar.

Cree un bucket de Cloud Storage

  1. En la Google Cloud consola, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. Haz clic en Crear.
  3. En la página Crear un bucket, ingresa la información de tu bucket. Para ir al paso siguiente, haz clic en Continuar.
    1. En Nombre del bucket, ingresa un nombre de bucket único. No incluyas información sensible en el nombre del bucket porque su espacio de nombres es global y públicamente visible.
    2. En la sección Elige dónde almacenar tus datos, haz lo siguiente:
      1. Selecciona un tipo de ubicación.
      2. Elige una ubicación en la que se almacenen de forma permanente los datos de tu bucket en el menú desplegable Tipo de ubicación.
        • Si seleccionas el tipo de ubicación birregional, también puedes habilitar la replicación turbo con la casilla de verificación correspondiente.
      3. Para configurar la replicación bucket buckets, selecciona Agregar replicación entre bucket a través del Servicio de transferencia de almacenamiento y sigue estos pasos:

        Configura la replicación entre bucket

        1. En el menú Bucket, selecciona un bucket.

        2. En la sección Configuración de replicación, haz clic en Configurar para configurar la configuración del trabajo de replicación.

          Aparecerá el panel Configurar replicación entre buckets.

          • Para filtrar los objetos que se replicarán por prefijo de nombre de objeto, ingresa un prefijo del que quieras incluir o excluir objetos y, luego, haz clic en Agregar un prefijo.
          • Para establecer una clase de almacenamiento para los objetos replicados, selecciona una clase de almacenamiento del menú Clase de almacenamiento. Si omites este paso, los objetos replicados usarán la clase de almacenamiento del bucket de destino de forma predeterminada.
          • Haz clic en Listo.
    3. En la sección Elige cómo almacenar tus datos, haz lo siguiente:
      1. En la sección Establecer una clase predeterminada, selecciona lo siguiente: Estándar.
      2. Para habilitar el espacio de nombres jerárquico, en la sección Optimizar el almacenamiento para cargas de trabajo con uso intensivo de datos, selecciona Habilitar el espacio de nombres jerárquico en este bucket.
    4. En la sección Elige cómo controlar el acceso a los objetos, selecciona si tu bucket aplica o no la prevención del acceso público, y elige un método de control de acceso para los objetos del bucket.
    5. En la sección Elige cómo proteger los datos de objetos, haz lo siguiente:
      • Selecciona cualquiera de las opciones de Protección de datos que desees configurar para tu bucket.
        • Para habilitar la eliminación no definitiva, haz clic en la casilla de verificación Política de eliminación no definitiva (para la recuperación de datos) y especifica la cantidad de días que deseas conservar los objetos después de la eliminación.
        • Para configurar el Control de versiones de objetos, haz clic en la casilla de verificación Control de versiones de objetos (para el control de versión) y especifica la cantidad máxima de versiones por objeto y la cantidad de días después de los cuales vencen las versiones no actuales.
        • Para habilitar la política de retención en objetos y buckets, haz clic en la casilla de verificación Retención (para cumplimiento) y, luego, haz lo siguiente:
          • Para habilitar el bloqueo de retención de objetos, haz clic en la casilla de verificación Habilitar la retención de objetos.
          • Para habilitar el bloqueo de bucket, haz clic en la casilla de verificación Establecer política de retención de bucket y elige una unidad de tiempo y una duración para tu período de retención.
      • Para elegir cómo se encriptarán los datos de tus objetos, expande la sección Encriptación de datos () y selecciona un método de Encriptación de datos.
  4. Haz clic en Crear.

Realiza una solicitud a Cloud Vision

  1. Guarda una versión local del siguiente archivo de imagen de muestra (demo-img.jpg).

    Dos mujeres andando en bicicleta en Yakarta.
    Crédito de la imagen: Rohiim Ariful en Unsplash.

  2. En la Google Cloud consola, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  3. Selecciona el bucket que creaste en la sección anterior.

  4. Haz clic en Subir archivos y selecciona la versión local del archivo demo-img.jpg para subirlo a tu bucket de Cloud Storage.

  5. Una vez que se haya subido el archivo y aparezca en el bucket de Cloud Storage, comparte la imagen públicamente.

  6. En la sección Prueba este método, completa la plantilla interactiva del Explorador de APIs mediante el reemplazo de cloud-samples-data/vision en el campo image.source.imageUri con el nombre del bucket de Cloud Storage en el que subiste el archivo demo-img.jpg. El cuerpo de la solicitud se debe ver de la siguiente manera: 

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

  7. Haz clic en Ejecutar para enviar la solicitud al servicio. La respuesta JSON aparece después del cuerpo de la solicitud.

¡Felicitaciones! Realizaste tu primera solicitud images.annotate a Cloud Vision.

Limpia

Para evitar cargos Google Cloud innecesarios, usa la Google Cloud consola para borrar tu bucket de Cloud Storage (y tu proyecto) si no los necesitas.

¿Qué sigue?

  • Ve una lista de todos los tipos de funciones y sus usos.
  • Comienza a usar la API de Vision en el idioma que prefieras mediante una biblioteca cliente de esta API.
  • Usa las guías prácticas para obtener más información sobre funciones específicas, ver ejemplos de anotaciones y obtener anotaciones para un archivo o una imagen individuales.
  • Obtén más información sobre la anotación por lotes para imágenes y archivos (PDF, TIFF y GIF).
  • Explora una lista completa de las muestras de código de la biblioteca cliente.