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

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

소개

Places API는 장소 사진 (기존)을 지원합니다. 장소 사진 (기존)에 익숙한 경우 장소 사진 (신규) 에서 다음과 같은 변경사항이 적용됩니다.

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

다음 표에는 장소 사진 (신규)을 위해 이름이 변경되거나 수정된 장소 사진 (기존)의 매개변수 또는 더 이상 지원되지 않는 매개변수가 나와 있습니다.

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

사진 크기 증가

장소 사진 (기존)은 최대 사진 크기 1600x1600픽셀을 지원했습니다. 장소 사진 (신규)은 최대 4800x4800픽셀 크기를 지원합니다.

사진 참조 변경사항

장소 사진 (신규) 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[] — 필요한 저작자 표시입니다. 이 필드는 항상 존재하지만 비어 있을 수 있습니다.