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_VERSION 오류가 반환됩니다.

maxHeightPx나 maxWidthPx 중 하나 이상을 지정해야 합니다. maxHeightPx와 maxWidthPx도 지정되지 않은 경우 INVALID_CONVERSION 오류가 반환됩니다.
maxHeightPx

integer

선택사항입니다. 원하는 이미지의 최대 높이를 픽셀 단위로 지정합니다. 지정한 값보다 이미지가 작은 경우 원본 이미지가 반환됩니다. 이미지의 높이 또는 너비 중 하나가 더 큰 경우에는 원래의 가로세로 비율을 유지한 채로 작은 항목에 맞게 크기가 조정됩니다. maxHeightPx 및 maxWidthPx 속성 모두 1부터 4800(포함) 사이의 정수가 허용됩니다. 값이 허용된 범위를 벗어나면 INVALID_VERSION 오류가 반환됩니다.

maxHeightPx나 maxWidthPx 중 하나 이상을 지정해야 합니다. maxHeightPx와 maxWidthPx도 지정되지 않은 경우 INVALID_CONVERSION 오류가 반환됩니다.
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입니다.