网络检测教程

受众

本教程旨在帮助您开发具有 Vision API Web 检测功能的应用。本教程假定您熟悉基本的编程结构和技术，不过，即使您是初级程序员，也应该能够毫不费力地根据本教程进行操作，然后按照 Vision API 参考文档的说明创建基本应用。

本教程将逐步介绍一个 Vision API 应用，展示如何通过调用 Vision API 来使用其 Web 检测功能。

前提条件

在 Google Cloud 控制台中设置 Vision API 项目。
设置您的环境以便使用应用默认凭据。

Python

概览

本教程介绍了一个使用 Web detection 请求的基本 Vision API 应用。Web detection 响应使用以下各项对请求中发送的图片进行注释：

从 Web 获取的标签
具有匹配图片的网站网址
与请求中的图片部分匹配或完全匹配的网络图片的网址
视觉上相似的图片的网址

代码清单

我们建议您在阅读代码时参照 Vision API Python 参考文档以便理解。

import argparse

from google.cloud import vision



def annotate(path: str) -> vision.WebDetection:
    """Returns web annotations given the path to an image.

    Args:
        path: path to the input image.

    Returns:
        An WebDetection object with relevant information of the
        image from the internet (i.e., the annotations).
    """
    client = vision.ImageAnnotatorClient()

    if path.startswith("http") or path.startswith("gs:"):
        image = vision.Image()
        image.source.image_uri = path

    else:
        with open(path, "rb") as image_file:
            content = image_file.read()

        image = vision.Image(content=content)

    web_detection = client.web_detection(image=image).web_detection

    return web_detection


def report(annotations: vision.WebDetection) -> None:
    """Prints detected features in the provided web annotations.

    Args:
        annotations: The web annotations (WebDetection object) from which
        the features should be parsed and printed.
    """
    if annotations.pages_with_matching_images:
        print(
            f"\n{len(annotations.pages_with_matching_images)} Pages with matching images retrieved"
        )

        for page in annotations.pages_with_matching_images:
            print(f"Url   : {page.url}")

    if annotations.full_matching_images:
        print(f"\n{len(annotations.full_matching_images)} Full Matches found: ")

        for image in annotations.full_matching_images:
            print(f"Url  : {image.url}")

    if annotations.partial_matching_images:
        print(f"\n{len(annotations.partial_matching_images)} Partial Matches found: ")

        for image in annotations.partial_matching_images:
            print(f"Url  : {image.url}")

    if annotations.web_entities:
        print(f"\n{len(annotations.web_entities)} Web entities found: ")

        for entity in annotations.web_entities:
            print(f"Score      : {entity.score}")
            print(f"Description: {entity.description}")


if __name__ == "__main__":
    parser = argparse.ArgumentParser(
        description=__doc__,
        formatter_class=argparse.RawDescriptionHelpFormatter,
    )
    path_help = str(
        "The image to detect, can be web URI, "
        "Google Cloud Storage, or path to local file."
    )
    parser.add_argument("image_url", help=path_help)
    args = parser.parse_args()

    report(annotate(args.image_url))

此简单应用执行以下任务：

导入运行应用所需的库
将图片路径作为参数传递给 main() 函数
使用 Google Cloud API 客户端执行 Web 检测
循环执行响应并输出结果
输出具有说明和分数的网络实体的列表
输出匹配页面的列表
输出部分匹配的图片的列表
输出完全匹配的图片的列表

深入了解

导入库

import argparse

from google.cloud import vision

导入标准库：

argparse：允许应用接受输入文件名作为参数
io：从文件读取内容

其他导入：

google.cloud.vision 库中的 ImageAnnotatorClient 类，用于访问 Vision API。
google.cloud.vision 库中的 types 模块，用于构建请求。

运行应用

parser = argparse.ArgumentParser(
    description=__doc__,
    formatter_class=argparse.RawDescriptionHelpFormatter,
)
path_help = str(
    "The image to detect, can be web URI, "
    "Google Cloud Storage, or path to local file."
)
parser.add_argument("image_url", help=path_help)
args = parser.parse_args()

report(annotate(args.image_url))

这里，我们仅解析用于指定 Web 图片网址的传入参数，并将其传递给 main() 函数。

向 API 进行身份验证

您必须先使用先前获得的凭据向 Vision API 服务进行身份验证，然后才能与该服务通信。在应用中，获取凭据的最简单方法是使用应用默认凭据 (ADC)。客户端库会自动获取凭据。默认情况下，此操作通过从 GOOGLE_APPLICATION_CREDENTIALS 环境变量获取凭据来完成，该变量应设置为指向您的服务账号的 JSON 密钥文件（如需了解详情，请参阅设置服务账号）。

构建请求

client = vision.ImageAnnotatorClient()

if path.startswith("http") or path.startswith("gs:"):
    image = vision.Image()
    image.source.image_uri = path

else:
    with open(path, "rb") as image_file:
        content = image_file.read()

    image = vision.Image(content=content)

web_detection = client.web_detection(image=image).web_detection

现在，Vision API 服务已准备就绪，我们可以构建要发送至该服务的请求。

此代码段执行以下任务：

创建 ImageAnnotatorClient 实例作为客户端。
通过本地文件或 URI 构建 Image 对象。
将 Image 对象传递给客户端的 web_detection 方法。
返回注释。

输出响应

if annotations.pages_with_matching_images:
    print(
        f"\n{len(annotations.pages_with_matching_images)} Pages with matching images retrieved"
    )

    for page in annotations.pages_with_matching_images:
        print(f"Url   : {page.url}")

if annotations.full_matching_images:
    print(f"\n{len(annotations.full_matching_images)} Full Matches found: ")

    for image in annotations.full_matching_images:
        print(f"Url  : {image.url}")

if annotations.partial_matching_images:
    print(f"\n{len(annotations.partial_matching_images)} Partial Matches found: ")

    for image in annotations.partial_matching_images:
        print(f"Url  : {image.url}")

if annotations.web_entities:
    print(f"\n{len(annotations.web_entities)} Web entities found: ")

    for entity in annotations.web_entities:
        print(f"Score      : {entity.score}")
        print(f"Description: {entity.description}")

操作完成后，我们可以浏览 WebDetection，并输出注释中包含的实体和网址（每种注释类型的前两条结果将在下一部分展示）。

运行应用

要运行该应用，我们将传入以下汽车图片的网址 (http://www.photos-public-domain.com/wp-content/uploads/2011/01/old-vw-bug-and-van.jpg)。

以下是包含所传入汽车图片网址的 Python 命令，后跟控制台输出。请注意，所列实体后添加了相关性分数。另请注意，这些分数未标准化，在不同图片查询之间也不具有可比性。

python web_detect.py "http://www.photos-public-domain.com/wp-content/uploads/2011/01/old-vw-bug-and-van.jpg"

5 Pages with matching images retrieved
Url   : http://www.photos-public-domain.com/2011/01/07/old-volkswagen-bug-and-van/
Url   : http://pix-hd.com/old+volkswagen+van+for+sale
...

2 Full Matches found:
Url  : http://www.photos-public-domain.com/wp-content/uploads/2011/01/old-vw-bug-and-van.jpg
Url  : http://www.wbwagen.com/media/old-volkswagen-bug-and-van-picture-free-photograph-photos-public_s_66f487042adad5a6.jpg

4 Partial Matches found:
Url  : http://www.photos-public-domain.com/wp-content/uploads/2011/01/old-vw-bug-and-van.jpg
Url  : http://www.wbwagen.com/media/old-vw-bug-and-vanjpg_s_ac343d7f041b5f8d.jpg
...

5 Web entities found:
Score      : 5.35028934479
Description: Volkswagen Beetle
Score      : 1.43998003006
Description: Volkswagen
Score      : 0.828279972076
Description: Volkswagen Type 2
Score      : 0.75271999836
Description: Van
Score      : 0.690039992332
Description: Car

正如预期的那样，Cloud Vision Web 检测功能检测到了我们作为输入传递给应用的 Web 图片网址，并在 fullMatchingImages 下返回了该网址（上面列出的最后一个网址）。

恭喜！您已使用 Vision API 执行 Web 检测！