모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Places API Web Service 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Places API Web Service 활성화
  3. 적합한 키 생성
계속

장소 사진

장소 사진 서비스는 Google Places API Web Service의 일부로, 고품질의 사진 콘텐츠를 애플리케이션에 추가할 수 있도록 해주는 읽기 전용 API입니다. 장소 사진 서비스를 사용하면 장소 및 Google+ 로컬 데이터베이스에 저장된 수백만 개의 사진에 액세스할 수 있습니다. 장소 검색이나 장소 세부정보 요청을 통해 장소를 검색하면, 관련 사진 콘텐츠에 대해 사진 참조가 반환됩니다. 주변 검색 및 텍스트 검색 요청 또한 장소별로 단일 사진 참조를 반환합니다(연관된 경우). 사진 서비스를 사용하면 참조 사진에 액세스하고 애플리케이션에 맞게 최적의 크기로 이미지를 조정할 수 있습니다.

사진 참조

장소 사진 서비스에 대한 모든 요청은 photoreference를 포함해야 하며, 이는 주변 검색, 텍스트 검색 또는 장소 세부정보 요청의 응답으로 반환됩니다. 장소에 관련 사진 콘텐츠가 있는 경우 각 요청에 대한 응답에는 photos[] 필드가 포함됩니다.

참고: 반환되는 사진 수는 요청에 따라 다릅니다.

  • 주변 검색이나 텍스트 검색은 배열에서 1개의 photo 요소만 반환합니다.
  • 레이더 검색은 사진 정보를 반환하지 않습니다.
  • 세부정보 요청은 최대 10개의 photo 요소를 반환합니다.

photo 요소는 다음 필드를 포함합니다.

  • photo_reference — 사진 요청 수행 시 사진 식별에 사용되는 문자열.
  • height — 이미지의 최대 높이.
  • width — 이미지의 최대 너비.
  • html_attributions[] — 모든 필수 속성을 포함합니다. 이 필드는 항상 존재하지만 비어있는 경우도 있습니다.

사진 서비스에서 반환되는 사진은 사업체 소유자와 Google+ 사용자가 제공한 사진을 비롯하여 다양한 위치에서 제공받고 있습니다. 대부분의 경우 이러한 사진은 특성 없이 사용할 수 있거나 필수 특성이 이미지의 일부로 포함됩니다. 그러나 반환된 photo 요소에 html_attributions 필드의 값이 포함된 경우에는, 이미지를 표시할 때마다 애플리케이션에 추가 특성을 포함해야 합니다.

photos[] 배열의 예는 아래와 같습니다.

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
   }
...

장소 사진 요청

장소 사진 요청은 다음 형식의 HTTP URL입니다.

https://maps.googleapis.com/maps/api/place/photo?parameters

검색 요청을 시작하기 위해서는 특정 매개변수가 필요합니다. URL 표준 형식과 마찬가지로, 모든 매개변수는 앰퍼샌드(&) 문자를 사용하여 구분합니다. 매개변수 및 가능한 값 목록은 아래와 같습니다.

필수 매개변수

  • key — 애플리케이션의 API 키. 이 키는 할당량 관리를 위해 애플리케이션을 식별합니다. 자세한 내용은 키 가져오기를 참조하세요.
  • photoreference — 사진을 고유하게 식별하는 문자열 식별자. 사진 참조는 장소 검색또는 장소 세부정보 요청 중 하나에서 반환됩니다.
  • maxheight 또는 maxwidth — 장소 사진 서비스에 의해 반환되는 이미지의 최대 높이 및 너비를 원하는 대로 지정합니다(단위: 픽셀). 지정한 값보다 이미지가 작은 경우 원본 이미지가 반환됩니다. 이미지의 높이 또는 너비 중 하나가 더 큰 경우에는 원래의 가로세로 비율을 유지한 채로 작은 항목에 맞게 크기가 조정됩니다. maxheightmaxwidth 속성 모두 1부터 1600 사이의 정수가 허용됩니다.

아래는 예시 요청입니다. 이 요청은 참조된 이미지를 반환하고, 너비가 400픽셀이 되도록 이미지의 크기를 조정합니다.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY

참고: 애플리케이션에서 요청이 작동하도록 하려면 이 예시에서 API 키를 대체해야 합니다.

장소 사진 응답

성공적인 장소 사진 요청에 대한 응답은 이미지입니다. 이미지 유형은 원래 제출한 사진 유형에 따라 다릅니다.

요청이 사용 가능 할당량을 초과하는 경우 서버에서 HTTP 403 상태를 반환하고, 아래의 이미지를 표시하여 할당량이 초과되었음을 나타냅니다.

Over Quota image

서버에서 요청을 인식할 수 없는 경우에는 요청이 잘못되었음을 나타내는 HTTP 400 상태를 반환합니다. 잘못된 요청이 발생하는 가장 일반적인 이유는 다음과 같습니다.

  • 제출한 사진 참조가 잘못 지정된 경우.
  • 요청에 maxwidth 또는 maxheight 매개변수가 없는 경우.

오류 메시지

장소 서비스가 HTTP 400 상태를 반환하면 응답 객체에 추가 error_message 필드가 있을 수 있습니다. 이 필드에는 상태 코드가 제시된 이유에 대한 상세정보가 포함됩니다.

sensor 매개변수

이전의 Google Places API Web Service는 사용자 위치 파악을 위해 애플리케이션의 센서 사용 여부를 표시하는 sensorsensor 매개변수를 포함하도록 요구했습니다. 이 매개변수는 더 이상 필요하지 않습니다.

다음에 대한 의견 보내기...

location_on
Google Places API Web Service