이 페이지는 Cloud Translation API를 통해 번역되었습니다.

장소 사진으로 마이그레이션 (신규)

Places API는 기존 장소 사진을 지원합니다. 기존 장소 사진을 잘 알고 있다면 새 버전의 장소 사진에서 다음과 같은 변경사항이 적용됩니다.

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

다음 표에는 새 장소 사진에 맞게 이름이 변경되거나 수정된 기존 장소 사진의 매개변수 또는 더 이상 지원되지 않는 매개변수가 나와 있습니다.

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

기존 장소 사진은 최대 1600x1600픽셀의 사진 크기를 지원했습니다. 장소 사진 (신규)은 최대 4,800x4,800픽셀 크기를 지원합니다.

새 Place Photo 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 요소에는 다음 필드가 포함됩니다.