Tutoriel sur les possibilités de découpage

Audience

L'objectif de ce tutoriel est de vous aider à développer des applications à l'aide de la fonctionnalité Crop Hints (suggestions de cadrage) de l'API Cloud Vision. Nous partons du principe que vous maîtrisez les constructions et les techniques de programmation de base. Cependant, même si vous êtes un programmeur débutant, vous devriez être capable de suivre et d'exécuter ce tutoriel sans difficulté, puis d'utiliser la Documentation de référence de l'API Vision pour créer des applications de base.

Ce tutoriel décrit une application de l'API Vision montrant comment faire appel à cette API pour utiliser la fonctionnalité de suggestions de recadrage.

Prérequis

• Configurez un projet d'API Vision dans la console Google Cloud .

• Configurez votre environnement pour utiliser le service Identifiants par défaut de l'application.

Présentation

Ce tutoriel vous présente une application de base de l'API Cloud Vision, qui utilise une requête Crop Hints. Vous pouvez fournir l'image à traiter via un URI Cloud Storage (emplacement du bucket Cloud Storage) ou intégrer celle-ci à la requête. Si la requête réussit, la réponse Crop Hints comporte les coordonnées d'un cadre de délimitation autour de l'objet ou du visage dominant dans l'image.

Intégralité du code

Lors de la lecture du code, nous vous recommandons de vous reporter également la documentation de référence de l'API Cloud Vision pour Python.

import argparse

from typing import MutableSequence

from google.cloud import vision
from PIL import Image, ImageDraw



def get_crop_hint(path: str) -> MutableSequence[vision.Vertex]:
    """Detect crop hints on a single image and return the first result.

    Args:
        path: path to the image file.

    Returns:
        The vertices for the bounding polygon.
    """
    client = vision.ImageAnnotatorClient()

    with open(path, "rb") as image_file:
        content = image_file.read()

    image = vision.Image(content=content