对本地文件执行 Web 注释检测。
深入探索
如需查看包含此代码示例的详细文档,请参阅以下内容:
代码示例
Go
试用此示例之前,请按照《Vision 快速入门:使用客户端库》中的 Go 设置说明进行操作。如需了解详情,请参阅 Vision Go API 参考文档。
如需向 Vision 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
// detectWeb gets image properties from the Vision API for an image at the given file path.
func detectWeb(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
}
web, err := client.DetectWeb(ctx, image, nil)
if err != nil {
return err
}
fmt.Fprintln(w, "Web properties:")
if len(web.FullMatchingImages) != 0 {
fmt.Fprintln(w, "\tFull image matches:")
for _, full := range web.FullMatchingImages {
fmt.Fprintf(w, "\t\t%s\n", full.Url)
}
}
if len(web.PagesWithMatchingImages) != 0 {
fmt.Fprintln(w, "\tPages with this image:")
for _, page := range web.PagesWithMatchingImages {
fmt.Fprintf(w, "\t\t%s\n", page.Url)
}
}
if len(web.WebEntities) != 0 {
fmt.Fprintln(w, "\tEntities:")
fmt.Fprintln(w, "\t\tEntity\t\tScore\tDescription")
for _, entity := range web.WebEntities {
fmt.Fprintf(w, "\t\t%-14s\t%-2.4f\t%s\n", entity.EntityId, entity.Score, entity.Description)
}
}
if len(web.BestGuessLabels) != 0 {
fmt.Fprintln(w, "\tBest guess labels:")
for _, label := range web.BestGuessLabels {
fmt.Fprintf(w, "\t\t%s\n", label.Label)
}
}
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.Feature;
import com.google.cloud.vision.v1.Feature.Type;
import com.google.cloud.vision.v1.Image;
import com.google.cloud.vision.v1.ImageAnnotatorClient;
import com.google.cloud.vision.v1.WebDetection;
import com.google.cloud.vision.v1.WebDetection.WebEntity;
import com.google.cloud.vision.v1.WebDetection.WebImage;
import com.google.cloud.vision.v1.WebDetection.WebLabel;
import com.google.cloud.vision.v1.WebDetection.WebPage;
import com.google.protobuf.ByteString;
import java.io.FileInputStream;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
public class DetectWebDetections {
public static void detectWebDetections() throws IOException {
// TODO(developer): Replace these variables before running the sample.
String filePath = "path/to/your/image/file.jpg";
detectWebDetections(filePath);
}
// Finds references to the specified image on the web.
public static void detectWebDetections(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(Type.WEB_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;
}
// Search the web for usages of the image. You could use these signals later
// for user input moderation or linking external references.
// For a full list of available annotations, see http://g.co/cloud/vision/docs
WebDetection annotation = res.getWebDetection();
System.out.println("Entity:Id:Score");
System.out.println("===============");
for (WebEntity entity : annotation.getWebEntitiesList()) {
System.out.println(
entity.getDescription() + " : " + entity.getEntityId() + " : " + entity.getScore());
}
for (WebLabel label : annotation.getBestGuessLabelsList()) {
System.out.format("%nBest guess label: %s", label.getLabel());
}
System.out.println("%nPages with matching images: Score%n==");
for (WebPage page : annotation.getPagesWithMatchingImagesList()) {
System.out.println(page.getUrl() + " : " + page.getScore());
}
System.out.println("%nPages with partially matching images: Score%n==");
for (WebImage image : annotation.getPartialMatchingImagesList()) {
System.out.println(image.getUrl() + " : " + image.getScore());
}
System.out.println("%nPages with fully matching images: Score%n==");
for (WebImage image : annotation.getFullMatchingImagesList()) {
System.out.println(image.getUrl() + " : " + image.getScore());
}
System.out.println("%nPages with visually similar images: Score%n==");
for (WebImage image : annotation.getVisuallySimilarImagesList()) {
System.out.println(image.getUrl() + " : " + image.getScore());
}
}
}
}
}
Node.js
试用此示例之前,请按照《Vision 快速入门:使用客户端库》中的 Node.js 设置说明进行操作。如需了解详情,请参阅 Vision Node.js API 参考文档。
如需向 Vision 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
// Imports the Google Cloud client library
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';
// Detect similar images on the web to a local file
const [result] = await client.webDetection(fileName);
const webDetection = result.webDetection;
if (webDetection.fullMatchingImages.length) {
console.log(
`Full matches found: ${webDetection.fullMatchingImages.length}`
);
webDetection.fullMatchingImages.forEach(image => {
console.log(` URL: ${image.url}`);
console.log(` Score: ${image.score}`);
});
}
if (webDetection.partialMatchingImages.length) {
console.log(
`Partial matches found: ${webDetection.partialMatchingImages.length}`
);
webDetection.partialMatchingImages.forEach(image => {
console.log(` URL: ${image.url}`);
console.log(` Score: ${image.score}`);
});
}
if (webDetection.webEntities.length) {
console.log(`Web entities found: ${webDetection.webEntities.length}`);
webDetection.webEntities.forEach(webEntity => {
console.log(` Description: ${webEntity.description}`);
console.log(` Score: ${webEntity.score}`);
});
}
if (webDetection.bestGuessLabels.length) {
console.log(
`Best guess labels found: ${webDetection.bestGuessLabels.length}`
);
webDetection.bestGuessLabels.forEach(label => {
console.log(` Label: ${label.label}`);
});
}
PHP
试用此示例之前,请按照《Vision 快速入门:使用客户端库》中的 PHP 设置说明进行操作。如需了解详情,请参阅 Vision PHP API 参考文档。
如需向 Vision 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
namespace Google\Cloud\Samples\Vision;
use Google\Cloud\Vision\V1\ImageAnnotatorClient;
/**
* @param string $path Path to the image, e.g. "path/to/your/image.jpg"
*/
function detect_web(string $path)
{
$imageAnnotator = new ImageAnnotatorClient();
# annotate the image
$image = file_get_contents($path);
$response = $imageAnnotator->webDetection($image);
$web = $response->getWebDetection();
// Print best guess labels
printf('%d best guess labels found' . PHP_EOL,
count($web->getBestGuessLabels()));
foreach ($web->getBestGuessLabels() as $label) {
printf('Best guess label: %s' . PHP_EOL, $label->getLabel());
}
print(PHP_EOL);
// Print pages with matching images
printf('%d pages with matching images found' . PHP_EOL,
count($web->getPagesWithMatchingImages()));
foreach ($web->getPagesWithMatchingImages() as $page) {
printf('URL: %s' . PHP_EOL, $page->getUrl());
}
print(PHP_EOL);
// Print full matching images
printf('%d full matching images found' . PHP_EOL,
count($web->getFullMatchingImages()));
foreach ($web->getFullMatchingImages() as $fullMatchingImage) {
printf('URL: %s' . PHP_EOL, $fullMatchingImage->getUrl());
}
print(PHP_EOL);
// Print partial matching images
printf('%d partial matching images found' . PHP_EOL,
count($web->getPartialMatchingImages()));
foreach ($web->getPartialMatchingImages() as $partialMatchingImage) {
printf('URL: %s' . PHP_EOL, $partialMatchingImage->getUrl());
}
print(PHP_EOL);
// Print visually similar images
printf('%d visually similar images found' . PHP_EOL,
count($web->getVisuallySimilarImages()));
foreach ($web->getVisuallySimilarImages() as $visuallySimilarImage) {
printf('URL: %s' . PHP_EOL, $visuallySimilarImage->getUrl());
}
print(PHP_EOL);
// Print web entities
printf('%d web entities found' . PHP_EOL,
count($web->getWebEntities()));
foreach ($web->getWebEntities() as $entity) {
printf('Description: %s, Score %s' . PHP_EOL,
$entity->getDescription(),
$entity->getScore());
}
$imageAnnotator->close();
}
Python
试用此示例之前,请按照《Vision 快速入门:使用客户端库》中的 Python 设置说明进行操作。如需了解详情,请参阅 Vision Python API 参考文档。
如需向 Vision 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
def detect_web(path):
"""Detects web annotations given an image."""
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.web_detection(image=image)
annotations = response.web_detection
if annotations.best_guess_labels:
for label in annotations.best_guess_labels:
print(f"\nBest guess label: {label.label}")
if annotations.pages_with_matching_images:
print(
"\n{} Pages with matching images found:".format(
len(annotations.pages_with_matching_images)
)
)
for page in annotations.pages_with_matching_images:
print(f"\n\tPage url : {page.url}")
if page.full_matching_images:
print(
"\t{} Full Matches found: ".format(len(page.full_matching_images))
)
for image in page.full_matching_images:
print(f"\t\tImage url : {image.url}")
if page.partial_matching_images:
print(
"\t{} Partial Matches found: ".format(
len(page.partial_matching_images)
)
)
for image in page.partial_matching_images:
print(f"\t\tImage url : {image.url}")
if annotations.web_entities:
print("\n{} Web entities found: ".format(len(annotations.web_entities)))
for entity in annotations.web_entities:
print(f"\n\tScore : {entity.score}")
print(f"\tDescription: {entity.description}")
if annotations.visually_similar_images:
print(
"\n{} visually similar images found:\n".format(
len(annotations.visually_similar_images)
)
)
for image in annotations.visually_similar_images:
print(f"\tImage url : {image.url}")
if response.error.message:
raise Exception(
"{}\nFor more info on error messages, check: "
"https://cloud.google.com/apis/design/errors".format(response.error.message)
)
后续步骤
如需搜索和过滤其他 Google Cloud 产品的代码示例,请参阅 Google Cloud 示例浏览器。