快速入门：使用必应视觉搜索 REST API 和 Java 获取图像见解

项目
05/22/2020

警告

2020 年 10 月 30 日，必应搜索 API 从 Azure AI 服务迁移到必应搜索服务。本文档仅供参考。有关更新的文档，请参阅必应搜索 API 文档。关于为必应搜索创建新的 Azure 资源的说明，请参阅通过 Azure 市场创建必应搜索资源。

根据此快速入门中的说明对必应视觉搜索 API 进行第一次调用。此 Java 应用程序会将一个图像上传到该 API，并显示它返回的信息。虽然此应用程序是使用 Java 编写的，但 API 是一种 RESTful Web 服务，与大多数编程语言兼容。

先决条件

创建 Azure 资源

通过创建以下 Azure 资源之一开始使用必应视觉搜索 API：

必应搜索 v7 资源

在删除资源前，可通过 Azure 门户使用。
选择 S9 定价层。

多服务资源

在删除资源前，可通过 Azure 门户使用。
在多个 Azure AI 服务中对应用程序使用相同的密钥和终结点。

创建并初始化项目

在你最喜欢的 IDE 或编辑器中新建一个 Java 项目，并导入以下库：

import java.util.*;
import java.io.*;
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;

// HttpClient libraries

import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClientBuilder;

为 API 终结点、订阅密钥和图像路径创建变量。对于 endpoint 值，可以使用以下代码中的全局终结点，或者使用资源的 Azure 门户中显示的自定义子域终结点。
```
static String endpoint = "https://api.cognitive.microsoft.com/bing/v7.0/images/visualsearch";
static String subscriptionKey = "your-key-here";
static String imagePath = "path-to-your-image";
```
上传本地图像时，表单数据必须包含 Content-Disposition 标头。将其 name 参数设置为“image”，并且将 filename 参数设置为映像的文件名。表单内容包括图像的二进制数据。可以上传的最大图像大小为 1 MB。
```
--boundary_1234-abcd
Content-Disposition: form-data; name="image"; filename="myimagefile.jpg"

ÿØÿà JFIF ÖÆ68g-¤CWŸþ29ÌÄøÖ‘º«™æ±èuZiÀ)"óÓß°Î= ØJ9á+*G¦...

--boundary_1234-abcd--
```

创建 JSON 分析程序

使用 JsonParser 创建一个方法，使 API 的 JSON 响应更具可读性。

public static String prettify(String json_text) {
        JsonParser parser = new JsonParser();
        JsonObject json = parser.parse(json_text).getAsJsonObject();
        Gson gson = new GsonBuilder().setPrettyPrinting().create();
        return gson.toJson(json);
    }

构造搜索请求和查询

在应用程序的主方法中，使用 HttpClientBuilder.create().build(); 创建 HTTP 客户端。
```
CloseableHttpClient httpClient = HttpClientBuilder.create().build();
```

创建 HttpEntity 对象，将图像上传到 API。

HttpEntity entity = MultipartEntityBuilder
    .create()
    .addBinaryBody("image", new File(imagePath))
    .build();

使用终结点创建 httpPost 对象，并将标头设置为使用订阅密钥。

HttpPost httpPost = new HttpPost(endpoint);
httpPost.setHeader("Ocp-Apim-Subscription-Key", subscriptionKey);
httpPost.setEntity(entity);

接收和处理 JSON 响应

使用 HttpClient.execute() 方法向 API 发送请求，并将响应存储在 InputStream 对象中。

HttpResponse response = httpClient.execute(httpPost);
InputStream stream = response.getEntity().getContent();

存储 JSON 字符串，并输出响应。

String json = new Scanner(stream).useDelimiter("\\A").next();
System.out.println("\nJSON Response:\n");
System.out.println(prettify(json));

后续步骤

构建视觉搜索单页 Web 应用