Detecta etiquetas en una imagen mediante la API de Cloud Vision

En esta guía de inicio rápido, se te guiará por los siguientes procesos:

  • Crear un bucket de Cloud Storage.
  • Subir tu imagen a Cloud Storage y hacerla pública.
  • Realizar una solicitud a la API de Vision con esa imagen.

Completar estos pasos lleva unos 5 minutos. Puedes almacenar hasta 5 GB de datos en Cloud Storage gratis y realizar hasta 1000 solicitudes de características a la API de Vision gratis por mes.

Antes de comenzar

Si todavía no lo hiciste, configura tu proyecto y crea un bucket de Google Cloud Storage, de la manera en que se explica a continuación.

Configura tu proyecto

  1. 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.
  2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. Habilita la API de Cloud Vision.

    Habilita la API

  5. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  6. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  7. Habilita la API de Cloud Vision.

    Habilita la API

Crea un bucket de Cloud Storage

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

    Ir a la página Buckets

  2. Haga clic en Crear bucket.
  3. En la página Crear un bucket, ingresa la información de tu bucket. Para ir al paso siguiente, haz clic en Continuar.
    • 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.
    • En Elige dónde almacenar tus datos, haz lo siguiente:
      • Selecciona una opción de Tipo de ubicación.
      • Selecciona una opción de Ubicación.
    • Para Elegir una clase de almacenamiento predeterminado para tus datos, selecciona lo siguiente:Estándar.
    • En Elige cómo controlar el acceso a los objetos, selecciona una opción de Control de acceso.
    • Para la Configuración avanzada (opcional), especifica un método de encriptación, una política de retención o etiquetas de bucket.
  4. Haga clic en Crear.

Realiza una solicitud al servicio de la API de Cloud Vision

  1. Descarga demo-img.jpg. (tal vez debas hacer clic con el botón derecho en el vínculo).

  2. Abre la página Buckets de Cloud Storage.

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

  4. Haz clic en Subir archivos y selecciona el archivo demo-img.jpg para subirlo desde tu máquina local al depósito de Cloud Storage.

    El botón Subir archivos
    Este es el archivo de imagen que acabas de subir:
    Dos mujeres andando en bicicleta en Yakarta.
    Crédito de la imagen: Rohiim Ariful en Unsplash.

  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 API 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 arriba.

Felicitaciones Realizaste tu primera solicitud images.annotate al servicio de la API de Cloud Vision.

Limpia

Si deseas evitar cargos innecesarios de Google Cloud Platform, usa la consola de Google Cloud 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.