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

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

  • 새로운 장소 사진 서비스를 사용하려면 사진의 리소스 이름을 전달합니다. 여기에는 요청 URL을 사용합니다. 자세한 내용은 사진 참조로 변경
  • 새로운 장소 사진 서비스는 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

새로운 버전의 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

기존의 Find Place, 즉 주변 검색, 텍스트 검색 및 Place Details는 모두 photos[] 배열을 반환합니다. 이 형식을 지원하는 응답을 반환합니다. 기존 photo 요소의 각 요소는 응답에는 다음 필드가 포함됩니다.

  • photo_reference - 사진 식별에 사용되는 문자열입니다. 수행할 수 있습니다.
  • height - 이미지의 최대 높이입니다.
  • width - 이미지의 최대 너비입니다.
  • html_attributions[] - 모든 필수 저작자 표시입니다. 이 필드는 항상 존재하지만 비어 있을 수도 있습니다.
를 통해 개인정보처리방침을 정의할 수 있습니다.