빠른 시작: Bing Visual Search REST API 및 Java를 사용하여 이미지 인사이트 가져오기

아티클
05/22/2020

경고

2020년 10월 30일에 Bing Search API가 Azure AI 서비스에서 Bing Search Services로 이동되었습니다. 이 문서는 참조용으로만 제공됩니다. 업데이트된 문서는 Bing search API 문서를 참조하세요. Bing 검색을 위한 새 Azure 리소스 만들기에 대한 지침은 Azure Marketplace를 통해 Bing Search 리소스 만들기를 참조하세요.

이 빠른 시작을 사용하여 Bing Visual Search API에 대한 첫 번째 호출을 수행할 수 있습니다. 이 Java 애플리케이션은 API에 이미지를 업로드하고 API에서 반환되는 정보를 표시합니다. 이 애플리케이션은 Java로 작성되었지만, API는 대부분의 프로그래밍 언어와 호환되는 RESTful 웹 서비스입니다.

사전 요구 사항

Azure 리소스 만들기

다음 Azure 리소스 중 하나를 만들어 Bing Visual Search API 사용을 시작합니다.

Bing Search v7 리소스

리소스를 삭제할 때까지 Azure Portal을 통해 사용할 수 있습니다.
S9 가격 책정 계층을 선택합니다.

다중 서비스 리소스

리소스를 삭제할 때까지 Azure Portal을 통해 사용할 수 있습니다.
여러 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 Portal에 표시되는 사용자 지정 하위 도메인 엔드포인트를 사용할 수 있습니다.
```
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 매개 변수를 "이미지"로 설정하고 filename 매개 변수를 이미지의 파일 이름으로 설정합니다. 양식의 콘텐츠는 이미지의 이진 데이터를 포함합니다. 업로드할 수 있는 최대 이미지 크기는 1MB입니다.
```
--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();
```

API에 이미지를 업로드하는 HttpEntity 개체를 만듭니다.

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));

다음 단계

Visual Search 단일 페이지 웹앱 빌드

Share via