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

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

Places API는 기존 장소 사진을 지원합니다. 기존의 장소 사진에 익숙하다면 새로운 버전의 장소 사진은 다음과 같이 변경합니다.

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

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

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

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

새로운 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

기존의 Find Place, Nearby Search, Text Search, Place Details 모두 이 형식을 지원하는 응답에서 photos[] 배열을 반환합니다. 기존 응답의 각 photo 요소에는 다음 필드가 포함됩니다.