网络检测教程

受众

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

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

前提条件

• 在 Google Cloud Console 中设置 Vision API 项目。

• 设置您的环境以便使用应用默认凭据。

Python

• 安装 Python。
• 安装 pip。
• 安装 Google Cloud 客户端库。

概览

本教程介绍了一个使用 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 服务已准备就绪，我们可以构建要发送至该服务的请求。

此代码段执行以下任务：

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

输出响应

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 检测！