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/cloud-platform