使用 Cloud Vision API 检测图片中的标签

本快速入门向您展示了如何执行以下操作：

  • 创建 Cloud Storage 存储分区。
  • 将图片上传到 Cloud Storage，并将文件设为可公开访问。
  • 向 Vision API 发出处理该图片的请求。

完成上述步骤大约需要 5 分钟。您可以免费在 Cloud Storage 中存储多达 5 GB 的数据，并且每月可免费向 Vision API 发出多达 1,000 个功能请求。

准备工作

请按照以下说明设置项目并创建 Cloud Storage 存储桶（如果您尚未这样做）。

设置项目

  1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

  2. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

    转到“项目选择器”

  3. 确保您的 Google Cloud 项目已启用结算功能。

  4. 启用 Cloud Vision API。

    启用 API

    5.

  5. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

    转到“项目选择器”

  6. 确保您的 Google Cloud 项目已启用结算功能。

  7. 启用 Cloud Vision API。

    启用 API

    8.

创建 Cloud Storage 存储桶

  1. 在 Google Cloud 控制台中，进入 Cloud Storage 存储桶页面。

    进入“存储桶”页面

  2. 点击创建存储分区。
  3. 在创建存储分区页面上，输入您的存储分区信息。要转到下一步，请点击继续。
    • 在指定存储分区的名称中，输入唯一的存储分区名称。请勿在存储分区名称中添加敏感信息，因为存储分区命名空间是全局性的，公开可见。
    • 对于选择数据存储位置，执行以下操作：
      • 选择位置类型选项。
      • 选择位置选项。
    • 对于为数据选择一个默认存储类别，选择以下项： Standard。
    • 对于选择如何控制对象的访问权限，请选择访问权限控制选项。
    • 对于高级设置（可选），请指定加密方法、保留政策或存储分区标签。
  4. 点击创建。

向 Cloud Vision 发出请求

  1. 保存示例图片文件的本地版本 (demo-img.jpg)。

  2. 在 Google Cloud 控制台中，进入 Cloud Storage 存储桶页面。

    进入“存储桶”

  3. 选择您在上一部分创建的存储分区。

  4. 点击上传文件，然后选择要上传到 Cloud Storage 存储桶的 demo-img.jpg 文件的本地版本。

    “上传文件”按钮。
    这是您刚才上传的图片文件：
    雅加达骑自行车的两名女子。
    图片来源： Unsplash 用户 Rohiim Ariful。

  5. 在文件上传完毕并显示在 Cloud Storage 存储桶中后，公开共享图片。

  6. 在试用此方法部分中，通过将 image.source.imageUri 字段中的 cloud-samples-data/vision 替换为在其中上传 demo-img.jpg 文件的 Cloud Storage 存储桶的名称，完成交互式 API Explorer 模板。请求正文应如下所示： 

    {
  "requests": [
    {
      "features": [
        {
          "type": "LABEL_DETECTION"
        }
      ],
      "image": {
        "source": {
          "imageUri": "gs://cloud-samples-data/vision/demo-img.jpg"
        }
      }
    }
  ]
}

  7. 点击执行 (Execute) 以向该服务发送请求。JSON 响应显示在请求正文之后。

恭喜！您已向 Cloud Vision 发出了第一个 images.annotate 请求。

清理

为避免产生不必要的 Google Cloud 费用，请使用 Google Cloud 控制台删除不需要的 Cloud Storage 存储桶（和项目）。

后续步骤