Googleが提供しているVision APIをJavaで使ってみました。

APIを使用し、画像をクロップするヒント(座標)を取得します。
画像のクロップとは、中心のROI矩形領域のみの部分画像の切り出すことで
画像の最適化を行います。

記事では、APIの実行、その結果についてのみを記載していますので、
画像クロップや画像処理周りについて気になる方は検索してください。

APIを利用する環境の準備から始める場合や、コードを実行する際は、
⧉[Vision API] Javaで画像内のいろいろなものを検出する
を参照ください。

No		目次
1		Feature.Typeの指定
2		実行結果の取得
	1	レスポンスの出力
	2	レスポンスの内容
3		結果の検証
	1	繁華街
	2	交通標識
	3	ボーリング
	4	人物
	5	富士山
	6	熊本城
	7	街
	8	野菜
	9	猫
	10	デスク
	11	景色
	12	駐車場

1. Feature.Typeの指定

クロップヒントを検出する場合は、
Feature.Type.CROP_HINTS
を指定します。

以下の記事でexecApi()にタイプを指定します。
⧉[Vision API] Javaで画像内のいろいろなものを検出する

2. 実行結果の取得

2.1. レスポンスの出力

取得した結果をコンソールに出力します。

private static void output(BatchAnnotateImagesResponse response){
    List<AnnotateImageResponse> responses = response.getResponsesList();
    
    for (AnnotateImageResponse res : responses) {
        if (res.hasError()) {
            System.out.format("Error: %s%n", res.getError().getMessage());
            return;
        }

        CropHintsAnnotation annotation = res.getCropHintsAnnotation();
        for (CropHint hint : annotation.getCropHintsList()) {
            System.out.println(hint.getBoundingPoly());
        }
    }
}

2.2. レスポンスの内容

BatchAnnotateImagesResponseの
getResponsesListでAnnotateImageResponseリストが取得できます。
検出されなった場合は、空のリストが返ってきます。

AnnotateImageResponse

メソッド	戻り値	内容
getCropHintsAnnotation	CropHintsAnnotation	クロップを生成するために使用されるクロップヒントのセット

CropHintsAnnotation

メソッド	戻り値	内容
getCropHintsList	CropHint	新しいクロップを生成するために使用されるクロップヒント

CropHint

メソッド	戻り値	内容
getConfidence	float	検出の信頼性。範囲は0〜1
getImportanceFraction	float	元の画像に対する重要度の割合
getBoundingPoly	BoundingPoly	クロップ領域の境界ポリゴン