ImageContext

画像コンテキストおよび機能固有のパラメータ。

JSON 表現 
{
  "latLongRect": {
    object(LatLongRect)
  },
  "languageHints": [
    string
  ],
  "cropHintsParams": {
    object(CropHintsParams)
  },
  "productSearchParams": {
    object(ProductSearchParams)
  },
  "webDetectionParams": {
    object(WebDetectionParams)
  },
  "textDetectionParams": {
    object(TextDetectionParams)
  },
  "qualityOptimizationParams": {
    object(QualityOptimizationParams)
  },
  "documentParsingParams": {
    object(DocumentParsingParams)
  }
}
フィールド
latLongRect

object(LatLongRect)

使用されません。
languageHints[]

string

TEXT_DETECTION に使用する言語のリスト。ほとんどの場合、値を空にして自動言語検出を有効にしておくことによって最善の結果が得られます。ラテン アルファベット系の言語の場合、languageHints の設定は不要です。画像中のテキストの言語がわかっている場合などに、ヒントを設定すると結果が少し良くなります（逆に、ヒントを間違えると大きく阻害します）。サポートされる言語以外の言語が 1 つでも指定されていると、テキスト検出でエラーが返されます。
cropHintsParams

object(CropHintsParams)

クロップヒント アノテーション リクエストのパラメータ。
productSearchParams

object(ProductSearchParams)

Product Search のパラメータ。
webDetectionParams

object(WebDetectionParams)

ウェブ検出のパラメータ。
textDetectionParams

object(TextDetectionParams)

ドキュメント テキスト検出のパラメータ。
qualityOptimizationParams

object(QualityOptimizationParams)

画像品質最適化のパラメータ。
documentParsingParams

object(DocumentParsingParams)

ドキュメント解析のパラメータ。

LatLongRect

最小および最大 LatLng のペアにより決定する長方形。

JSON 表現 
{
  "minLatLng": {
    object(LatLng)
  },
  "maxLatLng": {
    object(LatLng)
  }
}
フィールド
minLatLng

object(LatLng)

最小緯度 / 経度ペア。
maxLatLng

object(LatLng)

最大緯度 / 経度ペア。

CropHintsParams

クロップヒント アノテーション リクエストのパラメータ。

JSON 表現 
{
  "aspectRatios": [
    number
  ]
}
フィールド
aspectRatios[]

number

浮動小数点数で示されるアスペクト比。画像の幅対高さの比率を表します。たとえば、必要なアスペクト比が 4/3 の場合、対応する浮動小数点値は 1.33333 です。指定しない場合は、最適なクロップが返されます。指定できるアスペクト比の数は最大で 16 個です。17 番目以降のアスペクト比はすべて無視されます。

ProductSearchParams

Product Search リクエストのパラメータ。

JSON 表現 
{
  "boundingPoly": {
    object(BoundingPoly)
  },
  "productSet": string,
  "productCategories": [
    string
  ],
  "filter": string
}
フィールド
boundingPoly

object(BoundingPoly)

画像内の関心領域を囲む境界ポリゴン。省略可。指定しない場合は、自動的に適用されます。
productSet

string

類似画像を検索する ProductSet のリソース名。

形式: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID
productCategories[]

string

検索する商品カテゴリのリスト。現在、最初のカテゴリのみが考慮されます。homegoods、apparel、toys のいずれかを指定する必要があります。
filter

string

フィルタ式。商品ラベルに基づいて検索結果を制限できます。現在、Key-Value 式の OR の AND がサポートされています。OR 内の各式は同じキーにする必要があります。

たとえば、「(color = red OR color = blue) AND brand = Google」は使用できますが、「(color = red OR brand = Google)」や「color: red」は使用できません。

WebDetectionParams

ウェブ検出リクエストのパラメータ。

JSON 表現 
{
  "includeGeoResults": boolean
}
フィールド
includeGeoResults

boolean

地理情報から得られた結果を画像に組み込むかどうか。

TextDetectionParams

テキスト検出のパラメータ。TEXT_DETECTION 機能と DOCUMENT_TEXT_DETECTION 機能の制御に使用されます。

JSON 表現 
{
  "disableOrientationDetection": boolean,
  "disableTextAnnotations": boolean,
  "pageFilter": string,
  "blockFilter": string,
  "paragraphFilter": string,
  "wordFilter": string,
  "symbolFilter": string
}
フィールド
disableOrientationDetection

boolean

回転されたテキストが検出されないように、方向の検出を無効にします。これは DOCUMENT_TEXT_DETECTION でのみサポートされています。
disableTextAnnotations

boolean

古い textAnnotations フィールドを無効にします。full_text_annotations のみが返されます。
pageFilter

string (FieldMask format)

fullTextAnnotation のページレベルで返されるデータを制御します。未設定の場合のデフォルト: すべてのフィールドが含まれます。

完全修飾された項目名のカンマ区切りリスト。例: "user.displayName,photo"。
blockFilter

string (FieldMask format)

fullTextAnnotation によりブロックレベルで返されるデータを制御します。未設定の場合のデフォルト: mergedText を除くすべてのフィールドが含まれます。

完全修飾された項目名のカンマ区切りリスト。例: "user.displayName,photo"。
paragraphFilter

string (FieldMask format)

fullTextAnnotation により段落レベルで返されるデータを制御します。未設定の場合のデフォルト: mergedText を除くすべてのフィールドが含まれます。

完全修飾された項目名のカンマ区切りリスト。例: "user.displayName,photo"。
wordFilter

string (FieldMask format)

fullTextAnnotation により単語レベルで返されるデータを制御します。未設定の場合のデフォルト: mergedText を除くすべてのフィールドが含まれます。

完全修飾された項目名のカンマ区切りリスト。例: "user.displayName,photo"。
symbolFilter

string (FieldMask format)

fullTextAnnotation によりシンボルレベルで返されるデータを制御します。未設定の場合のデフォルト: boundingBox を除くすべてのフィールドが含まれます。

完全修飾された項目名のカンマ区切りリスト。例: "user.displayName,photo"。

QualityOptimizationParams

画像品質最適化のパラメータ。

JSON 表現 
{
  "type": enum(Type),
  "compressionConfig": {
    object(CompressionConfig)
  },
  "enhancementConfig": {
    object(EnhancementConfig)
  },
  "qualityScoreConfig": {
    object(QualityScoreConfig)
  }
}
フィールド
type

enum(Type)

最適化タイプを 1 つ選択します。
compressionConfig

object(CompressionConfig)

圧縮構成を指定します。
enhancementConfig

object(EnhancementConfig)

自動補正の構成を指定します。
qualityScoreConfig

object(QualityScoreConfig)

品質スコアの構成を指定します。

CompressionConfig

COMPRESSION の構成。

JSON 表現 
{
  "targetQuality": number
}
フィールド
targetQuality

number

範囲は [0, 1] です。圧縮後のターゲットの品質。1 は、入力画像と比べて損失がないことを意味します。0 は、最小品質要件がないことを意味します。

EnhancementConfig

ENHANCMENT の構成。enhancementConfig を指定しないと、デフォルト値 sharpeningLevel が 0.5 になり、autoHdrLevel が 0.5、upscaleRatio が 1 になります。これらのパラメータのいずれかをカスタマイズする場合は、EnhancementConfig 全体を指定する必要があります。たとえば、通常は autoHdrLevel の値を高めにし（これによって画像が明るくなり、シャープ処理レベルとスケールアップ率をデフォルトと同じ値にする）場合は、enhancementConfig { sharpeningLevel: 0.5 autoHdrLevel: 1.0 upscaleRatio: 1 } のように設定します。

JSON 表現 
{
  "sharpeningLevel": number,
  "autoHdrLevel": number,
  "upscaleRatio": number
}
フィールド
sharpeningLevel

number

範囲は [0,1] です。シャープ処理のレベル。0 はシャープ処理なし、1 は最大のシャープ処理レベルを意味します。デフォルト値は 0.5 です。
autoHdrLevel

number

範囲は [0,1] です。自動 HDR のレベル。0 は自動 HDR なし、1 は最大の AutoHDR を意味します。デフォルト値は 0.5 です。
upscaleRatio

number

範囲は [1, 2] です。アップスケーリングを行うかどうか。デフォルト値は 1 で、この場合、アップスケーリングは行われません。指定すると、出力の高さと幅は、元の高さと幅に upscaleRatio を掛けた値になります。

QualityScoreConfig

QUALITY_SCORE の構成。

JSON 表現 
{
  "qualityModel": string
}
フィールド
qualityModel

string

使用するモデルを指定します。デフォルト値は空の文字列で、美的スコアが返されます。サポートしているもう一つの品質モデルは builtin/Technical-score で、これは画像の技術的な品質を返します。

DocumentParsingParams

DOCUMENT_PARSING 機能のパラメータ。

JSON 表現 
{
  "disableOrientationDetection": boolean,
  "tableDetectionOptions": {
    object(TableDetectionOptions)
  },
  "documentType": string
}
フィールド
disableOrientationDetection

boolean

回転されたテキストが検出されないように、方向の検出を無効にします。
tableDetectionOptions

object(TableDetectionOptions)

テーブル検出の動作を制御します。このフィールドを設定しない場合、テーブル検出は無効になります。
documentType

string

より深い構造検出を行う場合は、既知のドキュメント タイプを指定します。現時点で有効な値は invoice か general です。

TableDetectionOptions

テーブル検出のオプション。

JSON 表現 
{
  "tableBoundHints": [
    {
      object(TableBoundHint)
    }
  ]
}
フィールド
tableBoundHints[]

object(TableBoundHint)

アルゴリズムでテーブルの場所を特定できない複雑なケースで表示されるオプションのテーブル境界ボックスのヒント。

TableBoundHint

テーブル解析用のページに対するテーブル境界ボックスのヒント。

JSON 表現 
{
  "pageNumber": number,
  "boundingBox": {
    object(BoundingPoly)
  }
}
フィールド
pageNumber

number

このヒントが適用される複数のページ入力のページ番号（省略可）。指定しなかった場合、このヒントはデフォルトですべてのページに適用されます。この値は、1 から始まるインデックスです。
boundingBox

object(BoundingPoly)

このページのテーブルに対する境界ボックスのヒント。座標は [0,1] に正規化され、境界ボックスは軸を合わせた長方形になります。