Method: places.photos.getMedia

사진 참조 문자열이 있는 사진 미디어를 가져옵니다.

HTTP 요청

GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 사진 미디어의 리소스 이름입니다(places/{placeId}/photos/{photo_reference}/media 형식).

장소 객체의 photos.name 필드에 반환되는 사진의 리소스 이름은 places/{placeId}/photos/{photo_reference} 형식입니다. 사진 미디어 리소스 이름을 가져오려면 사진 리소스 끝에 /media을 추가해야 합니다.

쿼리 매개변수

파라미터
maxWidthPx

integer

선택사항입니다. 이미지의 원하는 최대 너비를 픽셀 단위로 지정합니다. 이미지가 지정된 값보다 작은 경우 원래 이미지가 반환됩니다. 이미지가 두 측정기준 중 하나에서 더 큰 경우 원래 가로세로 비율로 제한된 두 측정기준 중 더 작은 측정기준에 맞게 조정됩니다. maxHeightPx 및 maxWidthPx 속성은 모두 1~4800(포함) 사이의 정수를 허용합니다. 값이 허용된 범위 내에 있지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.

maxHeightPx 또는 maxWidthPx 중 하나 이상을 지정해야 합니다. maxHeightPx와 maxWidthPx가 모두 지정되지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.
maxHeightPx

integer

선택사항입니다. 이미지의 원하는 최대 높이를 픽셀 단위로 지정합니다. 이미지가 지정된 값보다 작은 경우 원래 이미지가 반환됩니다. 이미지가 두 측정기준 중 하나에서 더 큰 경우 원래 가로세로 비율로 제한된 두 측정기준 중 더 작은 측정기준에 맞게 조정됩니다. maxHeightPx 및 maxWidthPx 속성은 모두 1~4800(포함) 사이의 정수를 허용합니다. 값이 허용된 범위 내에 있지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.

maxHeightPx 또는 maxWidthPx 중 하나 이상을 지정해야 합니다. maxHeightPx와 maxWidthPx가 모두 지정되지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.
skipHttpRedirect

boolean

선택사항입니다. 설정된 경우 기본 HTTP 리디렉션 동작을 건너뛰고 텍스트 형식 (예: HTTP 사용 사례의 경우 JSON 형식) 응답을 렌더링합니다. 설정되지 않은 경우 호출을 이미지 미디어로 리디렉션하는 HTTP 리디렉션이 실행됩니다. HTTP가 아닌 요청의 경우 이 옵션은 무시됩니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

Places API의 사진 미디어입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "name": string,
  "photoUri": string
}
필드
name

string

사진 미디어의 리소스 이름입니다(places/{placeId}/photos/{photo_reference}/media 형식).
photoUri

string

사진을 렌더링하는 데 사용할 수 있는 단기 URI입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/maps-platform.places.getphotomedia
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform