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

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

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

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

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

커진 사진 크기

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

사진 참조로 변경

새 Place Photo API를 사용하려면 요청된 사진의 리소스 이름(장소 ID 및 사진 참조 포함)을 다음과 같은 형식으로 전달해야 합니다.

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

새로운 버전의 Nearby Search, 텍스트 검색, 장소 세부정보는 모두 이 형식을 지원하는 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[]: 모든 필수 저작자 표시입니다. 이 필드는 항상 존재하지만 비어 있을 수도 있습니다.