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。在極少數情況下，如果知道圖片中文字的語言，設定提示有助於獲得更準確的結果 (但如果提示錯誤，就會造成重大阻礙)。如果一或多種指定語言不是支援的語言，文字偵測功能會傳回錯誤。

cropHintsParams

object(CropHintsParams)

裁剪提示註解要求的參數。

productSearchParams

object(ProductSearchParams)

產品搜尋的參數。

webDetectionParams

object(WebDetectionParams)

網頁偵測的參數。

textDetectionParams

object(TextDetectionParams)

文件文字偵測的參數。

qualityOptimizationParams

object(QualityOptimizationParams)

圖片品質最佳化參數。

documentParsingParams

object(DocumentParsingParams)

文件剖析的參數。

緯度/經度矩形

由最小和最大 LatLng 配對決定的矩形。

JSON 表示法 
{
  "minLatLng": {
    object(LatLng)
  },
  "maxLatLng": {
    object(LatLng)
  }
}
欄位
minLatLng

object(LatLng)

經緯度下限。

maxLatLng

object(LatLng)

經緯度組合上限。

裁剪提示參數

裁剪提示註解要求的參數。

JSON 表示法 
{
  "aspectRatios": [
    number
  ]
}
欄位
aspectRatios[]

number

以浮點數表示長寬比，代表圖片的寬度與高度比例。舉例來說，如果所需長寬比為 4/3，對應的浮點值應為 1.33333。如未指定，系統會傳回最佳裁剪結果。提供的顯示比例最多只能有 16 個，超過 16 個的顯示比例會遭到忽略。

產品搜尋參數

產品搜尋要求的參數。

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

要搜尋的產品類別清單。目前我們只會考慮第一個類別，且必須指定「居家用品」、「服飾」或「玩具」。

filter

string

篩選運算式。這項功能可用於根據產品標籤限制搜尋結果。我們目前支援鍵值運算式的 OR 的 AND，其中 OR 內的每個運算式都必須有相同的鍵。

舉例來說，「(color = red OR color = blue) AND brand = Google」可以接受，但「(color = red OR brand = Google)」或「color: red」則不行。

網路偵測參數

網頁偵測要求的參數。

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)

選擇一種最佳化類型。

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 表示使用最大程度的自動 HDR。預設值為 0.5。

upscaleRatio

number

範圍為 [1, 2]。是否要放大，預設值為 1，表示不放大。如果指定，輸出高度和寬度會等於原始高度和寬度乘以 upscaleRatio。

QualityScoreConfig

品質分數的設定。

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]，且邊界框必須是與軸對齊的矩形。