网络检测功能可检测对图片的网络引用。
| 类别 | 响应 |
|---|---|
| Web 实体 |
|
| 完全匹配的图片 |
|
| 部分匹配的图片 |
|
| 具有匹配图片的页面 |
|
| 外观类似的图片 |
|
| 最佳猜测标签 | 2019 年里约狂欢节舞者 |
Web 检测请求
设置您的 GCP 项目和身份验证
使用本地图片检测 Web 实体
Vision API 可以将本地图片文件的内容作为 base64 编码的字符串在请求正文中发送，从而对此图片文件执行特征检测。
REST 和命令行
在使用任何请求数据之前，请先进行以下替换：
- base64-encoded-image：二进制图片数据的 base64 表示（ASCII 字符串）。此字符串应类似于以下字符串：
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
HTTP 方法和网址：
POST https://vision.googleapis.com/v1/images:annotate
请求 JSON 正文：
{
"requests": [
{
"image": {
"content": "base64-encoded-image"
},
"features": [
{
"maxResults": 10,
"type": "WEB_DETECTION"
},
]
}
]
}
如需发送请求，请选择以下方式之一：
curl
将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://vision.googleapis.com/v1/images:annotate"
PowerShell
将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://vision.googleapis.com/v1/images:annotate" | Select-Object -Expand Content
如果请求成功，服务器将返回一个 200 OK HTTP 状态代码以及 JSON 格式的响应。
响应：
Go
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Go 设置说明进行操作。如需了解详情，请参阅 Vision Go API 参考文档。
Java
在试用此示例之前，请按照Vision API 快速入门：使用客户端库中的 Java 设置说明进行操作。如需了解详情，请参阅 Vision API Java API 参考文档。
Node.js
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Node.js 设置说明进行操作。如需了解详情，请参阅 Vision Node.js API 参考文档。
Python
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Python 设置说明进行操作。如需了解详情，请参阅 Vision Python API 参考文档。
其他语言
C#： 请按照客户端库页面上的 C# 设置说明操作，然后访问 .NET 版 Vision 参考文档。
PHP： 请按照客户端库页面上的 PHP 设置说明操作，然后访问 PHP 版 Vision 参考文档。
Ruby 版： 请按照客户端库页面上的 Ruby 设置说明操作，然后访问 Ruby 版 Vision 参考文档。
使用远程图片检测 Web 实体
为方便起见，Vision API 可以直接对位于 Google Cloud Storage 或网络中的图片文件执行特征检测，无需在请求正文中发送图片文件的内容。
REST 和命令行
在使用任何请求数据之前，请先进行以下替换：
- cloud-storage-image-uri：Cloud Storage 存储分区中有效图片文件的路径。您必须至少拥有该文件的读取权限。
示例：
gs://cloud-samples-data/vision/web/carnaval.jpeg
HTTP 方法和网址：
POST https://vision.googleapis.com/v1/images:annotate
请求 JSON 正文：
{
"requests": [
{
"image": {
"source": {
"gcsImageUri": "cloud-storage-image-uri"
}
},
"features": [
{
"maxResults": 10,
"type": "WEB_DETECTION"
},
]
}
]
}
如需发送请求，请选择以下方式之一：
curl
将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://vision.googleapis.com/v1/images:annotate"
PowerShell
将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://vision.googleapis.com/v1/images:annotate" | Select-Object -Expand Content
如果请求成功，服务器将返回一个 200 OK HTTP 状态代码以及 JSON 格式的响应。
响应：
Go
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Go 设置说明进行操作。如需了解详情，请参阅 Vision Go API 参考文档。
Java
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Java 设置说明进行操作。如需了解详情，请参阅 Vision Java API 参考文档。
Node.js
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Node.js 设置说明进行操作。如需了解详情，请参阅 Vision Node.js API 参考文档。
Python
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Python 设置说明进行操作。如需了解详情，请参阅 Vision Python API 参考文档。
gcloud
如需执行 Web 检测，请使用 gcloud ml vision detect-web 命令，如以下示例所示：
gcloud ml vision detect-web gs://cloud-samples-data/vision/web/carnaval.jpeg
其他语言
C#： 请按照客户端库页面上的 C# 设置说明操作，然后访问 .NET 版 Vision 参考文档。
PHP： 请按照客户端库页面上的 PHP 设置说明操作，然后访问 PHP 版 Vision 参考文档。
Ruby 版： 请按照客户端库页面上的 Ruby 设置说明操作，然后访问 Ruby 版 Vision 参考文档。
在本地图片中使用地理元数据
Vision API 可以访问图片文件中的地理标记元数据，以返回更多相关的网络实体和页面。如需允许使用地理标记，请在请求中指定 'includeGeoResults': true。
REST 和命令行
在使用任何请求数据之前，请先进行以下替换：
- cloud-storage-image-uri：Cloud Storage 存储分区中有效图片文件的路径。您必须至少拥有该文件的读取权限。
示例：
gs://cloud-samples-data/vision/web/carnaval.jpeg
HTTP 方法和网址：
POST https://vision.googleapis.com/v1/images:annotate
请求 JSON 正文：
{
"requests": [
{
"image": {
"source": {
"gcsImageUri": "cloud-storage-image-uri"
}
},
"features": [
{
"type": "WEB_DETECTION"
}
],
"imageContext": {
"webDetectionParams": {
"includeGeoResults": true
}
}
}
]
}
如需发送请求，请选择以下方式之一：
curl
将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://vision.googleapis.com/v1/images:annotate"
PowerShell
将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://vision.googleapis.com/v1/images:annotate" | Select-Object -Expand Content
如果请求成功，服务器将返回一个 200 OK HTTP 状态代码以及 JSON 格式的响应。
响应：
Go
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Go 设置说明进行操作。如需了解详情，请参阅 Vision Go API 参考文档。
Java
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Java 设置说明进行操作。如需了解详情，请参阅 Vision Java API 参考文档。
Node.js
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Node.js 设置说明进行操作。如需了解详情，请参阅 Vision Node.js API 参考文档。
Python
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Python 设置说明进行操作。如需了解详情，请参阅 Vision Python API 参考文档。
gcloud
如需执行 Web 检测，请使用 gcloud ml vision detect-web 命令，如以下示例所示：
gcloud ml vision detect-web gs://cloud-samples-data/vision/web/carnaval.jpeg
其他语言
C#： 请按照客户端库页面上的 C# 设置说明操作，然后访问 .NET 版 Vision 参考文档。
PHP： 请按照客户端库页面上的 PHP 设置说明操作，然后访问 PHP 版 Vision 参考文档。
Ruby 版： 请按照客户端库页面上的 Ruby 设置说明操作，然后访问 Ruby 版 Vision 参考文档。
在远程图片中使用地理元数据
Go
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Go 设置说明进行操作。如需了解详情，请参阅 Vision Go API 参考文档。
Java
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Java 设置说明进行操作。如需了解详情，请参阅 Vision Java API 参考文档。
Node.js
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Node.js 设置说明进行操作。如需了解详情，请参阅 Vision Node.js API 参考文档。
Python
试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Python 设置说明进行操作。如需了解详情，请参阅 Vision Python API 参考文档。
其他语言
C#： 请按照客户端库页面上的 C# 设置说明操作，然后访问 .NET 版 Vision 参考文档。
PHP： 请按照客户端库页面上的 PHP 设置说明操作，然后访问 PHP 版 Vision 参考文档。
Ruby 版： 请按照客户端库页面上的 Ruby 设置说明操作，然后访问 Ruby 版 Vision 参考文档。
试用
在下面尝试检测 Web 实体。您可以使用已指定的图片 (gs://cloud-samples-data/vision/web/carnaval.jpeg) 或指定您自己的图片。选择执行即可发送请求。
在 includeGeoResults 设置为 false 的情况下，尝试重复发送请求。
请求正文：
{
"requests": [
{
"features": [
{
"type": "WEB_DETECTION"
}
],
"image": {
"source": {
"gcsImageUri": "gs://cloud-samples-data/vision/web/carnaval.jpeg"
}
},
"imageContext": {
"webDetectionParams": {
"includeGeoResults": true
}
}
}
]
}