Détecter des thèmes dans une image à l'aide de l'API Cloud Vision

Ce guide de démarrage rapide vous guide tout au long des processus suivants :

  • Créer un bucket Cloud Storage
  • Importer votre image sur Cloud Storage et la rendre publique
  • Envoyer une requête à l'API Vision avec cette image

Ces étapes devraient durer environ 5 minutes. Vous pouvez stocker gratuitement jusqu'à 5 Go de données dans Cloud Storage et envoyer gratuitement jusqu'à 1 000 requêtes de fonctionnalités par mois à l'API Cloud Vision.

Avant de commencer

Si vous ne l'avez pas déjà fait, configurez votre projet et créez un bucket Google Cloud Storage, comme expliqué ci-dessous.

Configurer votre projet

  1. 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.

  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  3. Vérifiez que la facturation est activée pour votre projet Google Cloud.

  4. Activez l'API Cloud Vision

    Activer l'API

    5.

  5. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  6. Vérifiez que la facturation est activée pour votre projet Google Cloud.

  7. Activez l'API Cloud Vision

    Activer l'API

    8.

Créer un bucket Cloud Storage

  1. Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.

    Accéder à la page "Buckets"

  2. Cliquez sur Créer un bucket.
  3. Sur la page Créer un bucket, saisissez les informations concernant votre bucket. Pour passer à l'étape suivante, cliquez sur Continuer.
    • Pour nommer votre bucket, saisissez un nom unique. N'incluez aucune information sensible dans le nom des buckets, car leur espace de noms est global et visible par tous.
    • Pour Choisir l'emplacement de stockage des données, procédez comme suit :
      • Sélectionnez une option de type d'emplacement.
      • Sélectionnez une option Location (Emplacement).
    • Pour Choisir une classe de stockage par défaut pour vos données, sélectionnez l'option suivante : Standard
    • Pour le champ Choisir comment contrôler l'accès aux objets, sélectionnez une option de Contrôle des accès.
    • Sous Paramètres avancés (facultatif), choisissez une méthode de chiffrement, une règle de conservation ou des libellés de bucket.
  4. Cliquez sur Create (Créer).

Envoyer une requête au service de l'API Cloud Vision

  1. Téléchargez demo-img.jpg. (Vous devrez peut-être cliquer avec le bouton droit de la souris sur le lien.)

  2. Ouvrez la page Buckets Cloud Storage.

  3. Sélectionnez le bucket que vous avez créé dans la section précédente.

  4. Cliquez sur Importer des fichiers et sélectionnez le fichier demo-img.jpg à importer dans le bucket Cloud Storage à partir de votre machine locale.

    Bouton "Importer des fichiers"
    Voici le fichier image que vous venez d'importer :
    Deux femmes faisant du vélo à Jakarta
    Crédit image : Rohiim Ariful sur Unsplash.

  5. Une fois le fichier importé et répertorié dans le bucket Cloud Storage, rendez l'image publique.

  6. Dans la section Essayer cette méthode, renseignez le modèle interactif d'explorateur API en remplaçant cloud-samples-data/vision dans le champ image.source.imageUri par le nom du bucket Cloud Storage dans lequel vous avez importé le fichier demo-img.jpg. Le corps de la requête doit se présenter comme suit : 

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

  7. Cliquez sur Exécuter pour envoyer la requête au service. La réponse JSON s'affiche au-dessus.

Félicitations ! Vous avez envoyé votre première requête images.annotate au service de l'API Cloud Vision.

Effectuer un nettoyage

Pour éviter que des frais liés à Google Cloud Platform ne vous soient inutilement facturés, utilisez Google Cloud Console pour supprimer votre bucket Cloud Storage (et votre projet) si vous n'en avez pas besoin.

Étape suivante