このドキュメントでは、画像解析ブロックの画像の解析結果について解説します。

info_outline 画像解析ブロックの「検知する情報」ごとのサンプル集を「画像解析ブロック サンプル」でまとめています。

warning 画像の解析結果は、2019 年 2 月時点の「Method: images.annotate  |  Cloud Vision API  |  Google Cloud open_in_new」の内容を元に記載しています。

画像の解析結果

画像の解析に成功すると、JSON 形式のデータを変数 _ (アンダースコア) に出力します。出力先の変数は、「結果を格納する変数」プロパティで、自由に変更できます。

{
  "faceAnnotations": [{...}],
  "landmarkAnnotations": [{...}],
  "logoAnnotations": [{...}],
  "labelAnnotations": [{...}],
  "textAnnotations": [{...}],
  "fullTextAnnotation": {...},
  "safeSearchAnnotation": {...},
  "imagePropertiesAnnotation": {...},
  "cropHintsAnnotation": {...},
  "gcs_url": string,
  "timestamp": number
}

"gcs_url" と "timestamp" 以外は、対象を検知したときのみ情報が出力されます。例えば、"faceAnnotations" は、解析する画像から顔を検知したときのみ出力されます。

顔検知（faceAnnotations）

顔検知の結果データは、配列値（[...] という形式）です。配列値の要素は、検知した顔のデータを表すオブジェクト値（{...} という形式）です。

"faceAnnotations": [
  {...},
  {...}
]

検知した顔のデータを表すオブジェクト値の形式は、以下のとおりです。出力例は、「画像解析ブロック サンプル > 顔検知 サンプル 」を参照してください。

{
  "boundingPoly": {...},
  "fdBoundingPoly": {...},
  "landmarks": {...},
  "rollAngle": number,
  "panAngle": number,
  "tiltAngle": number,
  "detectionConfidence": number,
  "landmarkingConfidence": number,
  "joyLikelihood": string,
  "sorrowLikelihood": string,
  "angerLikelihood": string,
  "surpriseLikelihood": string,
  "underExposedLikelihood": string,
  "blurredLikelihood": string,
  "headwearLikelihood": string
}

ランドマーク検知（landmarkAnnotations）

ランドマーク検知の結果データは、配列値です。配列値の要素は、検知したランドマークのデータを表すオブジェクト値です。

"landmarkAnnotations": [
  {...},
  {...}
]

検知したランドマークのデータを表すオブジェクト値の形式は、以下のとおりです。出力例は、「画像解析ブロック サンプル > ランドマーク検知 サンプル 」を参照してください。

{
  "mid": string,
  "description": string,
  "score": number,
  "boundingPoly": {...},
  "locations": [{...}]
}

ロゴ検知（logoAnnotations）

ロゴ検知の結果データは、配列値です。配列値の要素は、検知したロゴのデータを表すオブジェクト値です。

"logoAnnotations": [
  {...},
  {...}
]

検知したロゴのデータを表すオブジェクト値の形式は、以下のとおりです。出力例は、「画像解析ブロック サンプル > ロゴ検知 サンプル 」を参照してください。

{
  "description": string,
  "score": number,
  "boundingPoly": {...}
}

物体検知（labelAnnotations）

物体検知の結果データは、配列値です。配列値の要素は、検知した物体のデータを表すオブジェクト値です。

"labelAnnotations": [
  {...},
  {...}
]

検知した物体のデータを表すオブジェクト値の形式は、以下のとおりです。出力例は、「画像解析ブロック サンプル > 物体検知 サンプル 」を参照してください。

{
  "mid": string,
  "description": string,
  "score": number
}

テキスト検知（textAnnotations）

テキスト検知の結果データは、配列値です。配列値の要素は、検知したテキストのデータを表すオブジェクト値です。

"textAnnotations": [
  {...},
  {...}
]

検知したテキストのデータを表すオブジェクト値の形式は、以下のとおりです。出力例は、「画像解析ブロック サンプル > テキスト検知 サンプル 」を参照してください。

{
  "locale": string,
  "description": string,
  "boundingPoly": {...}
}

テキスト検知または OCR（ドキュメント）検知（fullTextAnnotation）

テキスト検知または OCR（ドキュメント）検知のデータ形式は、以下のとおりです。

"fullTextAnnotation": {
  "pages": [
    {...},
    {...}
  ],
  "text": string
}

有害コンテンツ検知（safeSearchAnnotation）

有害コンテンツ検知の結果データの形式は、以下のとおりです。出力例は、「画像解析ブロック サンプル > 有害コンテンツ検知 サンプル 」を参照してください。

{
  "adult": string,
  "spoof": string,
  "medical": string,
  "violence": string
}

色解析（imagePropertiesAnnotation）

色解析の結果データの形式は、以下のとおりです。

"imagePropertiesAnnotation": {
  "dominantColors": {...}
}

ドミナントカラーを表すオブジェクト値は、検知したドミナントカラーに関する色情報を持ちます。通常、色情報は、複数あります。

"dominantColors": {
  "colors": [
    {...},
    {...}
  ]
}

色情報の形式は、以下のとおりです。出力例は、「画像解析ブロック サンプル > 色解析 サンプル 」を参照してください。

{
  "color": {...},
  "score": number,
  "pixelFraction": number
}

色の RGB 値を表すオブジェクト値のデータ形式は、以下のとおりです。

{
  "red": number,
  "green": number,
  "blue": number
}

クロップヒントの集合（cropHintsAnnotation）

クロップヒントの集合のデータ形式は、以下のとおりです。出力例は、「画像解析ブロック サンプル > 色解析 サンプル 」を参照してください。

{
  "cropHints": [
    {...},
    {...}
  ]
}

クロップヒント（cropHint）

クロップヒントのデータ形式は、以下のとおりです。

{
  "boundingPoly": {...},
  "confidence": number,
  "importanceFraction": number
}

多角形を表すオブジェクト（"boundingPoly" / "fdBoundingPoly"）

多角形を表すオブジェクトのデータ形式は、以下のとおりです。

{
  "vertices": [{...}, ..., {...}]
}

頂点を表すオブジェクト

頂点を表すオブジェクトは、画像内の 2 次元座標を表します。データ形式は、以下のとおりです。

{
  "x": number,
  "y": number
}

度合い

度合いは、6 種類の文字列で表します。文字列の種類と意味は、以下のとおりです。

顔のパーツを表すオブジェクト

顔のパーツを表すオブジェクトは、パーツの種類（左目や右目など）とその位置で表します。データ形式は、以下のとおりです。

{
  "type": string,
  "position": {...}
}

パーツの種類

パーツの種類は、顔のパーツを特定する文字列で表します。文字列の種類と意味は、以下のとおりです。

パーツの位置を表すオブジェクト

パーツの位置を表すオブジェクトは、画像内の 3 次元座標を表します。データ形式は、以下のとおりです。

{
  "x": number,
  "y": number,
  "z": number
}

地理的な位置を表すオブジェクト（locations）

地理的な位置を表すオブジェクトは、配列値です。配列値の要素は、位置を緯度と経度で表すオブジェクト値です。

"locations": [
  {...},
  {...}
]

位置を緯度と経度で表すオブジェクト値のデータ形式は、以下のとおりです。

{
  "latLng": {
    "latitude": number,
    "longitude": number
  }
}

ページ（page）

テキスト検知で検出されたページのデータ形式は、以下のとおりです。

{
  "blocks": [
    {...},
    {...}
  ],
  "width": number,
  "height": number,
  "property": {...}
}

追加情報（property）

追加情報のデータ形式は、以下のとおりです。

{
  "detectedLanguages": [
    {...},
    {...}
  ],
  "detectedBreak": {...}
}

検出言語（detectedLanguage）

検出した言語のデータ形式は、以下のとおりです。

{
  "languageCode": string,
  "confidence": number
}

区切りを検知（detectedBreak）

テキストの区切り（開始もしくは終了）を検知のデータ形式は、以下のとおりです。

{
  "type": string,
  "isPrefix": boolean
}

区切りタイプ（breakType）

区切りタイプには、以下の種類があります。

ブロック（block）

ブロックは、ページ上の論理的要素です。このデータ形式は、以下のとおりです。

{
  "boundingBox": {...},
  "paragraphs": [
    {...},
    {...}
  ],
  "blockType": string,
  "confidence": number,
}

0----1
|    |
3----2

2----3
|    |
1----0

段落（paragraph）

段落のデータ形式は、以下のとおりです。

{
  "boundingBox": {...},
  "words": [
    {...},
    {...}
  ],
  "confidence": number
}

0----1
|    |
3----2

2----3
|    |
1----0

単語（word）

単語のデータ形式は、以下のとおりです。

{
  "property": {...},
  "boundingBox": {...},
  "symbols": [
    {...},
    {...}
  },
  "confidence": number
}

0----1
|    |
3----2

2----3
|    |
1----0

文字（symbol）

文字のデータ形式は、以下のとおりです。

{
  "property": {...},
  "boundingBox": {...},
  "text": string,
  "confidence": number
}

0----1
|    |
3----2

2----3
|    |
1----0

ブロックタイプ（blockType）

ブロックタイプは、テキスト検知で識別されるブロックの種類です。種類は、以下のいずれかです。