Python 클라이언트 라이브러리 v0.25.1로 이전

Python v0.25.1용 클라이언트 라이브러리에는 이전 클라이언트 라이브러리의 설계 방법에 대한 몇 가지 중요한 변경사항이 포함되어 있습니다. 이러한 변경사항은 다음과 같습니다.

더 적은 수의 유형으로 모듈 통합
유형화되지 않은 매개변수를 강력한 유형의 클래스 및 열거로 교체

이 주제에서는 v0.25.1 Python 클라이언트 라이브러리를 사용하기 위해 Cloud Vision API 클라이언트 라이브러리와 관련된 Python 코드를 어떻게 변경해야 하는지 자세히 설명합니다.

이전 버전의 클라이언트 라이브러리 실행

Python 클라이언트 라이브러리를 v0.25.1로 반드시 업그레이드할 필요는 없습니다. 이전 버전의 Python 클라이언트 라이브러리를 계속 사용하고 코드를 마이그레이션하지 않으려면 앱에서 사용되는 Python 클라이언트 라이브러리 버전을 지정해야 합니다. 특정 라이브러리 버전을 지정하려면 requirements.txt 파일을 다음과 같이 편집합니다.

google-cloud-vision==0.25

삭제된 모듈

다음 모듈은 Python 클라이언트 라이브러리 v0.25.1 패키지에서 삭제되었습니다.

google.cloud.vision.annotations
google.cloud.vision.batch
google.cloud.vision.client
google.cloud.vision.color
google.cloud.vision.crop_hint
google.cloud.vision.entity
google.cloud.vision.face
google.cloud.vision.feature
google.cloud.vision.geometry
google.cloud.vision.image
google.cloud.vision.likelihood
google.cloud.vision.safe_search
google.cloud.vision.text
google.cloud.vision.web

필수 코드 변경

가져오기

Python 클라이언트 라이브러리 v0.25.1의 새로운 유형에 액세스하려면 새로운 google.cloud.vision.types 모듈을 포함합니다.

types 모듈에는 요청 생성에 필요한 새로운 클래스(예: types.Image)가 포함되어 있습니다.

from google.cloud import vision

또한 새로운 google.cloud.vision.enums 모듈에는 enums.Likelihood.UNLIKELY 및 enums.FaceAnnotation.Landmark.Type.LEFT_EYE와 같은 API 응답을 파싱하고 이해하는 데 유용한 열거형이 포함되어 있습니다.

클라이언트 만들기

Client 클래스가 ImageAnnotatorClient 클래스로 대체되었습니다. Client 클래스에 대한 참조를 ImageAnnotatorClient로 대체하세요.

이전 버전의 클라이언트 라이브러리:

old_client = vision.Client()

Python 클라이언트 라이브러리 v0.25.1:

client = vision.ImageAnnotatorClient()

이미지 콘텐츠를 나타내는 객체 생성

로컬 파일, Google Cloud Storage URI, 웹 URI에서 이미지 콘텐츠를 식별하려면 새로운 Image 클래스를 사용합니다.

로컬 파일의 이미지 콘텐츠를 나타내는 객체 구성

다음 예에서는 로컬 파일의 이미지 콘텐츠를 나타내는 새로운 방법을 보여줍니다.