xwMOOC 고생대 프로젝트

구글 클라우드 비젼 설치 및 헬로우 월드

학습 목표

구글 클라우드 비젼 API를 설치한다.
헬로우 월드를 찍어본다.

구글 클라우드 비젼 API 인증 준비

실시간 영상처리는 차치하고 정적 이미지를 인식하고 처리하는데 구글 클라우드 비젼 API를 통해 일단 감을 잡는 것이 진지한 영상처리를 검토하기 전에 필요합니다.

대부분 구글 클라우드 계정은 생성(없는 경우 하나 생성)되었으니 생략하고, Google Cloud Platform Project Page로 가서 새로운 이름을 갖는 프로젝트 페이지를 생성한다.
- 현재 시점 국내 클라우드 제공업체는 아마존 AWS, 마이크로소프트 Azure, IBM Softlayer 등 많은 업체가 다양한 서비스를 뿜어내고 있고, 구글의 구글 Google Cloud Platform도 동일한 클라우드 시장에서 각축을 벌이고 있다.
구글 클라우드 비젼 API(이하 구글 비젼 API )는 초창기 무료에서 이제는 유료 비즈니스 모델을 추구하기 때문에 사진을 던져넣고 사진에 어떤 정보가 있는지 알아 보려면 일정 댓가를 지불해야 한다. 따라서 빌링 카드 정보를 등록한다.
- 클라우드 제공업체의 경우 거의 대부분이 신용카드 등록을 요구한다. 물론 첫 30 ~ 60일은 무료, 그 이후로 과금을 한다.
- 구글 비젼 API 가격정보를 통해 월 1,000장까지는 무료, 1,000,000 장까지는 1,000 장당 $2.5 ~ $5 달러를 과금을 한다고 하니 사전에 면밀히 검토하고 적절히 활용하기 바란다.
구글 비젼 API 사용자를 인증해주는 크리덴셜(Credentail) 인증서를 발급받는다.
- 인증서는 무척 중요한 것으로 이를 분실할 경우 엄청난 요금청구를 받을 수 있다.
  - Google Cloud Platform → Billing → Budgets & alerts 메뉴로 가서 한도 설정 및 경고를 받을 수 있도록 사전에 설정한다. 이를 통해 해킹등이 발생할 경우 초동대처가 가능하다.
- Google Cloud Platform → API Manager → Overview 메뉴로 가서 enable 해서 구글 비젼을 활성화시킨다.
- Google Cloud Platform → API Manager → Credentials 메뉴로 가서 Credentials → Create credentials → Service account key 를 통해 파이썬 응용프로그램이 구글 비전 컴퓨터와 상호 인증하도록 만든다.
- 인증서는 아스키 파일로 된 정보로 .json 파일로 다운로드 받아 안전하게 디렉토리에 저장시킨다.
  - 임의 파일명을 지정한다. 예를 들어, gcv-credential.json
저장한 인증서를 경로명에 추가시킨다.
- 반복해서 사용할 경우 .bashrc 파일에 환경변수로 추가시킨다.
  - export GOOGLE_APPLICATION_CREDENTIALS=/home/vagrant/gcv-credential.json
- source .bashrc 명령라인 콘솔에서 지정하면 끝.

파이썬 응용프로그램 클라이언트 준비

.json 인증서를 다운로드 받아 이미지 인식 및 처리를 할 컴퓨터에 환경설정을 사실 시작한 것이다. 이제 본격적으로 이를 시작해 나가보자.

앞서 Google Cloud Platform Project Page로 가서 새로운 이름을 갖는 프로젝트 페이지를 생성했다.
또한, 구글 비젼 API 사용자를 인증해주는 크리덴셜(Credentail) 인증서를 발급받았다.
구글 비젼 API를 사용할 언어를 정하고 설치한다.
- 파이썬, NODE.JS, 자바, 고(GO)를 지원한다.
파이썬 pip 를 설치한다.
- wget https://bootstrap.pypa.io/get-pip.py
- sudo python get-pip.py
구글 API 파이썬 클라이언트를 설치한다.
- sudo pip install --upgrade google-api-python-client
파이썬 이미지 라이브러리 Pillow를 설치한다.
- sudo pip install Pillow
- 만약 오류가 나면, sudo apt-get install python-dev 명령어를 실행하고 Pillow를 설치한다.

헬로우 월드 파이썬 프로그램 실행 ¹

argparse 라이브러리로 이미지를 입력받아, 구글 비젼 API 인증서를 통해 파이썬 응용프로그램을 인증받아 불러온 이미지 정보를 base64으로 인코딩해 구글 비젼 API를 통해 전달한 후에 결과 값을 받아 이미지에 어떤 것이 들어있는지 출력하는 프로그램이다.

구글 비젼 API 표식

"""
This script uses the Vision API's label detection capabilities to find a label
based on an image's content.

To run the example, install the necessary libraries by running:

    pip install -r requirements.txt

Run the script on an image to get a label, E.g.:

    ./label.py <path-to-image>
"""

import argparse
import base64
import httplib2

from googleapiclient import discovery
from oauth2client.client import GoogleCredentials

DISCOVERY_URL='https://{api}.googleapis.com/$discovery/rest?version={apiVersion}'


def main(photo_file):
    """Run a label request on a single image"""

    credentials = GoogleCredentials.get_application_default()
    service = discovery.build('vision', 'v1', credentials=credentials,
                              discoveryServiceUrl=DISCOVERY_URL)

    with open(photo_file, 'rb') as image:
        image_content = base64.b64encode(image.read())
        service_request = service.images().annotate(body={
            'requests': [{
                'image': {
                    'content': image_content.decode('UTF-8')
                },
                'features': [{
                    'type': 'LABEL_DETECTION',
                    'maxResults': 1
                }]
            }]
        })
        response = service_request.execute()
        label = response['responses'][0]['labelAnnotations'][0]['description']
        print('Found label: %s for %s' % (label, photo_file))
        return 0

if __name__ == '__main__':
    parser = argparse.ArgumentParser()
    parser.add_argument('image_file', help='The image you\'d like to label.')
    args = parser.parse_args()
    main(args.image_file)

헬로우 월드 실행

python label.py ../images/wagon.jpg 의 경우 wagon.jpg 파일을 인자로 넘기면 label.py 파이썬 프로그래밍 이를 구글 비젼 API를 통해 전달하고 결과를 출력한다.

$ python label.py ../images/wagon.jpg
Found label: horse and buggy for ../images/wagon.jpg

$ python label.py ../images/pororo.jpg
Found label: cartoon for ../images/pororo.jpg

$ python label.py ../images/trilobite.jpg
Found label: fossil for ../images/trilobite.jpg

실행결과 첫번째 사진은 말과 사륜차(horse and buggy), 두번째 사진은 만화(cartoon), 세번째 사진은 화석(fossil) 결과를 반환하고 있다.

wagon.jpg	pororo.jpg	trilobite.jpg

horse and buggy	cartoon	fossil

Label Detection Tutorial ↩