StartGcpVisionAnnotateImagesOperation Processor

类型全限定名：cn.org.acal.lynxus.processors.gcp.vision.StartGcpVisionAnnotateImagesOperation

所属 Bundle：cn.org.acal.lynxus:lynxus-gcp-nar:2.11.8

描述

对图像输入触发视觉操作。它后面应该是 GetGcpVisionAnnotateImagesOperationStatus 处理器，以便监视操作状态。

属性

下表中，加粗的属性为必填项；其余为可选项。表格同时标注默认值、是否支持表达式语言，以及是否为敏感属性（值会被加密）。

名称	默认值	可选值	描述
JSON Payload	`{ "requests": [{ "image": { "source": { "imageUri": "gs://${gcs.bucket}/${filename}" } }, "features": [{ "type": "${vision-feature-type}", "maxResults": 4 }] }], "outputConfig": { "gcsDestination": { "uri": "gs://${output-bucket}/${filename}/" }, "batchSize": 2 } }`		AWS 机器学习服务的 JSON 请求。当未指定此属性时，处理器将使用 FlowFile 内容进行请求。支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
GCP Credentials Provider Service		控制器服务 API： `GCPCredentialsService` cn.org.acal.lynxus-lynxus-gcp-services-api-nar-2.11.8	用于获取 Google Cloud Platform 凭据的Controller Service。
输出存储桶			Vision 作业输出将持久化的 GCS 存储桶名称。此属性的值在配置了 JSON Payload 属性时适用。JSON Payload 属性值可以使用表达式语言引用 ${output-bucket} 的值支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Vision 功能类型	`TEXT_DETECTION`		GCP Vision 功能类型。此属性的值在配置了 JSON Payload 属性时适用。JSON Payload 属性值可以使用表达式语言引用 ${vision-feature-type} 的值支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）

关系 (Relationships)

名称	描述	自动终止
`failure`	FlowFiles被路由到故障关系	否
`success`	FlowFiles被路由到成功关系	否

写入的 FlowFile 属性

名称	描述
`operationKey`	Vision 服务器返回的操作的唯一标识符。

状态管理

该组件不存储状态。

受限 (Restricted)

该组件不受限。

另请参阅

GetGcpVisionAnnotateImagesOperationStatus

详细说明

Google Vision

Google Cloud Vision - 启动图像标注操作

前提条件

确保已启用 Vision API，且你使用的账户有权使用它
确保输入图像位于 GCS 桶的 /input 文件夹下

用法

StartGcpVisionAnnotateImagesOperation 用于触发图像标注操作。该 Processor 应与 GetGcpVisionAnnotateImagesOperationStatus Processor 配对使用。输出 FlowFile 包含 Vision 服务器返回的针对该请求的原始响应。响应为 JSON 格式，包含结果和附加元数据，具体参见 Google Vision API 参考文档。

负载（Payload）

JSON Payload 是 Google Vision REST API 参考文档中记载的 JSON 格式请求。负载可以通过 JSON Payload 属性或 FlowFile 内容提供给 Processor，属性的优先级高于 FlowFile 内容。如果想使用 FlowFile 内容作为负载，请确保删除该属性的默认值。 JSON 负载模板示例：

{
  "requests": [
    {
      "image": {
        "source": {
          "imageUri": "gs://${gcs.bucket}/${filename}"
        }
      },
      "features": [
        {
          "type": "${vision-feature-type}",
          "maxResults": 4
        }
      ]
    }
  ],
  "outputConfig": {
    "gcsDestination": {
      "uri": "gs://${output-bucket}/${filename}/"
    },
    "batchSize": 2
  }
}

Feature 类型

TEXT_DETECTION: 针对图像的光学字符识别（OCR）；识别文本并转换为机器编码文本。识别并提取图像中的 UTF-8 文本。
DOCUMENT_TEXT_DETECTION: 针对文件（PDF/TIFF）或密集文本图像的光学字符识别（OCR）；密集文本识别并转换为机器编码文本。
LANDMARK_DETECTION: 提供地标的名称、置信度分数以及图像中地标的边界框。
LOGO_DETECTION: 提供所识别实体的文本描述、置信度分数以及文件中 logo 的边界多边形。
LABEL_DETECTION: 为图像提供通用标签。
等等。

更多细节参见 Google Vision Feature List

示例：如何搭建一个简单的图像标注流程