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

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

소개

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

  • 장소 사진 (신규)에서는 사진 참조만 전달하는 대신 요청 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[] - 필요한 저작자 표시 이 필드는 항상 표시되지만 비어 있을 수 있습니다.