クロップヒントを検出する

クロップヒントは、画像上のクロップ領域の頂点を示します。

注: Vision API では、すべての特徴に対してオフラインの非同期処理で画像のアノテーションを一括で生成できるようになりました。この非同期リクエストは 2,000 個までの画像ファイルをサポートし、Cloud Storage バケットに保存されるレスポンス ファイルを JSON 形式で返します。この機能の詳細については、オフラインのバッチ画像アノテーションページをご覧ください。

画像クレジット: Yasmin Dangor、Unsplash（元の画像と切り抜いた画像を表示）

クロップヒントを適用（比率 2:1）:

クロップヒント検出リクエスト

Google Cloud プロジェクトと認証を設定する

Google Cloud プロジェクトをまだ作成していない場合は、ここで作成します。このセクションを開いて手順を確認してください。

1. 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.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. Enable the 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

4. Install the Google Cloud CLI.

5. 連携 ID を使用するように gcloud CLI を構成します。

   詳細については、連携 ID を使用して gcloud CLI にログインするをご覧ください。

6. gcloud CLI を初期化するには、次のコマンドを実行します。

   gcloud init

   ローカル画像のクロップヒントを検出する

   Vision API を使用して、ローカル画像ファイルに特徴検出を実行できます。

   REST リクエストの場合は、リクエストの本文で画像ファイルのコンテンツを base64 エンコード文字列として送信します。

   gcloud とクライアント ライブラリ リクエストの場合は、リクエストにローカル イメージへのパスを指定します。

   REST

   リクエストのデータを使用する前に、次のように置き換えます。

   • BASE64_ENCODED_IMAGE: バイナリ画像データの base64 表現（ASCII 文字列）。これは次のような文字列になります。
     • /9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
     詳細については、base64 エンコードをご覧ください。
   • PROJECT_ID: 実際の Google Cloud プロジェクト ID。

   フィールド固有の考慮事項:

   • cropHintsParams.aspectRatios - 画像の幅と高さに指定された比率に対応する浮動小数点数です。最大 16 個までのクロップ比を指定できます。

   HTTP メソッドと URL:

   POST https://vision.googleapis.com/v1/images:annotate

   リクエストの本文（JSON）:

   {
     "requests": [
       {
         "image": {
           "content": "BASE64_ENCODED_IMAGE"
         },
         "features": [
           {
             "type": "CROP_HINTS"
           }
         ],
         "imageContext": {
           "cropHintsParams": {
             "aspectRatios": [
                2.0
             ]
           }
         }
       }
     ]
   }
   

   リクエストを送信するには、次のいずれかのオプションを選択します。

   curl

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "x-goog-user-project: PROJECT_ID" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://vision.googleapis.com/v1/images:annotate"

   PowerShell

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://vision.googleapis.com/v1/images:annotate" | Select-Object -Expand Content

   リクエストが成功すると、サーバーは 200 OK HTTP ステータス コードと JSON 形式のレスポンスを返します。

   レスポンス:

   Note: Zero coordinate values omitted. When the API detects a coordinate ("x" or "y") value of 0, that coordinate is omitted in the JSON response. Thus, a response with a bounding poly around the entire image would be
   [{},{"x": 100},{"x": 100,"y": 100},{"y": 100}] for an image that is 100 pixels by 100 pixels. For more information, see the API Reference documentation.

   ゼロ座標の省略（上記の注を参照）により、レスポンス内のクロップヒントの座標は次のようになります。

   • {"x": 0, "y": 520}, {"x": 2369, "y": 520},{"x": 2369,"y": 1729}, {"x": 0, "y": 1729}.

   {
     "responses": [
       {
         "cropHintsAnnotation": {
           "cropHints": [
             {
               "boundingPoly": {
                 "vertices": [
                   {
                     "y": 520
                   },
                   {
                     "x": 2369,
                     "y": 520
                   },
                   {
                     "x": 2369,
                     "y": 1729
                   },
                   {
                     "y": 1729
                   }
                 ]
               },
               "confidence": 0.79999995,
               "importanceFraction": 0.66999996
             }
           ]
         }
       }
     ]
   }
   

   Go

   このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Go の設定を完了してください。 詳細については、Vision Go API のリファレンス ドキュメントをご覧ください。

   Vision に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。

   
   // detectCropHints gets suggested croppings the Vision API for an image at the given file path.
   func detectCropHints(w io.Writer, file string) error {
   	ctx := context.Background()
   
   	client, err := vision.NewImageAnnotatorClient(ctx)
   	if err != nil {
   		return err
   	}
   
   	f, err := os.Open(file)
   	if err != nil {
   		return err
   	}
   	defer f.Close()
   
   	image, err := vision.NewImageFromReader(f)
   	if err != nil {
   		return err
   	}
   	res, err := client.CropHints(ctx, image, nil)
   	if err != nil {
   		return err
   	}
   
   	fmt.Fprintln(w, "Crop hints:")
   	for _, hint := range res.CropHints {
   		for _, v := range hint.BoundingPoly.Vertices {
   			fmt.Fprintf(w, "(%d,%d)\n", v.X, v.Y)
   		}
   	}
   
   	return nil
   }
   

   Java

   このサンプルを試す前に、Vision API クイックスタート: クライアント ライブラリの使用にある Java の設定を完了してください。詳細については、Vision API Java のリファレンス ドキュメントをご覧ください。

   注: Java Spring Framework を使用している場合、Spring Cloud Google Cloud で認証設定と Vision API を使用するクライアント オブジェクトを自動的に構成できます。

   
   import com.google.cloud.vision.v1.AnnotateImageRequest;
   import com.google.cloud.vision.v1.AnnotateImageResponse;
   import com.google.cloud.vision.v1.BatchAnnotateImagesResponse;
   import com.google.cloud.vision.v1.CropHint;
   import com.google.cloud.vision.v1.CropHintsAnnotation;
   import com.google.cloud.vision.v1.Feature;
   import com.google.cloud.vision.v1.Image;
   import com.google.cloud.vision.v1.ImageAnnotatorClient;
   import com.google.protobuf.ByteString;
   import java.io.FileInputStream;
   import java.io.IOException;
   import java.util.ArrayList;
   import java.util.List;
   
   public class DetectCropHints {
     public static void detectCropHints() throws IOException {
       // TODO(developer): Replace these variables before running the sample.
       String filePath = "path/to/your/image/file.jpg";
       detectCropHints(filePath);
     }
   
     // Suggests a region to crop to for a local file.
     public static void detectCropHints(String filePath) throws IOException {
       List<AnnotateImageRequest> requests = new ArrayList<>();
   
       ByteString imgBytes = ByteString.readFrom(new FileInputStream(filePath));
   
       Image img = Image.newBuilder().setContent(imgBytes).build();
       Feature feat = Feature.newBuilder().setType(Feature.Type.CROP_HINTS).build();
       AnnotateImageRequest request =
           AnnotateImageRequest.newBuilder().addFeatures(feat).setImage(img).build();
       requests.add(request);
   
       // Initialize client that will be used to send requests. This client only needs to be created
       // once, and can be reused for multiple requests. After completing all of your requests, call
       // the "close" method on the client to safely clean up any remaining background resources.
       try (ImageAnnotatorClient client = ImageAnnotatorClient.create()) {
         BatchAnnotateImagesResponse response = client.batchAnnotateImages(requests);
         List<AnnotateImageResponse> responses = response.getResponsesList();
   
         for (AnnotateImageResponse res : responses) {
           if (res.hasError()) {
             System.out.format("Error: %s%n", res.getError().getMessage());
             return;
           }
   
           // For full list of available annotations, see http://g.co/cloud/vision/docs
           CropHintsAnnotation annotation = res.getCropHintsAnnotation();
           for (CropHint hint : annotation.getCropHintsList()) {
             System.out.println(hint.getBoundingPoly());
           }
         }
       }
     }
   }

   Node.js

   このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Node.js の設定を完了してください。詳細については、Vision Node.js API のリファレンス ドキュメントをご覧ください。

   Vision に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。

   
   // Imports the Google Cloud client library
   const vision = require('@google-cloud/vision');
   
   // Creates a client
   const client = new vision.ImageAnnotatorClient();
   
   /**
    * TODO(developer): Uncomment the following line before running the sample.
    */
   // const fileName = 'Local image file, e.g. /path/to/image.png';
   
   // Find crop hints for the local file
   const [result] = await client.cropHints(fileName);
   const cropHints = result.cropHintsAnnotation;
   cropHints.cropHints.forEach((hintBounds, hintIdx) => {
     console.log(`Crop Hint ${hintIdx}:`);
     hintBounds.boundingPoly.vertices.forEach((bound, boundIdx) => {
       console.log(`  Bound ${boundIdx}: (${bound.x}, ${bound.y})`);
     });
   });

   Python

   このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Python の設定を完了してください。詳細については、Vision Python API のリファレンス ドキュメントをご覧ください。

   Vision に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。

   def detect_crop_hints(path):
       """Detects crop hints in an image."""
       from google.cloud import vision
   
       client = vision.ImageAnnotatorClient()
   
       with open(path, "rb") as image_file:
           content = image_file.read()
       image = vision.Image(content=content)
   
       crop_hints_params = vision.CropHintsParams(aspect_ratios=[1.77])
       image_context = vision.ImageContext(crop_hints_params=crop_hints_params)
   
       response = client.crop_hints(image=image, image_context=image_context)
       hints = response.crop_hints_annotation.crop_hints
   
       for n, hint in enumerate(hints):
           print(f"\nCrop Hint: {n}")
   
           vertices = [
               f"({vertex.x},{vertex.y})" for vertex in hint.bounding_poly.vertices
           ]
   
           print("bounds: {}".format(",".join(vertices)))
   
       if response.error.message:
           raise Exception(
               "{}\nFor more info on error messages, check: "
               "https://cloud.google.com/apis/design/errors".format(response.error.message)
           )
   
   

   その他の言語

   C#: クライアント ライブラリ ページの C# の設定手順を行ってから、.NET 用の Vision リファレンス ドキュメントをご覧ください。

   PHP: クライアント ライブラリ ページの PHP の設定手順を行ってから、PHP 用の Vision リファレンス ドキュメントをご覧ください。

   Ruby: クライアント ライブラリ ページの Ruby の設定手順を行ってから、Ruby 用の Vision リファレンス ドキュメントをご覧ください。

   リモート画像のクロップヒントを検出する

   Vision API を使用すると、Cloud Storage またはウェブ上にあるリモート画像ファイルに特徴検出を実行できます。リモート ファイル リクエストを送信するには、リクエストの本文でファイルのウェブ URL または Cloud Storage URI を指定します。

   注意: HTTP / HTTPS URL から画像を取得する場合、リクエストが完了するとは限りません。リクエストの調整や DoS 防止などのため、指定したホストがリクエストを拒否することがあります。また、不正利用を防止するため、Google がサイトに対するリクエストを調整することもあります。このような状況ではリクエストが失敗します。ベスト プラクティスとして、本番環境のアプリケーションでは、外部ホストの画像を頼りにしないでください。

   REST

   リクエストのデータを使用する前に、次のように置き換えます。

   • CLOUD_STORAGE_IMAGE_URI: Cloud Storage バケット内の有効な画像ファイルへのパス。少なくとも、ファイルに対する読み取り権限が必要です。例:
     • gs://cloud-samples-data/vision/crop_hints/bubble.jpeg

   • PROJECT_ID: 実際の Google Cloud プロジェクト ID。

   フィールド固有の考慮事項:

   • cropHintsParams.aspectRatios - 画像の幅と高さに指定された比率に対応する浮動小数点数です。最大 16 個までのクロップ比を指定できます。

   HTTP メソッドと URL:

   POST https://vision.googleapis.com/v1/images:annotate

   リクエストの本文（JSON）:

   {
     "requests": [
       {
         "image": {
           "source": {
             "gcsImageUri": "CLOUD_STORAGE_IMAGE_URI"
           }
         },
         "features": [
           {
             "type": "CROP_HINTS"
           }
         ],
         "imageContext": {
           "cropHintsParams": {
             "aspectRatios": [
                2.0
             ]
           }
         }
       }
     ]
   }
   

   リクエストを送信するには、次のいずれかのオプションを選択します。

   curl

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "x-goog-user-project: PROJECT_ID" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://vision.googleapis.com/v1/images:annotate"

   PowerShell

   注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://vision.googleapis.com/v1/images:annotate" | Select-Object -Expand Content

   リクエストが成功すると、サーバーは 200 OK HTTP ステータス コードと JSON 形式のレスポンスを返します。

   レスポンス:

   Note: Zero coordinate values omitted. When the API detects a coordinate ("x" or "y") value of 0, that coordinate is omitted in the JSON response. Thus, a response with a bounding poly around the entire image would be
   [{},{"x": 100},{"x": 100,"y": 100},{"y": 100}] for an image that is 100 pixels by 100 pixels. For more information, see the API Reference documentation.

   ゼロ座標の省略（上記の注を参照）により、レスポンス内のクロップヒントの座標は次のようになります。

   • {"x": 0, "y": 520}, {"x": 2369, "y": 520},{"x": 2369,"y": 1729}, {"x": 0, "y": 1729}.

   {
     "responses": [
       {
         "cropHintsAnnotation": {
           "cropHints": [
             {
               "boundingPoly": {
                 "vertices": [
                   {
                     "y": 520
                   },
                   {
                     "x": 2369,
                     "y": 520
                   },
                   {
                     "x": 2369,
                     "y": 1729
                   },
                   {
                     "y": 1729
                   }
                 ]
               },
               "confidence": 0.79999995,
               "importanceFraction": 0.66999996
             }
           ]
         }
       }
     ]
   }
   

   Java

   このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Java の設定を完了してください。 詳細については、Vision Java API のリファレンス ドキュメントをご覧ください。

   Vision に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。

   
   import com.google.cloud.vision.v1.AnnotateImageRequest;
   import com.google.cloud.vision.v1.AnnotateImageResponse;
   import com.google.cloud.vision.v1.BatchAnnotateImagesResponse;
   import com.google.cloud.vision.v1.CropHint;
   import com.google.cloud.vision.v1.CropHintsAnnotation;
   import com.google.cloud.vision.v1.Feature;
   import com.google.cloud.vision.v1.Image;
   import com.google.cloud.vision.v1.ImageAnnotatorClient;
   import com.google.cloud.vision.v1.ImageSource;
   import java.io.IOException;
   import java.util.ArrayList;
   import java.util.List;
   
   public class DetectCropHintsGcs {
   
     public static void detectCropHintsGcs() throws IOException {
       // TODO(developer): Replace these variables before running the sample.
       String filePath = "gs://your-gcs-bucket/path/to/image/file.jpg";
       detectCropHintsGcs(filePath);
     }
   
     // Suggests a region to crop to for a remote file on Google Cloud Storage.
     public static void detectCropHintsGcs(String gcsPath) throws IOException {
       List<AnnotateImageRequest> requests = new ArrayList<>();
   
       ImageSource imgSource = ImageSource.newBuilder().setGcsImageUri(gcsPath).build();
       Image img = Image.newBuilder().setSource(imgSource).build();
       Feature feat = Feature.newBuilder().setType(Feature.Type.CROP_HINTS).build();
       AnnotateImageRequest request =
           AnnotateImageRequest.newBuilder().addFeatures(feat).setImage(img).build();
       requests.add(request);
   
       // Initialize client that will be used to send requests. This client only needs to be created
       // once, and can be reused for multiple requests. After completing all of your requests, call
       // the "close" method on the client to safely clean up any remaining background resources.
       try (ImageAnnotatorClient client = ImageAnnotatorClient.create()) {
         BatchAnnotateImagesResponse response = client.batchAnnotateImages(requests);
         List<AnnotateImageResponse> responses = response.getResponsesList();
   
         for (AnnotateImageResponse res : responses) {
           if (res.hasError()) {
             System.out.format("Error: %s%n", res.getError().getMessage());
             return;
           }
   
           // For full list of available annotations, see http://g.co/cloud/vision/docs
           CropHintsAnnotation annotation = res.getCropHintsAnnotation();
           for (CropHint hint : annotation.getCropHintsList()) {
             System.out.println(hint.getBoundingPoly());
           }
         }
       }
     }
   }

   Go

   このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Go の設定を完了してください。詳細については、Vision Go API のリファレンス ドキュメントをご覧ください。

   Vision に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。

   
   // detectCropHints gets suggested croppings the Vision API for an image at the given file path.
   func detectCropHintsURI(w io.Writer, file string) error {
   	ctx := context.Background()
   
   	client, err := vision.NewImageAnnotatorClient(ctx)
   	if err != nil {
   		return err
   	}
   
   	image := vision.NewImageFromURI(file)
   	res, err := client.CropHints(ctx, image, nil)
   	if err != nil {
   		return err
   	}
   
   	fmt.Fprintln(w, "Crop hints:")
   	for _, hint := range res.CropHints {
   		for _, v := range hint.BoundingPoly.Vertices {
   			fmt.Fprintf(w, "(%d,%d)\n", v.X, v.Y)
   		}
   	}
   
   	return nil
   }
   

   Node.js

   このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Node.js の設定を完了してください。詳細については、Vision Node.js API のリファレンス ドキュメントをご覧ください。

   Vision に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。

   
   // Imports the Google Cloud client libraries
   const vision = require('@google-cloud/vision');
   
   // Creates a client
   const client = new vision.ImageAnnotatorClient();
   
   /**
    * TODO(developer): Uncomment the following lines before running the sample.
    */
   // const bucketName = 'Bucket where the file resides, e.g. my-bucket';
   // const fileName = 'Path to file within bucket, e.g. path/to/image.png';
   
   // Find crop hints for the remote file
   const [result] = await client.cropHints(`gs://${bucketName}/${fileName}`);
   const cropHints = result.cropHintsAnnotation;
   cropHints.cropHints.forEach((hintBounds, hintIdx) => {
     console.log(`Crop Hint ${hintIdx}:`);
     hintBounds.boundingPoly.vertices.forEach((bound, boundIdx) => {
       console.log(`  Bound ${boundIdx}: (${bound.x}, ${bound.y})`);
     });
   });

   Python

   このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Python の設定を完了してください。詳細については、Vision Python API のリファレンス ドキュメントをご覧ください。

   Vision に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。

   def detect_crop_hints_uri(uri):
       """Detects crop hints in the file located in Google Cloud Storage."""
       from google.cloud import vision
   
       client = vision.ImageAnnotatorClient()
       image = vision.Image()
       image.source.image_uri = uri
   
       crop_hints_params = vision.CropHintsParams(aspect_ratios=[1.77])
       image_context = vision.ImageContext(crop_hints_params=crop_hints_params)
   
       response = client.crop_hints(image=image, image_context=image_context)
       hints = response.crop_hints_annotation.crop_hints
   
       for n, hint in enumerate(hints):
           print(f"\nCrop Hint: {n}")
   
           vertices = [
               f"({vertex.x},{vertex.y})" for vertex in hint.bounding_poly.vertices
           ]
   
           print("bounds: {}".format(",".join(vertices)))
   
       if response.error.message:
           raise Exception(
               "{}\nFor more info on error messages, check: "
               "https://cloud.google.com/apis/design/errors".format(response.error.message)
           )
   
   

   gcloud

   テキスト検出を行うには、次の例のように gcloud ml vision suggest-crop コマンドを実行します。

   gcloud ml vision suggest-crop gs://cloud-samples-data/vision/crop_hints/bubble.jpeg

   その他の言語

   C#: クライアント ライブラリ ページの C# の設定手順を行ってから、.NET 用の Vision リファレンス ドキュメントをご覧ください。

   PHP: クライアント ライブラリ ページの PHP の設定手順を行ってから、PHP 用の Vision リファレンス ドキュメントをご覧ください。

   Ruby: クライアント ライブラリ ページの Ruby の設定手順を行ってから、Ruby 用の Vision リファレンス ドキュメントをご覧ください。

   試してみる

   クロップヒントの検出を試してみましょう。すでに指定済みの画像（gs://cloud-samples-data/vision/crop_hints/bubble.jpeg）を使用することも、独自の画像を指定することもできます。[実行] を選択してリクエストを送信します。

   

   画像クレジット: Yasmin Dangor、Unsplash より

   リクエストの本文:

   {
     "requests": [
       {
         "image": {
           "source": {
             "gcsImageUri": "gs://cloud-samples-data/vision/crop_hints/bubble.jpeg"
           }
         },
         "features": [
           {
             "type": "CROP_HINTS"
           }
         ],
         "imageContext": {
           "cropHintsParams": {
             "aspectRatios": [
               2
             ]
           }
         }
       }
     ]
   }