使用 Cloud Vision API 检测图片中的标签
本快速入门向您展示了如何执行以下操作:
- 创建 Cloud Storage 存储桶。
- 将图片上传到 Cloud Storage,并将文件设为可公开访问。
- 向 Vision API 发出处理该图片的请求。
完成上述步骤大约需要 5 分钟。您可以免费在 Cloud Storage 中存储多达 5 GB 的数据,并且每月可免费向 Vision API 发出多达 1,000 个功能请求。
准备工作
请按照以下说明设置项目并创建 Cloud Storage 存储桶(如果您尚未这样做)。
设置项目
- 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手,请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Enable the Cloud Vision API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Enable the Cloud Vision API.
创建 Cloud Storage 存储桶
- In the Google Cloud console, go to the Cloud Storage Buckets page.
- Click Create bucket.
- On the Create a bucket page, enter your bucket information. To go to the next
step, click Continue.
- For Name your bucket, enter a unique bucket name. Don't include sensitive information in the bucket name, because the bucket namespace is global and publicly visible.
-
For Choose where to store your data, do the following:
- Select a Location type option.
- Select a Location option.
- For Choose a default storage class for your data, select the following: Standard.
- For Choose how to control access to objects, select an Access control option.
- For Advanced settings (optional), specify an encryption method, a retention policy, or bucket labels.
- Click Create.
向 Cloud Vision 发出请求
保存示例图片文件的本地版本 (
demo-img.jpg
)。在 Google Cloud 控制台中,进入 Cloud Storage 存储桶页面。
选择您在上一部分创建的存储桶。
点击上传文件,然后选择要上传到 Cloud Storage 存储桶的
这是您刚才上传的图片文件:demo-img.jpg
文件的本地版本。在文件上传完毕并显示在 Cloud Storage 存储桶中后,公开共享图片。
在试用此方法部分中,通过将
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" } } } ] }
点击执行 (Execute) 以向该服务发送请求。JSON 响应会显示在请求正文之后。
恭喜!您已向 Cloud Vision 发出了第一个 images.annotate
请求。
清理
为避免产生不必要的 Google Cloud 费用,请使用 Google Cloud 控制台删除不需要的 Cloud Storage 存储桶(和项目)。