检测徽标

如果您尚未创建 Google Cloud 项目，请立即创建。展开本部分可查看相关说明。

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vision API.

Enable the API

Install the Google Cloud CLI.

如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

如需初始化 gcloud CLI，请运行以下命令：

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vision API.

Enable the API

Install the Google Cloud CLI.

如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

如需初始化 gcloud CLI，请运行以下命令：

gcloud init

检测本地图片中的徽标

您可以使用 Vision API 对本地图片文件执行特征检测。

对于 REST 请求，请将图片文件的内容作为 base64 编码的字符串在请求正文中发送。

对于 gcloud 和客户端库请求，请在请求中指定本地图片的路径。

REST

在使用任何请求数据之前，请先进行以下替换：

• BASE64_ENCODED_IMAGE：二进制图片数据的 base64 表示（ASCII 字符串）。此字符串应类似于以下字符串：
  • /9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
  如需了解详情，请参阅 base64 编码主题。
• PROJECT_ID：您的 Google Cloud 项目 ID。

HTTP 方法和网址：

POST https://vision.googleapis.com/v1/images:annotate

请求 JSON 正文：

 {   "requests": [     {       "image": {         "content": "BASE64_ENCODED_IMAGE"       },       "features": [         {           "type": "LOGO_DETECTION"         },       ]     }   ] } 

如需发送请求，请选择以下方式之一：

curl

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://vision.googleapis.com/v1/images:annotate"

PowerShell

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

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 格式的响应。

响应：

 {   "responses": [     {       "logoAnnotations": [         {           "mid": "/m/045c7b",           "description": "google",           "score": 0.980325,           "boundingPoly": {             "vertices": [               {                 "x": 12,                 "y": 42               },               {                 "x": 439,                 "y": 42               },               {                 "x": 439,                 "y": 285               },               {                 "x": 12,                 "y": 285               }             ]           }         }       ]     }   ] } 

Go

试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Go 设置说明进行操作。 如需了解详情，请参阅 Vision Go API 参考文档。

如需向 Vision 进行身份验证，请设置应用默认凭证。如需了解详情，请参阅为本地开发环境设置身份验证。

 // detectLogos gets logos from the Vision API for an image at the given file path. func detectLogos(w io.Writer, file string) error { 	ctx := context.Background()  	client, err := vision.NewImageAnnotatorClient(ctx) 	if err != nil { 		return err 	}  	f, err := os.Open(file) 	if err != nil { 		return err 	} 	defer f.Close()  	image, err := vision.NewImageFromReader(f) 	if err != nil { 		return err 	} 	annotations, err := client.DetectLogos(ctx, image, nil, 10) 	if err != nil { 		return err 	}  	if len(annotations) == 0 { 		fmt.Fprintln(w, "No logos found.") 	} else { 		fmt.Fprintln(w, "Logos:") 		for _, annotation := range annotations { 			fmt.Fprintln(w, annotation.Description) 		} 	}  	return nil } 

Java

在试用此示例之前，请按照Vision API 快速入门：使用客户端库中的 Java 设置说明进行操作。如需了解详情，请参阅 Vision API Java 参考文档。

 import com.google.cloud.vision.v1.AnnotateImageRequest; import com.google.cloud.vision.v1.AnnotateImageResponse; import com.google.cloud.vision.v1.BatchAnnotateImagesResponse; import com.google.cloud.vision.v1.EntityAnnotation; import com.google.cloud.vision.v1.Feature; import com.google.cloud.vision.v1.Image; import com.google.cloud.vision.v1.ImageAnnotatorClient; import com.google.protobuf.ByteString; import java.io.FileInputStream; import java.io.IOException; import java.util.ArrayList; import java.util.List;  public class DetectLogos {   public static void detectLogos() throws IOException {     // TODO(developer): Replace these variables before running the sample.     String filePath = "path/to/your/image/file.jpg";     detectLogos(filePath);   }    // Detects logos in the specified local image.    public static void detectLogos(String filePath) throws IOException {     List<AnnotateImageRequest> requests = new ArrayList<>();      ByteString imgBytes = ByteString.readFrom(new FileInputStream(filePath));      Image img = Image.newBuilder().setContent(imgBytes).build();     Feature feat = Feature.newBuilder().setType(Feature.Type.LOGO_DETECTION).build();     AnnotateImageRequest request =         AnnotateImageRequest.newBuilder().addFeatures(feat).setImage(img).build();     requests.add(request);      // Initialize client that will be used to send requests. This client only needs to be created     // once, and can be reused for multiple requests. After completing all of your requests, call     // the "close" method on the client to safely clean up any remaining background resources.     try (ImageAnnotatorClient client = ImageAnnotatorClient.create()) {       BatchAnnotateImagesResponse response = client.batchAnnotateImages(requests);       List<AnnotateImageResponse> responses = response.getResponsesList();        for (AnnotateImageResponse res : responses) {         if (res.hasError()) {           System.out.format("Error: %s%n", res.getError().getMessage());           return;         }          // For full list of available annotations, see http://g.co/cloud/vision/docs         for (EntityAnnotation annotation : res.getLogoAnnotationsList()) {           System.out.println(annotation.getDescription());         }       }     }   } }

Node.js

试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Node.js 设置说明进行操作。 如需了解详情，请参阅 Vision Node.js API 参考文档。

如需向 Vision 进行身份验证，请设置应用默认凭证。如需了解详情，请参阅为本地开发环境设置身份验证。

const vision = require('@google-cloud/vision');  // Creates a client const client = new vision.ImageAnnotatorClient();  /**  * TODO(developer): Uncomment the following line before running the sample.  */ // const fileName = 'Local image file, e.g. /path/to/image.png';  // Performs logo detection on the local file const [result] = await client.logoDetection(fileName); const logos = result.logoAnnotations; console.log('Logos:'); logos.forEach(logo => console.log(logo));

Python

试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Python 设置说明进行操作。 如需了解详情，请参阅 Vision Python API 参考文档。

如需向 Vision 进行身份验证，请设置应用默认凭证。如需了解详情，请参阅为本地开发环境设置身份验证。

def detect_logos(path):     """Detects logos in the file."""     from google.cloud import vision      client = vision.ImageAnnotatorClient()      with open(path, "rb") as image_file:         content = image_file.read()      image = vision.Image(content=content)      response = client.logo_detection(image=image)     logos = response.logo_annotations     print("Logos:")      for logo in logos:         print(logo.description)      if response.error.message:         raise Exception(             "{}\nFor more info on error messages, check: "             "https://cloud.google.com/apis/design/errors".format(response.error.message)         )  

其他语言

C#： 请按照客户端库页面上的 C# 设置说明操作，然后访问 .NET 版 Vision 参考文档。

PHP： 请按照客户端库页面上的 PHP 设置说明操作，然后访问 PHP 版 Vision 参考文档。

Ruby 版： 请按照客户端库页面上的 Ruby 设置说明操作，然后访问 Ruby 版 Vision 参考文档。

检测远程图片中的徽标

您可以使用 Vision API 对位于 Cloud Storage 或网络中的远程图片文件执行特征检测。如需发送远程文件请求，请在请求正文中指定文件的网址或 Cloud Storage URI。

REST

在使用任何请求数据之前，请先进行以下替换：

• CLOUD_STORAGE_IMAGE_URI：Cloud Storage 存储桶中有效图片文件的路径。您必须至少拥有该文件的读取权限。 示例：
  • gs://cloud-samples-data/vision/logo/google_logo.jpg

• PROJECT_ID：您的 Google Cloud 项目 ID。

HTTP 方法和网址：

POST https://vision.googleapis.com/v1/images:annotate

请求 JSON 正文：

 {   "requests": [     {       "image": {         "source": {           "gcsImageUri": "CLOUD_STORAGE_IMAGE_URI"         }       },       "features": [         {           "type": "LOGO_DETECTION"         },       ]     }   ] } 

如需发送请求，请选择以下方式之一：

curl

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://vision.googleapis.com/v1/images:annotate"

PowerShell

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

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 格式的响应。

响应：

 {   "responses": [     {       "logoAnnotations": [         {           "mid": "/m/045c7b",           "description": "google",           "score": 0.980325,           "boundingPoly": {             "vertices": [               {                 "x": 12,                 "y": 42               },               {                 "x": 439,                 "y": 42               },               {                 "x": 439,                 "y": 285               },               {                 "x": 12,                 "y": 285               }             ]           }         }       ]     }   ] } 

Go

试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Go 设置说明进行操作。 如需了解详情，请参阅 Vision Go API 参考文档。

如需向 Vision 进行身份验证，请设置应用默认凭证。如需了解详情，请参阅为本地开发环境设置身份验证。

 // detectLogos gets logos from the Vision API for an image at the given file path. func detectLogosURI(w io.Writer, file string) error { 	ctx := context.Background()  	client, err := vision.NewImageAnnotatorClient(ctx) 	if err != nil { 		return err 	}  	image := vision.NewImageFromURI(file) 	annotations, err := client.DetectLogos(ctx, image, nil, 10) 	if err != nil { 		return err 	}  	if len(annotations) == 0 { 		fmt.Fprintln(w, "No logos found.") 	} else { 		fmt.Fprintln(w, "Logos:") 		for _, annotation := range annotations { 			fmt.Fprintln(w, annotation.Description) 		} 	}  	return nil } 

Java

试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Java 设置说明进行操作。 如需了解详情，请参阅 Vision Java API 参考文档。

如需向 Vision 进行身份验证，请设置应用默认凭证。如需了解详情，请参阅为本地开发环境设置身份验证。

 import com.google.cloud.vision.v1.AnnotateImageRequest; import com.google.cloud.vision.v1.AnnotateImageResponse; import com.google.cloud.vision.v1.BatchAnnotateImagesResponse; import com.google.cloud.vision.v1.EntityAnnotation; import com.google.cloud.vision.v1.Feature; import com.google.cloud.vision.v1.Image; import com.google.cloud.vision.v1.ImageAnnotatorClient; import com.google.cloud.vision.v1.ImageSource; import java.io.IOException; import java.util.ArrayList; import java.util.List;  public class DetectLogosGcs {    public static void detectLogosGcs() throws IOException {     // TODO(developer): Replace these variables before running the sample.     String filePath = "gs://your-gcs-bucket/path/to/image/file.jpg";     detectLogosGcs(filePath);   }    // Detects logos in the specified remote image on Google Cloud Storage.   public static void detectLogosGcs(String gcsPath) throws IOException {     List<AnnotateImageRequest> requests = new ArrayList<>();      ImageSource imgSource = ImageSource.newBuilder().setGcsImageUri(gcsPath).build();     Image img = Image.newBuilder().setSource(imgSource).build();     Feature feat = Feature.newBuilder().setType(Feature.Type.LOGO_DETECTION).build();     AnnotateImageRequest request =         AnnotateImageRequest.newBuilder().addFeatures(feat).setImage(img).build();     requests.add(request);      // Initialize client that will be used to send requests. This client only needs to be created     // once, and can be reused for multiple requests. After completing all of your requests, call     // the "close" method on the client to safely clean up any remaining background resources.     try (ImageAnnotatorClient client = ImageAnnotatorClient.create()) {       BatchAnnotateImagesResponse response = client.batchAnnotateImages(requests);       List<AnnotateImageResponse> responses = response.getResponsesList();        for (AnnotateImageResponse res : responses) {         if (res.hasError()) {           System.out.format("Error: %s%n", res.getError().getMessage());           return;         }          // For full list of available annotations, see http://g.co/cloud/vision/docs         for (EntityAnnotation annotation : res.getLogoAnnotationsList()) {           System.out.println(annotation.getDescription());         }       }     }   } }

Node.js

试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Node.js 设置说明进行操作。 如需了解详情，请参阅 Vision Node.js API 参考文档。

如需向 Vision 进行身份验证，请设置应用默认凭证。如需了解详情，请参阅为本地开发环境设置身份验证。

// Imports the Google Cloud client libraries const vision = require('@google-cloud/vision');  // Creates a client const client = new vision.ImageAnnotatorClient();  /**  * TODO(developer): Uncomment the following lines before running the sample.  */ // const bucketName = 'Bucket where the file resides, e.g. my-bucket'; // const fileName = 'Path to file within bucket, e.g. path/to/image.png';  // Performs logo detection on the gcs file const [result] = await client.logoDetection(`gs://${bucketName}/${fileName}`); const logos = result.logoAnnotations; console.log('Logos:'); logos.forEach(logo => console.log(logo));

Python

试用此示例之前，请按照《Vision 快速入门：使用客户端库》中的 Python 设置说明进行操作。 如需了解详情，请参阅 Vision Python API 参考文档。

如需向 Vision 进行身份验证，请设置应用默认凭证。如需了解详情，请参阅为本地开发环境设置身份验证。

def detect_logos_uri(uri):     """Detects logos in the file located in Google Cloud Storage or on the Web."""     from google.cloud import vision      client = vision.ImageAnnotatorClient()     image = vision.Image()     image.source.image_uri = uri      response = client.logo_detection(image=image)     logos = response.logo_annotations     print("Logos:")      for logo in logos:         print(logo.description)      if response.error.message:         raise Exception(             "{}\nFor more info on error messages, check: "             "https://cloud.google.com/apis/design/errors".format(response.error.message)         )  

gcloud

如需执行图片属性检测操作，请使用 gcloud ml vision detect-logos 命令，如以下示例所示：

 gcloud ml vision detect-logos gs://cloud-samples-data/vision/logo/google_logo.jpg 

其他语言

C#： 请按照客户端库页面上的 C# 设置说明操作，然后访问 .NET 版 Vision 参考文档。

PHP： 请按照客户端库页面上的 PHP 设置说明操作，然后访问 PHP 版 Vision 参考文档。

Ruby 版： 请按照客户端库页面上的 Ruby 设置说明操作，然后访问 Ruby 版 Vision 参考文档。

试用

接下来，请尝试执行徽标检测。您可以使用已指定的图片 (gs://cloud-samples-data/vision/logo/google_logo.jpg) 或指定您自己的图片。选择执行即可发送请求。



请求正文：

{   "requests": [     {       "features": [         {           "type": "LOGO_DETECTION"         }       ],       "image": {         "source": {           "imageUri": "gs://cloud-samples-data/vision/logo/google_logo.jpg"         }       }     }   ] }