Guía de inicio rápido: Detecta etiquetas en una imagen mediante la API de Cloud Vision

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 Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.

  4. Habilita la API de Cloud Vision.

    Habilita la API

    5.

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

    Ir al selector de proyectos

  6. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.

  7. Habilita la API de Cloud Vision.

    Habilita la API

    8.

Crea un bucket de Cloud Storage

  1. En Cloud Console, ve a la página Navegador de Cloud Storage.

    Ir al navegador

  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 el navegador de Storage de la consola de Google Cloud.

  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. Después de subir y enumerar el archivo en el navegador de Cloud Storage, comparte la imagen de manera pública.

  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?