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

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

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