장소 사진으로 이전 (신규)

유럽 경제 지역 (EEA) 개발자

소개

Places API는 Place Photos (기존)를 지원합니다. 장소 사진 (기존)을 사용해 본 적이 있다면 장소 사진 (신규)에서는 다음과 같은 변경사항이 적용됩니다.

  • 장소 사진 (신규)에서는 사진 참조만 전달하는 대신 요청 URL에 장소 ID가 포함된 사진의 리소스 이름을 전달해야 합니다. 자세한 내용은 사진 참조 변경사항을 참고하세요.
  • 장소 사진 (신규)은 인증 메커니즘으로 API 키와 OAuth 토큰을 모두 지원합니다.

다음 표는 Place Photos (레거시)에서 Place Photos (신규)로 이름이 변경되거나 수정된 매개변수 또는 더 이상 지원되지 않는 매개변수를 나열합니다.

현재 매개변수 새 매개변수 참고
maxheight maxHeightPx maxHeightPx, maxWidthPx 또는 둘 다를 지정해야 합니다.
maxwidth maxWidthPx maxHeightPx, maxWidthPx 또는 둘 다를 지정해야 합니다.

사진 크기 증가

Place Photos (기존)는 최대 사진 크기가 1600x1600픽셀이었습니다. 장소 사진 (신규)은 최대 4800 x 4800픽셀 크기를 지원합니다.

사진 참조로 변경

장소 사진 (신규) API에서는 요청된 사진의 리소스 이름을 전달해야 합니다. 여기에는 장소 ID와 사진 참조가 다음 형식으로 포함됩니다.

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

근처 검색 (신규), 텍스트 검색 (신규), 장소 세부정보 (신규)는 모두 이 형식을 지원하는 응답에서 photos[] 배열을 반환합니다. 새 응답의 photos[]의 각 요소에는 다음 필드가 포함됩니다.

  • name - 사진의 리소스 이름을 포함하는 문자열입니다. 이 문자열의 형식은 다음과 같습니다.

    places/PLACE_ID/photos/PHOTO_REFERENCE
  • heightPx - 이미지의 최대 높이(픽셀)입니다.
  • widthPx - 이미지의 최대 너비(픽셀)입니다.
  • authorAttributions[] - 필요한 저작자 표시 이 필드는 항상 표시되지만 비어 있을 수 있습니다.

기존 API를 사용하면 다음 형식으로 사진 참조만 전달하면 됩니다.

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

장소 찾기 (기존), 주변 검색 (기존), 텍스트 검색 (기존), 장소 세부정보 (기존)는 모두 이 형식을 지원하는 응답에서 photos[] 배열을 반환합니다. 기존 응답의 각 photo 요소에는 다음 필드가 포함됩니다.

  • photo_reference - 사진 요청을 실행할 때 사진을 식별하는 데 사용되는 문자열입니다.
  • height - 이미지의 최대 높이입니다.
  • width - 이미지의 최대 너비입니다.
  • html_attributions[] - 필요한 저작자 표시 이 필드는 항상 표시되지만 비어 있을 수 있습니다.